TV adaptation
Requirement item 1.6.3
For TVs:
- The game takes up the entire screen area and supports full-screen mode.
- The game supports controls using arrows on the TV remote. Arrow controls on the remote are sufficient for complete gameplay.
- The game supports the Back and OK buttons on the TV remote.
- There are no in-app purchases.
- There are no links to other games by the developer.
Processing arrow and OK button events
Remote buttons must work within the game and in the following sections:
- Start menu before the game, if there is one. For example, the game should support launching by pressing OK on the remote or the ability to select a level using arrows.
- In-game menu accessed via the Back button.
The remote initiates one event at a time. If your game uses multiple keys simultaneously, make some actions automatic, such as jumps or forward movement.
Remote buttons correspond to these events:
- Arrows:
ArrowLeft,ArrowUp,ArrowRight,ArrowDown. - OK:
Enter.
See their description in the KeyboardEvent documentation.
For game engines that can work with gamepads, the TV remote is registered as a gamepad. For these, configure arrow and OK button event handling according to the gamepad documentation: Unity, Construct, Defold.
Processing Back button events
The Back button is present on remotes for all televisions with Smart TV support.
The main Back button events in the context of games:
- In the game's start menu — displays a confirmation window for exiting the game.
- During gameplay:
- Single press — pauses the game and brings up the game menu.
- Double press — displays a confirmation window for exiting the game.
For a detailed description of events, see Events.
Interaction with Yandex Games SDK
After initializing the Yandex Games SDK, the deviceInfo object will return the user's device type in the type field.
When launching a game on a TV, the type field will return a string with the value tv. After this, you can implement the appropriate remote control logic in the game. You can also provide texts, tutorials, and other materials needed for gameplay.
For more details about the deviceInfo object and its methods, see Other SDK objects and parameters.
Adding a game
After implementing support for TV remote buttons, you can add the game to the Yandex Games catalog. When filling out the game draft in the Yandex Games Console, select TV among the supported platforms.
Upon successful moderation, the game will be included in a special TV bundle and will be 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:
-
Open the Yandex Games app and wait for the start page to load.
-
Enter the following button sequence on the remote: ← ↑ ← ↑ ← ↑ ← ↑. An input screen will open.
Note
The sequence will work if the top-left interface element on the start page is selected.
-
Enter the game ID in the field.