---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.ru/dev/games/doc/en/sdk/construct-3/tv-support.md
  - https://yandex.ru/dev/games/doc/hi/sdk/construct-3/tv-support.md
  - https://yandex.ru/dev/games/doc/ko/sdk/construct-3/tv-support.md
  - https://yandex.ru/dev/games/doc/ru/sdk/construct-3/tv-support.md
  - https://yandex.ru/dev/games/doc/tr/sdk/construct-3/tv-support.md
  - https://yandex.ru/dev/games/doc/vi/sdk/construct-3/tv-support.md
  - https://yandex.ru/dev/games/doc/zh/sdk/construct-3/tv-support.md
  - href: https://yandex.ru/dev/games/doc/ru/sdk/construct-3/tv-support.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/games/doc/ru/llms.txt?revision=r21993288
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/games/doc/ru/llms.txt?revision=r21993288

# Поддержка ТВ

<!-- source: ru/_includes/script-common.md -->
<!-- source: ru/_includes/script/index-js.md -->

<!-- endsource: ru/_includes/script/index-js.md -->

<!-- source: ru/_includes/script/requirements-js.md -->

<!-- endsource: ru/_includes/script/requirements-js.md -->

<!-- source: ru/_includes/script/image-modal-js.md -->

<!-- endsource: ru/_includes/script/image-modal-js.md -->
<!-- endsource: ru/_includes/script-common.md -->

Чтобы игра корректно работала на ТВ-платформе, она должна соответствовать [требованиям](https://yandex.ru/dev/games/doc/ru/requirements/1/6/3.md) ([пункт 1.6.3](https://yandex.ru/dev/games/doc/ru/concepts/requirements.md#1-6-3)).

## Управление пультом {#remote-control}

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

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

Каждому из этих визуальных блоков можно задать кнопку из списка: **Вверх**, **Вниз**, **Влево**, **Вправо** и **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 градусов».](../../_images/construct-3/tv-support/tv.webp)

## События `HISTORY_BACK` и `EXIT` {#events}

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

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

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

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

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

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

## Эмулятор ТВ-пульта {#tv-remote-emulator}

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

{% note info %}

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

{% endnote %}

![Видео тестирования пульта ТВ: открыто всплывающее окно «TV Example - Google Chrome», на сером фоне иконка морды медведя, в правой части экрана — виртуальный ТВ пульт. Пользователь последовательно нажимает кнопки ←, →, ↓, ↑ и «OK», иконка медведя соответственно двигается влево, вправо, вниз, вверх, а затем крутится по часовой стрелке.](../../_images/construct-3/tv-support/tv-emulator.gif)

---


<!-- source: ru/_includes/sdk/plugin-tg-support.md -->
{% note info %}

Если при работе с плагином вы столкнулись с проблемой или у вас появился вопрос, обратитесь в [сообщество в Телеграме](https://t.me/yagamedev/1056558){.telegram} или в [сообщество ВКонтакте](https://vk.ru/yandexgmsdev){.vk}.

{% endnote %}
<!-- endsource: ru/_includes/sdk/plugin-tg-support.md -->


<!-- source: ru/_includes/sdk/button-git.md -->
<a href="https://github.com/yandex-games-plugins/construct3">
  <span class="button">Репозиторий</span>
</a>
<!-- endsource: ru/_includes/sdk/button-git.md -->