Class UTryllLanguages¶

#include <TryllLanguages.h>

Inherits the following classes: UBlueprintFunctionLibrary

Public Static Functions¶

Type	Name
bool	HasLanguageInfo (const TArray< FTryllModelInfo > & Models)
FString	LanguageDisplayName (const FString & Code)
FString	LanguageOf (const FString & Locale)
bool	ModelSupportsLanguage (const FTryllModelInfo & Model, const FString & Locale)
TArray< FString >	OfferableLanguages (const TArray< FTryllModelInfo > & Models)
TArray< FString >	OfferableLanguagesForModels (const TArray< FTryllModelInfo > & AllModels, const TArray< FString > & ModelNames)

Detailed Description¶

Works out which languages your game can actually offer, from the models it actually uses.

The rule is an intersection: a language is offerable only if every model in the pipeline covers it. A game with a 31-language voice but an English-only recognizer can offer exactly one language for hands-free play - and the point of this library is that you find that out from the catalog instead of from a bug report.

Blueprint-callable, so a settings menu can populate itself without C++.

Public Static Functions Documentation¶

function HasLanguageInfo¶

static bool UTryllLanguages::HasLanguageInfo (
    const TArray< FTryllModelInfo > & Models
)

True when at least one model declared its languages. Distinguishes "these models share no language" from "we have no idea", which are very different things to show a player.

function LanguageDisplayName¶

static FString UTryllLanguages::LanguageDisplayName (
    const FString & Code
)

English name for a language code - "de" -> "German" - for labelling a menu. Unknown codes come back unchanged, so an entry is never blank.

Deliberately a fixed table rather than FInternationalization: it must match what the server renders into the {{language}} prompt key exactly (see SessionLocale.cpp). Keep the two lists in sync when adding a language.

function LanguageOf¶

static FString UTryllLanguages::LanguageOf (
    const FString & Locale
)

Primary language subtag of a locale, lowercase: "pt-BR" -> "pt". This is the granularity models work at - none of the shipped voice or speech models distinguish pt-BR from pt-PT.

function ModelSupportsLanguage¶

static bool UTryllLanguages::ModelSupportsLanguage (
    const FTryllModelInfo & Model,
    const FString & Locale
)

Whether Model covers Locale (a tag like "de-DE" or a bare code like "de").

Returns true for a model that declares nothing: without a catalog claim we have no evidence either way, and the server applies the same rule - it withholds the language hint rather than refusing to load the model.

function OfferableLanguages¶

static TArray< FString > UTryllLanguages::OfferableLanguages (
    const TArray< FTryllModelInfo > & Models
)

Languages every model in Models declares, sorted.

A model that declares nothing is skipped, not treated as restrictive - an empty list means "the catalog didn't say", and letting unknown shrink the result would hide languages that work.

An empty return therefore means one of two things: the declared sets genuinely do not overlap, or nothing declared anything. Call HasLanguageInfo to tell those apart before telling a player there are no languages available.

function OfferableLanguagesForModels¶

static TArray< FString > UTryllLanguages::OfferableLanguagesForModels (
    const TArray< FTryllModelInfo > & AllModels,
    const TArray< FString > & ModelNames
)

Same, but picks the models out of a ListModels result by name - the usual shape, since you know your TTS/STT/language model names. Names that are not present are ignored, so a model the player has not downloaded yet does not silently empty the menu.

The documentation for this class was generated from the following file C:/_tryll/_monorepo3/tryll/clients/unreal/Source/TryllClient/Public/TryllLanguages.h