Struct Tryll::Client::TryllClient::SessionConfig¶
ClassList > Tryll > Client > TryllClient > SessionConfig
Public Attributes¶
| Type | Name |
|---|---|
| std::vector< EngineSelection > | engines |
| std::string | gameName |
| std::string | locale |
| std::vector< ModelPlacementHint > | placementHints Optional per-model placement hints. |
| std::string | storageDataFolder |
| std::chrono::milliseconds | timeout = std::chrono::seconds{30} |
Public Attributes Documentation¶
variable engines¶
Optional, advisory hint: the engines this session expects to touch, as (role, engine) pairs. Leaving it empty is legal and unremarkable — a model's engine comes from the server's catalog, so a load works whether or not this named the engine it needs.
What it buys is timing: the server initialises the named engines' backends at CreateSession instead of at first use, which is worth doing when that cost is large (an ORT CUDA cold start was measured in tens of seconds). A harness that wants determinism about which engines a run touched can also state it here; the editors derive it from their model manifest and expose no engine control.
Only an out-of-range ordinal is rejected (InvalidEngineSet, 2005). A duplicate pair is logged and ignored.
variable gameName¶
Integration identifier for telemetry grouping (e.g. "my-game"). Empty for anonymous sessions.
variable locale¶
Optional session language as a BCP-47 tag ("de", "de-DE", "pt-BR"). One setting the whole voice + text stack derives from: it becomes the default tts_lang for every GenerateAndSpeak/Speak node, the language hint for multilingual STT models, loc/< locale >/ siblings relative storage paths prefer, and the language Mustache key templates can write a "reply in X" directive against. Empty = unset (every one of those keeps its pre-locale behaviour). A malformed tag is rejected with InvalidLocale (2004).
variable placementHints¶
Optional per-model placement hints.
variable storageDataFolder¶
Optional per-session storage data folder. Relative storage paths in node params (and voice-input hotwords) resolve against this folder. Empty means not specified — the server falls back to its configured storage_root (which itself defaults to the executable folder).
variable timeout¶
The documentation for this class was generated from the following file C:/_tryll/_monorepo3/tryll/clients/cpp/include/tryll/TryllClient.h