开发人员控制台

网页应用中的支持控制器


网页应用中的支持控制器

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

使用Amazon Fire TV遥控器的输入

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

遥控器
遥控器

Fire TV Edition的遥控器具有一些额外的按钮,例如调高/调低音量、电源、Netflix、Amazon Prime和其他应用。但是,这些按钮无法映射到第三方应用中的事件,因此上面Fire TV遥控器中显示的按钮实际上与Fire TV Edition遥控器的可用按钮相同,即使这两种遥控器看起来稍有不同。

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

有关键码映射,请参阅下表。无法捕获后退主页菜单语音搜索按钮。有关允许使用HTML5网页应用自定义后退按钮行为的解决方法,请参阅Fire TV网页应用常见问题解答

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

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

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

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

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

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

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

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

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

下表显示了键映射。

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

播放/暂停媒体按钮

为Amazon Fire TV提交的所有媒体应用的一项要求是,它们应处理媒体播放/暂停键事件以控制媒体播放。所有游戏应用也必须处理媒体播放/暂停键事件,才能播放或暂停游戏。播放/暂停按钮的键码是179。