Polyglot Data To Text
KismetTextLibraryЧто это
Pure‑функция для создания локализованного текста из набора строк с указанием пространства имён, ключа, оригинального текста и массива переводов. Позволяет вручную собрать FText, которое будет автоматически подбирать перевод под текущую культуру. Не требует exec‑пинов.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Namespace (String) — пространство имён для группировки переводов
- Key (String) — уникальный идентификатор текста внутри неймспейса
- Native String (String) — исходный текст на языке разработки
- Native Culture (String) — код культуры исходного текста (например,
"en-US") - Localized Strings (Array of Strings) — массив переводов
- Localized Cultures (Array of Strings) — массив кодов культур, соответствующих каждому переводу
Выходы (данные):
- Return Value (Text) — созданный локализованный текст
Когда используется
- Ручное формирование текста с поддержкой локализации без использования стандартных таблиц локализации (String Table / LocTable).
- Динамическая подстановка переводов, полученных из внешних источников (JSON, БД, сетевой ответ).
Типичные проблемы
- Несоответствие длин массивов – если число элементов в
Localized Stringsне равно числу элементов вLocalized Cultures, переводы для части культур будут проигнорированы, а лишние строки вызовут предупреждение. - Пустой Key или Namespace – при пустом
KeyилиNamespaceрезультат может стать нелокализуемым (обычно возвращаетсяNative Stringбез подстановок). - Неправильный код культуры – если в
Native CultureилиLocalized Culturesуказан несуществующий или неполный код (например,"eng"вместо"en"), движок не сможет сопоставить перевод.