电视适配
游戏必须满足以下要求才能在 TV 平台上正常运行:
- 游戏使用屏幕的整个区域。游戏中可以使用全屏模式。
- 游戏支持使用 TV 遥控器上的箭头键控制游戏并浏览交互性的游戏元素。
- 游戏支持使用 TV 遥控器上的返回和确定按钮。
- 应用内没有游戏内购买。
- 游戏中没有链接到开发者的其他应用程序。
备注
随着时间推移,要求列表中的内容可能会不断增加。要阅读完整的当前条件,请参阅游戏要求。
处理按下箭头和确定按钮的事件
遥控器按钮必须能够在游戏和以下部分中使用:
- 在游戏开始前出现的开始菜单(如适用)。例如,必须支持通过按下遥控器上的确定按钮启动游戏,或者使用箭头按钮选择关卡。
- 使用返回按钮打开的游戏内菜单。
遥控器每次发送一个事件。如果您的游戏一次使用多个按钮,则可以自动化处理某些动作,例如跳跃和前进。
关于遥控器按钮按下事件的描述,请参见KeyboardEvent 文档。遥控器按钮与某些事件值相对应:
- 箭头:
ArrowLeft
、ArrowUp
、ArrowRight
、ArrowDown
。 - 确定:
Enter
。
如果要使用兼容手柄的游戏引擎(Unity、Construct 或 Defold,则需要将电视遥控器注册为手柄,用于这些引擎。对于这些游戏,必须根据手柄文档来处理箭头和确定按钮事件。
处理按下返回按钮的事件
所有智能 TV 遥控器上都有一个返回按钮。
以下是游戏情境下与返回按钮相关的主要事件:
- 在游戏开始菜单上按下该按钮会打开一个窗口,要求用户确认退出游戏。
- 在游戏启动后按下该按钮会暂停游戏并打开游戏菜单。
- 在游戏期间按两次该按钮会打开一个窗口,要求用户确认退出游戏。
关于事件的详细描述,请参见事件。
与 Yandex Games SDK 交互
在 Yandex Games SDK 初始化后,deviceInfo
对象会在 type
字段中返回用户的设备类型。
在 TV 上启动游戏时,type
字段中会返回一个带有值 tv
的字符串。此后,使用遥控器控制游戏的相应逻辑可以传递给游戏。您也可以传递文字、培训材料,以及游戏所要求的其他内容。
如需了解关于 deviceInfo
对象及其方法的详细信息,请参见其他对象和SDK参数。
添加游戏
在实现对 TV 遥控器按钮的支持后,您可以将游戏添加到 Yandex Games 目录中。在 Yandex Games 仪表板中填写游戏草稿时,从支持的平台列表中选择 TV
。
如果游戏通过审核,则会包含在专门的电视套餐中,且可供电视用户使用。
测试游戏
您可以通过在支持 Yandex TV 商店的 TV 上打开游戏草稿来测试游戏:
-
打开 Yandex Games 应用并等待加载开始页面。
-
按下遥控器上的以下按键:← ↑ ← ↑ ← ↑ ← ↑。输入屏幕随即打开。
备注
如果开始页面界面左上角的图块被选中,则说明此按键顺序生效。
-
输入游戏 ID。