控制器行为指南


控制器行为指南

当您为 Amazon Fire TV 平台开发应用时,您可以支持来自不同类型控制器的输入。这些控制器包括 Amazon Fire TV 遥控器和语音遥控器、Amazon Fire TV 游戏控制器或任何其他支持蓝牙游戏手柄 HID 配置文件的控制器。

使用远程控制输入游戏控制器输入中的运动和输入事件为您的应用实现控制器输入。

此页面提供有关不同控制器中的常见应用功能的推荐。这些指南都不是发布 Amazon Fire TV 应用的要求,您可以以最适合您的应用的方式设计控制器输入。我们建议您遵循这些准则,以便在不同的控制器、应用和游戏中实现一致的用户体验。

核心行为

操作 Amazon Fire TV 遥控器按键 Amazon Fire 游戏控制器按键 其他游戏控制器按键 行为
主页 主页 主页 主页(如果可用) 这是一个系统事件,无法在您的应用中捕获。按下后,系统将用户返回主页。第二次按“主页”会将用户返回到“主页”。

实施 OnPause() 以在意外来到“主页”时保留应用或游戏中的状态。实施 OnResume() 以在应用恢复时继续。

音频应用可以通过请求音频焦点继续在后台播放。
后退 后退 后退 B 返回到上一个操作或屏幕(活动),或取消当前操作或提示。

捕获此事件以提供确认对话框。例如,在应用的主屏幕上,捕获“后退”以提供“是否要退出”对话框。
菜单 菜单 菜单 Y 调用标准的安卓上下文菜单 (OptionsMenu)。

捕获此事件以提供您自己的菜单,或用于任何其他目的。如果您的菜单只有一个选项,您可以使用“菜单”作为该选项的切换。

在媒体应用中,使用“菜单”显示或隐藏播放镶边。
搜索 麦克风(仅限语音遥控器) 不适用 不适用 这是一个系统事件,无法在您的应用中捕获。按下后,调用语音搜索。

实施 OnPause() 以在语音搜索启动时保留应用或游戏中的状态,并实施 OnResume() 以在完成后继续。

在音频应用中,当语音搜索处于活动状态时,暂停播放或降低音量。

在视频应用中,当语音搜索处于活动状态时,将音频静音或暂停播放。

下表介绍了用户界面导航和选择的推荐行为。对于显示多个按钮的项目,为这些按钮提供支持。

操作 Amazon Fire TV 遥控器按键 Amazon Fire 游戏控制器按键 其他游戏控制器按键 行为
选择/主动作 方向键中心 A A 选择焦点项目,确认菜单选项或提示,或执行主游戏操作。
取消/后退 后退 后退
B
B 取消当前操作,或返回上一个屏幕。

拦截此操作以提供确认对话框(“您确定要退出吗?”)



方向键 方向键
左摇杆
方向键
左摇杆
将输入焦点朝适当的方向移动。

在 Amazon Fire 游戏控制器和其他游戏控制器上,左摇杆应与方向键具有相同的行为。

媒体播放

下表描述了媒体播放的推荐行为。请注意以下事项:

  • 如果您的应用不播放媒体或使用摇杆或侧肩按键 (L1/R1),请勿捕获这些按键的事件。这样做可能会影响系统控制后台播放媒体的能力。
  • 请注意,如果您的应用使用一种框架(如 Unity),则您可以忽略此建议,因为这些框架中不支持将键事件传递给系统的功能。
操作 Amazon Fire TV 遥控器按键 Amazon Fire 游戏控制器按键 Amazon Fire 游戏控制器(第 1 代)按钮 其他游戏控制器按键 行为
播放/暂停 播放/暂停 A
左/右按键
播放/暂停 A 切换媒体播放或暂停。
倒回 倒回
向左(方向键)
左肩 (L1)
左肩 (L1) 倒回
向左(方向键)
左肩 (L1)
向左(方向键)
左肩 (L1)
在媒体播放情景中倒回或向后跳。确切的行为取决于特定的媒体:您可以使用此按钮来推移视频、跳到上一个音乐曲目,或者在幻灯片放映中移动到上一张照片。
快进 FF
向右(方向键)
右肩 (R1)
右肩 (R1) FF
向右(方向键)
右肩 (R1)
向右(方向键)
右肩 (R1)
在媒体播放情景中快进。确切的行为取决于特定的媒体:您可以使用此按钮来推移视频,跳到下一个音乐曲目,或者在幻灯片放映中移动到下一张照片。

音量控制

您可以将音频流式传输到 Amazon Fire TV 游戏控制器上的耳机插孔。用于音频播放的音量控制可以使用左右触发按钮 (L2/R2)。音量控制是一种系统功能,无法映射到应用中的其他按钮。

请注意以下事项:

  • 如果您的应用或游戏未使用这些按钮,请勿捕获这些输入事件。这样做可能会干扰用户控制音量的能力。
操作 Amazon Fire 游戏控制器按键
调高音量 左触发器 (L2)
调低音量 右触发器 (R2)

玩游戏

虽然游戏用户界面高度独立,但下表描述了基本建议。

操作 Amazon Fire TV 遥控器按键 Amazon Fire 游戏控制器按键 其他游戏控制器按键
主要游戏动作 方向键中心 A A
次要游戏动作 无建议 B B