Publishing a game for the TV platform

For your game to function correctly on the TV platform, it has to meet the following requirements:

• The game takes up the entire screen area and supports the full-screen mode.
• The game supports controls and navigation between interactive elements using arrows on the TV remote.
• The game supports the Back and OK buttons on the TV remote.

Processing arrow and OK button events

Remote buttons must be fully functional within the game and in the following sections:

• Pre-game main menu (if there is one). For example, the user must be able to press OK on the remote to start the game or choose a level using arrows.
• In-game menu opened via the Back button.

The remote sends one event at a time. If your game has a mechanic that requires multiple keys to be pressed at the same time, some actions, such as jumps or forward movement, can be made automatic.

For a description of the remote button press events, see the KeyboardEvent documentation. The remote control buttons are assigned specific event values:

• Arrows: ArrowLeft, ArrowUp, ArrowRight, ArrowDown.
• OK: Enter.

If you use a game engine that support gamepads (Unity, Construct, Defold), then it will recognize the TV remote as a gamepad. In this case, follow the applicable gamepad documentation to configure the processing of arrow and OK button events.

Processing Back button events

All remote controls for televisions that support Smart TV feature a Back button.

Here are the key events related to the Back button in the context of gaming:

• Pressing the button in the main menu triggers a confirmation window to exit the game.
• Pressing the button during gameplay pauses the game and opens the game menu.
• Pressing the button twice during gameplay triggers a confirmation window to exit the game.

For a detailed description of events, see Events.

Interacting with the Yandex Games SDK

After the Yandex Games SDK is initialized, the deviceInfo object returns the user's device type in the type field.

When launching a game on a TV, a string with the tv value is returned to the type field. After that, the game is ready to process inputs from the remote. It is also possible to transmit texts, tutorials, and other materials necessary for gameplay.

For more information about the deviceInfo object and its methods, see Other SDK objects and parameters.

Adding a game

Once you've implemented support for TV remote buttons, you can add your game to the Yandex Games catalog. When filling out your game draft in the Yandex Games Console, choose TV from the list of supported platforms.

If the game passes moderation, it is included in a special TV bundle and becomes available to TV users.

Testing the game

You can test the game by opening its draft on a TV that supports the Yandex TV store:

1. Open the Yandex Games app and wait for the start page to load.

2. Press the following keys on the remote control: ← ↑ ← ↑ ← ↑ ← ↑. The entry screen opens.

   Note

   The sequence will work if you've selected the top left tile in the start page interface.

3. Enter the game ID.