Локализация

Редактор локализаций

Переводы хранятся в формате JSON внутри проекта, и мы рекомендуем использовать его для их редактирования.

После установки плагина в разделе SDK Яндекс Игр нажмите на опцию Редактор локализации.

Чтобы создать локализацию, в верхнем левом углу нажмите кнопку Создать.

Перед вами появится модальное окно, где можно выбрать язык. Закончив, нажмите Создать JSON файл.

Например, выберите English (en) и введите следующее в редактор:

1{
2    "title": "best game in the world 2"
3}

Нажмите кнопку Сохранить, чтобы сохранить локализацию и протестировать ее в игре.

Применение вашей локализации

Локализацию можно применить двумя способами: с помощью метода l10n.t() или через умный компонент локализации.

Метод l10n.t

Сначала используйте метод l10n.t(). Создайте новый компонент и вставьте в него следующее:

 1import { _decorator, Component, Label } from 'cc';
 2import { l10n } from 'db://yandex-games-sdk/ysdk';
 3const { ccclass, requireComponent } = _decorator;
 4
 5@ccclass('ButtonLocalizationTest') // Название компонента.
 6@requireComponent(Label) // Зависимость от компонента Label.
 7export class ButtonLocalizationTest extends Component {
 8    onLoad() {
 9        const label = this.getComponent(Label); // Получаем компонент Label.
10        label.string = l10n.t('title'); // Устанавливаем текст Label на основе ключа, заданного ранее.
11    }
12}

После того как вы создадите узел с компонентом Label на сцене, вы можете локализовать его, перетащив компонент в узел.

Готовый компонент L10nLabel

В плагине есть готовый компонент, который отображает ключ прямо в редакторе. Компилировать проект для просмотра изменений не требуется, так как он автоматически обновляется при внесении изменений в редакторе переводов.

Нажмите на кнопку Добавить компонент для интересующего вас узла, прокрутите до группы YandexGamesSDK и выберите L10nLabel.

Чтобы изменения локализации сразу отображались в проекте без необходимости заново компилировать его, введите свой ключ в поле Ключ.