Автоопределение языка

Пункт 2.14 Требований к игре

В игру встроено автоопределение языка через SDK.

Подключение

Важно

Автоопределение через SDK должно:

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

Чтобы определить язык пользователя, получите код языка из параметра environment.i18n.lang:

1const ysdk = (await YaGames.init());
2const lang = ysdk.environment.i18n.lang; // 'en', 'ru', ...

Дальше используйте переменную lang при загрузке переводов игры. Если язык пользователя не поддержан в игре, ориентируйтесь на резервный набор языков.

Методика проверки

Проверка одного языка

Чтобы убедиться, что язык игры определяется автоматически:

  1. Очистите кеш браузера.

  2. Откройте игру с debug-панелью:

    1. Откройте Консоль Яндекс Игр.
    2. Выберите нужную игру.
    3. В левом верхнем углу нажмите Открыть с debug-панелью.
    1. Откройте нужную игру.

    2. Добавьте параметр debug-mode=16 в конец адресной строки браузера.

      Пример ссылки: https://yandex.ru/games/app/XXXX?debug-mode=16, где XXXX — уникальный идентификатор игры.

  3. Проверьте, что при первом запуске игры автоопределение языка через SDK работает:

    Фон

    Текст

    Значение

    I18N is used

    Автоопределение подключено.

    I18N is not used

    Автоопределение не подключено.

    Важно

    Цвет индикатора 文 должен меняться на зеленый на старте, а не в процессе игры. Допустим небольшой интервал для подгрузки языка: на старте до смены цвета индикатора с красного на зеленый может отобразиться загрузочный текст на другом языке.

Примеры

Игра

Комментарий

Игрок нажимает «Играть», и только после этого индикатор языка меняется с зеленого на красный.

🚫 Автоопределение подключается после запуска уровня. Такая игра не пройдет модерацию.

Индикатор меняет цвет с красного на зеленый во время загрузки. Игра только на русском, надпись «Загрузка» первоначально на нужном языке.

✅ Есть небольшая задержка перед подключением автоопределения, язык изначально правильный (игра только на RU).

Индикатор меняет цвет с красного на зеленый во время загрузки. Вместе с этим меняется надпись «Загружаемся» на «Loading», что соответствует выбранному языку игры — английскому.

✅ Есть небольшая задержка перед подключением автоопределения, вместе со сменой цвета индикатора меняется язык текста (язык EN).

Проверка нескольких языков

Модерация проверяет локализацию игры на все языки, указанные на вкладке Черновик в поле Игра переведена на.

Повторите для каждого заявленного языка базовую проверку. Для этого последовательно откройте игру на всех этих языках:

  1. На debug-панели нажмите SDK mocks ⚒️.
  2. В выпадающем списке с обозначением языка (например, En ) выберите нужный. Игра откроется на этом языке в новой вкладке браузера.

Примечание

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

Пример ручного выбора языка

Меню ручного выбора языка внутри игры.

Вердикты модерации:

  • ✅ Если все заявленные языки подтянулись — игра пройдет модерацию.
  • 🚫 Если хотя бы один язык не переключился (полностью или частично) на выбранный на debug-панели — игра будет отклонена за неперевод. При этом модерация учитывает исключения, которые можно не переводить (см. калибровочный список к пункту 8.2.3).
  • ✅ Допустимо, если после обновления страницы с игрой автоопределение отсутствует в случаях, когда разработчик реализовал сохранение языка в кеше.

Связаться с модерацией

Если вы считаете, что автоопределение языка корректно работает в игре и она была снята с публикации или не допущена до нее по ошибке — заполните форму ниже.

Служба контроля качества модерации перепроверит решение и вернет игру, если она была заблокирована несправедливо.

Открыть форму

Код указан в формате ISO 639-1. Например, "tr" означает, что игра сейчас запущена в турецком интерфейсе Яндекс Игр. Все поддерживаемые языки приведены на странице Языки и домены.