网页应用中的支持控制器
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。