Интеграция

Языки

Язык интерфейса игры выбирается при каждом запуске полем lang метода /playGame.do.

Коды#

lang — стандартный код BCP 47: en, de, pt-BR, zh-Hans, zh-Hant, es-419, … Перед использованием платформа его нормализует:

регистр не важен (PT-br → pt-BR), вместо - допустим _ (pt_BR);
несколько распространённых вариантов приводятся к коду, который используют игры:

Вы отправляете	Используется
`zh`, `zh-CN`, `zh-SG`	`zh-Hans`
`zh-TW`, `zh-HK`	`zh-Hant`
`nb`, `nn`	`no`
`pt-PT`	`pt`
`en-US`, `en-GB`	`en`
`sr-Latn-RS`	`sr-Latn`
`uz-Latn-UZ`	`uz-Latn`

Код — это язык из 2–3 букв и необязательные подтеги через - или _ (буквы и цифры), всего не более 16 символов.

Какие языки поддерживает игра#

Каждая игра принимает ровно те языки, которые предлагает её клиент. Список — массив languages игры в GET /games/health и столбец Языки в списке игр. По всему каталогу 43 языков:

Код	Язык	Игр
`ar`	арабский	7
`bg`	болгарский	308
`cs`	чешский	305
`da`	датский	430
`de`	немецкий	445
`el`	греческий	308
`en`	английский	446
`es`	испанский	445
`et`	эстонский	308
`fi`	финский	445
`fr`	французский	445
`hi`	хинди	80
`hr`	хорватский	308
`hu`	венгерский	308
`hy`	армянский	235
`id`	индонезийский	445
`is`	исландский	73
`it`	итальянский	445
`ja`	японский	445
`ka`	грузинский	308
`ko`	корейский	445
`lt`	литовский	308
`lv`	латышский	308
`mk`	македонский	72
`ms`	малайский	73
`nl`	нидерландский	308
`no`	норвежский	445
`pl`	польский	308
`pt`	португальский	308
`pt-BR`	бразильский португальский	308
`ro`	румынский	445
`ru`	русский	446
`sk`	словацкий	245
`sr`	сербский	73
`sr-Latn`	сербский (латиница)	7
`sv`	шведский	445
`th`	тайский	445
`tr`	турецкий	445
`uk`	украинский	320
`uz-Latn`	узбекский (латиница)	7
`vi`	вьетнамский	445
`zh-Hans`	китайский, упрощенное письмо	217
`zh-Hant`	китайский, традиционное письмо	445

Язык по умолчанию и ошибки#

Если lang не указан, используется язык проекта по умолчанию (админ-панель → Projects → Technical; панель предлагает русский, английский и украинский).
Если код некорректен или игра его не предлагает, запуск возвращает HTTP 400 UNSUPPORTED_LANGUAGE. Выберите другой язык или не передавайте lang.

Смена языка#

Запустите игру ещё раз с другим lang. Если у игрока есть незавершённый раунд, та же сессия продолжается на новом языке; иначе создаётся новая сессия. Сессия хранит стандартный код, а игра получает код, который ожидает её клиент.

Язык сессии возвращается в meta.language ответа запуска.