电视适配

要求项 1.6.3

对于电视:

  1. 游戏占据整个屏幕区域,支持全屏模式。
  2. 支持使用电视遥控器上的方向键控制。仅使用遥控器的方向键就足以完整体验游戏。
  3. 支持电视遥控器上的BackOK按钮。
  4. 没有应用内购买。
  5. 没有指向开发者其他游戏的链接。

处理方向键和OK按钮事件

遥控器按钮应在游戏内和以下部分正常工作:

  • 游戏前的开始菜单(如果有)。例如,应支持通过按遥控器上的OK按钮启动游戏,或使用方向键选择关卡。
  • 通过Back按钮调出的游戏内菜单。

遥控器一次只能触发一个事件。如果游戏需要同时使用多个按键,请将某些动作设为自动,例如跳跃或向前移动。

遥控器按钮对应以下事件:

  • 方向键:ArrowLeftArrowUpArrowRightArrowDown
  • OKEnter

详细说明请参见KeyboardEvent文档

对于支持手柄的游戏引擎,电视遥控器会被注册为手柄。请根据手柄文档配置方向键和OK按钮事件处理:UnityConstructDefold

处理Back按钮事件

所有支持Smart TV的电视遥控器上都有Back按钮。

游戏中Back按钮的主要事件:

  • 在游戏开始菜单中 — 调出确认退出游戏的窗口。
  • 在游戏过程中:
    • 单次按下 — 暂停游戏并调出游戏菜单。
    • 连按两次 — 调出确认退出游戏的窗口。

事件的详细说明请参见事件

与Yandex Games SDK交互

初始化Yandex Games SDK后,deviceInfo对象将在type字段中返回用户的设备类型。

在电视上启动游戏时,type字段将返回值为tv的字符串。之后,您可以向游戏传递相应的遥控器控制逻辑。您还可以传递游戏过程中需要的文本、教程和其他材料。

关于deviceInfo对象及其方法的详细信息,请参见其他对象和SDK参数

添加游戏

实现对电视遥控器按钮的支持后,您可以将游戏添加到Yandex Games目录中。在Yandex Games 控制台填写游戏草稿时,在支持的平台中选择TV

成功通过审核后,游戏将在专门的电视套餐中提供,并对电视用户可用。

测试游戏

您可以在支持Yandex TV商店的电视上打开游戏草稿进行测试:

  1. 登录Yandex Games应用并等待开始页面加载。

  2. 在遥控器上输入按键序列← ↑ ← ↑ ← ↑ ← ↑。将打开输入屏幕。

    备注

    如果选中了开始页面界面的左上角元素,此序列才会生效。

  3. 在字段中输入游戏ID。

下一篇