Skip to content

utils.L

vasili.kostin edited this page Aug 27, 2021 · 11 revisions

Функции локализации

Thing-Engine поддерживает мультиязычность для разрабатываемых в нем игр.

Для мультиязычности, в первую очередь, необходимо добавить текстовые ресурсы в редакторе текстовых ресурсов. После чего мультиязычный текст можно использовать при редактировании сцен (поле translatableText компонента Text), либо из javascript.

Перед использованием модуля L (localization) в коде javascript необходимо импортировать его следующим образом:

import L from "thing-editor/js/engine/utils/l.js";

В редакторе колбеков данный модуль доступен по пути 'game.L'


Статические методы:

L(key : String, value1 : String, value2 : String)

Возвращаемый тип: String

Возвращает локализованный текст для ключа key. Если указан параметр value1, его значение будет вставлено в место текстовой комбинации %d (data), если таковая имеется в локализованном тексте. Параметр value2 замещает $s (second data).


L.setCurrentLanguage(languageId : String)

Устанавливает текущий язык для игры. При этом текст во всех существующих текстовых полях, у которых задано поле translatableText, будет обновлен.

При старте игры, язык выбирается автоматически, в соответствии с системным языком браузера игрока. Если в игре отсутствует локализация для языка браузера, то будет выбран Английский (en) язык, как язык по умолчанию.


L.has(key : String)

Возвращаемый тип: Boolean

Проверяет существование заданного ключа в таблице переводов.


L.getCurrentLanguageId()

Возвращаемый тип: String

Возвращает код текущего языка.


L.getLanguagesList()

Возвращаемый тип: Array<String>

Возвращает список добавленных в проект языков. Подробнее: Редактор текстовых ресурсов

<- Предыдущая страница Следующая страница ->

Связанные темы:

Общая информация для Javascript разработчика

Clone this wiki locally