电视适配
要求项 1.6.3
对于电视:
- 游戏占据整个屏幕区域,支持全屏模式。
- 支持使用电视遥控器上的方向键控制。仅使用遥控器的方向键就足以完整体验游戏。
- 支持电视遥控器上的Back和OK按钮。
- 没有应用内购买。
- 没有指向开发者其他游戏的链接。
处理方向键和OK按钮事件
遥控器按钮应在游戏内和以下部分正常工作:
- 游戏前的开始菜单(如果有)。例如,应支持通过按遥控器上的OK按钮启动游戏,或使用方向键选择关卡。
- 通过Back按钮调出的游戏内菜单。
遥控器一次只能触发一个事件。如果游戏需要同时使用多个按键,请将某些动作设为自动,例如跳跃或向前移动。
遥控器按钮对应以下事件:
- 方向键:
ArrowLeft
、ArrowUp
、ArrowRight
、ArrowDown
。 - OK:
Enter
。
详细说明请参见KeyboardEvent文档。
对于支持手柄的游戏引擎,电视遥控器会被注册为手柄。请根据手柄文档配置方向键和OK按钮事件处理:Unity、Construct、Defold。
处理Back按钮事件
所有支持Smart TV的电视遥控器上都有Back按钮。
游戏中Back按钮的主要事件:
- 在游戏开始菜单中 — 调出确认退出游戏的窗口。
- 在游戏过程中:
- 单次按下 — 暂停游戏并调出游戏菜单。
- 连按两次 — 调出确认退出游戏的窗口。
事件的详细说明请参见事件。
与Yandex Games SDK交互
在初始化Yandex Games SDK后,deviceInfo
对象将在type
字段中返回用户的设备类型。
在电视上启动游戏时,type
字段将返回值为tv
的字符串。之后,您可以向游戏传递相应的遥控器控制逻辑。您还可以传递游戏过程中需要的文本、教程和其他材料。
关于deviceInfo
对象及其方法的详细信息,请参见其他对象和SDK参数。
添加游戏
实现对电视遥控器按钮的支持后,您可以将游戏添加到Yandex Games目录中。在Yandex Games 控制台填写游戏草稿时,在支持的平台中选择TV。
成功通过审核后,游戏将在专门的电视套餐中提供,并对电视用户可用。
测试游戏
您可以在支持Yandex TV商店的电视上打开游戏草稿进行测试:
-
登录Yandex Games应用并等待开始页面加载。
-
在遥控器上输入按键序列← ↑ ← ↑ ← ↑ ← ↑。将打开输入屏幕。
备注
如果选中了开始页面界面的左上角元素,此序列才会生效。
-
在字段中输入游戏ID。
已复制