Web 应用中的支持控制器


Web 应用中的支持控制器

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 遥控器的可用按键相同,即使这两种遥控器看起来稍有不同。

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

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

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。