Адаптация для ТВ
Пункт требований 1.6.3
Для телевизоров:
- Игра занимает всю площадь экрана, доступен полноэкранный режим.
- Поддерживается управление с помощью стрелок на ТВ-пульте. Для полноценного прохождения игры достаточно управления стрелками пульта.
- Имеется поддержка нажатия кнопок Back и ОК на ТВ-пульте.
- Отсутствуют инап-покупки.
- Нет ссылок на другие игры разработчика.
Обработка событий стрелок и кнопки OK
Кнопки пульта должны работать внутри игры и в следующих разделах:
- Стартовое меню перед игрой, если оно есть. Например, должен поддерживаться запуск игры по нажатию ОК на пульте или возможность выбора уровня с помощью стрелок.
- Внутриигровое меню, вызываемое с помощью кнопки Back.
Пульт инициирует одно событие в один момент времени. Если в игре используется несколько клавиш за раз, сделайте некоторые действия автоматическими, например прыжки или движение вперед.
Кнопкам пульта соответствуют события:
- Стрелки:
ArrowLeft,ArrowUp,ArrowRight,ArrowDown. - OK:
Enter.
Их описание см. в документации KeyboardEvent.
Для игровых движков, которые умеют работать с геймпадом, ТВ-пульт регистрируется как геймпад. Для них настройте обработку событий стрелок и кнопки ОК согласно документации для геймпада: Unity, Construct, Defold.
Обработка событий кнопки Back
Кнопка Back есть на пультах для всех телевизоров с поддержкой Smart TV.
Основные события кнопки Back в контексте игр:
- В стартовом меню игры — вызов окна с подтверждением выхода из игры.
- Во время игры:
- Однократно — пауза в игре и вызов игрового меню.
- Дважды — вызов окна с подтверждением выхода из игры.
Подробное описание событий см. в разделе События.
Взаимодействие с SDK Яндекс Игр
После инициализации SDK Яндекс Игр объект deviceInfo будет возвращать тип устройства пользователя в поле type.
При запуске игры на телевизоре в type будет возвращена строка со значением tv. После этого в игру можно передавать соответствующую логику управления с пульта. Также можно передать тексты, обучения и другие материалы, которые потребуются для игрового процесса.
Подробно об объекте deviceInfo и его методах см. в разделе Другие объекты и параметры SDK.
Добавление игры
После реализации поддержки кнопок ТВ-пульта вы можете добавить игру в каталог Яндекс Игр. При заполнении черновика игры в Консоли Яндекс Игр выберите среди поддерживаемых платформ ТВ.
При успешном прохождении модерации игра будет отдаваться в специальном бандле ТВ и будет доступна пользователям телевизоров.
Тестирование игры
Вы можете протестировать игру, открыв ее черновик на телевизоре с поддержкой магазина Яндекс ТВ:
-
Войдите в приложение Яндекс Игр и дождитесь открытия стартовой страницы.
-
Наберите на пульте последовательность кнопок ← ↑ ← ↑ ← ↑ ← ↑. Откроется экран ввода.
Примечание
Последовательность сработает, если выбран левый верхний элемент интерфейса стартовой страницы.
-
В поле введите ID игры.