开发者控制台

网页应用中的支持控制器

网页应用中的支持控制器 (Fire TV)

亚马逊Fire TV支持使用亚马逊Fire TV遥控器、Amazon Fire游戏控制器和其他支持蓝牙HID游戏手柄配置文件的游戏控制器的用户输入。这些控制器为用户提供了在应用中进行导航和选择项目的方法。

使用亚马逊Fire TV遥控器的输入

大多数亚马逊Fire TV遥控器都有这些按钮。某些Fire TV遥控器不包含麦克风或语音搜索按钮。

遥控器
遥控器

一些遥控器具有一些额外的按钮,例如调高/调低音量、电源、Netflix、Amazon Prime和其他应用。但是,无法将这些按钮映射到第三方应用中的事件。

要使用户能够使用遥控器与网页应用进行交互,您需要在用户按下其中一个键时捕获按键事件。大多数按键动作可以像浏览器中的标准键盘事件一样被捕获。

有关键码映射,请参阅下表。无法捕获主页菜单语音搜索按钮。

亚马逊Fire TV遥控器按钮 键码 标准行为
选择(方向键中心) 13 选择具有当前焦点的用户界面项。
向上(方向键) 38 在用户界面中将焦点上移。
向下(方向键) 40 在用户界面中将焦点下移。
向左(方向键) 37 在用户界面中将焦点左移。
向右(方向键) 39 在用户界面中将焦点右移。
播放/暂停 179 控制媒体播放。播放/暂停是一个切换。
倒回 227 在媒体播放上下文中倒回或向后跳转。
快进 228 在媒体播放上下文中快进或向前跳转。
后退 4 返回历史堆栈或返回主屏幕(如果历史堆栈为空)。

这些按键事件仅发送到获得焦点的应用。

使用Amazon Fire游戏控制器的输入

针对Amazon Fire游戏控制器的开发非常简单:

  • Amazon WebView支持W3C标准游戏手柄API。
  • Amazon Fire游戏控制器上的按钮映射到标准的游戏手柄格式。
  • 在将游戏手柄API与Amazon Fire游戏控制器结合使用时,后退按钮等同于标准控制器上的选择,而菜单按钮等同于开始。如果不使用游戏手柄API,则这些按钮相当于后退菜单按钮。

有关针对标准游戏手柄API进行开发的更多信息,请参阅消除游戏手柄API的障碍

如果选择不使用游戏手柄API,则Amazon Fire游戏控制器上的按钮通常会映射到亚马逊Fire TV遥控器的相同功能(B按钮除外)。

亚马逊Fire TV(第2代)游戏控制器具有以下按钮:

亚马逊Fire TV(第1代)游戏控制器具有以下按钮:

下表显示了键映射。

亚马逊游戏手柄控制器按钮 键码 标准行为
向上(方向键/操纵杆) 38 在用户界面中将焦点上移。
向下(方向键/操纵杆) 40 在用户界面中将焦点下移。
向左(方向键/操纵杆) 37 在用户界面中将焦点左移。
向右(方向键/操纵杆) 39 在用户界面中将焦点右移。
A 13 选择具有当前焦点的用户界面项。
B 8
X 13 选择具有当前焦点的用户界面项。
Y 13 选择具有当前焦点的用户界面项。
后退 4 返回历史堆栈或返回主屏幕(如果历史堆栈为空)。

播放/暂停媒体按钮

所有针对亚马逊Fire TV提交的媒体应用均需满足一项要求,即可以处理媒体播放/暂停按键事件,以控制媒体播放。所有游戏应用也必须处理媒体播放/暂停按键事件,才能播放或暂停游戏。播放/暂停按钮的键码是179。

后退按钮

用户在Fire TV上的网页应用中按下返回按钮后,该网页应用会收到来自KeyEvent类的标准Android按键事件。有关如何在Fire TV遥控器上捕获按键事件的详细信息,请参阅遥控器输入。有关如何在Amazon Fire游戏控制器上捕获按键事件的详细信息,请参阅游戏控制器输入


Last updated: 2023年8月30日