网页应用中的支持控制器
亚马逊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日