Поддержка ТВ

Чтобы игра корректно работала на ТВ-платформе, она должна соответствовать требованиям:

  • Игра занимает всю площадь экрана, в игре доступен полноэкранный режим.
  • Игра поддерживает управление и навигацию по интерактивным элементам с помощью стрелок на ТВ-пульте.
  • Игра поддерживает нажатие кнопок Back и OK на ТВ-пульте.

Управление пультом

Для взаимодействие с кнопками пульта в плагине есть:

  • Условие Нажата кнопка ТВ-пульта: истинно, если в данную минуту выбранная кнопка зажата.
  • Триггер При нажатии кнопки ТВ-пульта: срабатывает, когда игрок нажимает на заданную кнопку.
  • Триггер При отпускании кнопки ТВ-пульта: срабатывает, когда игрок отпускает заданную кнопку.

Каждому из этих визуальных блоков можно задать кнопку из списка: Вверх, Вниз, Влево, Вправо и OK.

Благодаря им вы можете реализовать поддержку управления на ТВ не переживая об особенностях платформы.

Скриншот Construct 3: экран настройки игры для ТВ-платформы при помощи плагина YandexGamesSDK. Сверху строка с 3 ячейками, в первых двух есть текст: иконка шестеренки «Система», «Каждый тик», последняя ячейка пустая. Ниже таблица с 5 строками и 3 столбцами. 1 строка — иконка Яндекс Игр | «Yandex...», «Нажата кнопка Вверх на ТВ пульте», иконка морды медведя «Bear | Установить Y в bear.Y - 1». 2 строка — иконка Яндекс Игр | «Yandex...», «Нажата кнопка Вниз на ТВ пульте», иконка морды медведя «Bear | Установить Y в bear.Y + 1». 3 строка — иконка Яндекс Игр | «Yandex...», «Нажата кнопка Вправо на ТВ пульте», иконка морды медведя «Bear | Установить Y в bear.Y + 1». 4 строка — иконка Яндекс Игр | «Yandex...», «Нажата кнопка Влево на ТВ пульте», иконка морды медведя «Bear | Установить Y в bear.Y - 1». 5 строка — иконка Яндекс Игр | «Yandex...», «Нажата кнопка OK на ТВ пульте», иконка морды медведя «Bear | Установить угол bear.Угол + 1 градусов».

События HISTORY_BACK и EXIT

Событие HISTORY_BACK может быть вызвано различными способами: нажатием кнопки Back на ТВ-пульте, голосовой командой или жестом.

Основные события кнопки Back в контексте игр:

  • Нажатие в стартовом меню игры — вызов окна с подтверждением выхода из игры.
  • Нажатие во время игрового процесса — пауза в игре и вызов игрового меню.
  • Двойное нажатие во время игрового процесса — вызов окна с подтверждением выхода из игры.

Для обработки события HISTORY_BACK в плагине существует условие При событии HISTORY_BACK.

Выход из игры можно вызвать, используя Отправить событие с параметром EXIT.

Скриншот Construct 3: экран настройки игры для ТВ-платформы при помощи плагина YandexGamesSDK. Сверху строка с 2 ячейками, в первой есть иконка Яндекс Игр | «При событии HISTORY_BACK». Ниже текст «// Показываем меню выхода», далее строка с 2 ячейками: иконка настроек | «МенюВыходаОткрыто правда», иконка настроек | «Установить МенюВыходаОткрыто на False». Ниже текст «// Скрываем меню выхода», далее строка с 2 ячейками: иконка настроек | «Иначе», иконка настроек | «Установить МенюВыходаОткрыто на True». Ниже текст «// Если меню открыто и игрок нажимает OK - выходим из игры», далее строка с 2 ячейками: иконки Яндекс игр и настроек | «Нажата кнопка OK на ТВ пульте  МенюВыходаОткрыто правда», иконка Яндекс Игр | «Отправить событие Exit».

Эмулятор пульта ТВ

Для облегчения тестирования игры в плагин встроен эмулятор пульта ТВ, который можно включить нажатием кнопки F6.

Примечание

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

Видео тестирования пульта ТВ: открыто всплывающее окно «TV Example - Google Chrome», на сером фоне иконка морды медведя, в правой части экрана — виртуальный ТВ пульт. Пользователь последовательно нажимает кнопки ←, →, ↓, ↑ и «OK», иконка медведя соответственно двигается влево, вправо, вниз, вверх, а затем крутится по часовой стрелке.


Примечание

Если при работе с плагином вы столкнулись с проблемой или у вас появился вопрос, обратитесь в сообщество в Телеграме.

Репозиторий