控制器行为指导
控制器行为指导
为Amazon Fire TV平台开发应用时，可支持不同类型控制器的输入。这类控制器包括Amazon Fire TV遥控器、语音遥控器、Amazon Fire TV游戏控制器，或其他支持蓝牙游戏手柄HID配置文件的控制器。
通过远程控制输入和游戏控制器输入的运动和输入事件，执行应用控制器的输入。
本页推荐了不同控制器中建议的应用功能。这些指导均不是发布Amazon Fire TV应用要满足的要求，您可以采用最适合您应用的控制器输入设计。我们建议您遵循这些指导，以确保在不同控制器、应用和游戏之间实现一致的用户体验。
注意： 除麦克风按钮之外，所有Fire TV遥控器的行为均相同。本文档中适用于Fire TV遥控器的指南，也适用于Fire TV语音遥控器。
核心行为
| 操作 | Amazon Fire TV遥控器按钮 | Amazon Fire游戏控制器按钮 | 其他游戏控制器按钮 | 行为 |
|---|---|---|---|---|
| 主页 | 主页 | 主页 | 主页（若有） | 这是系统事件，无法在应用中捕获。按下后，系统将用户返回主页。第二次按“主页”按钮后，用户将返回到“主页”。 可通过实现 onPause()功能，以便在意外弹出“主页”时，保留应用或游戏的状态。可通过实现onResume()，在应用恢复时继续。可通过请求音频焦点，让音频应用继续在后台播放。 |
| 后退 | 后退 | 后退 | B | 返回到上一个操作或屏幕（活动），或取消当前操作或提示。 可将应用设计为：捕捉此事件时，弹出确认对话框。例如，位于应用主屏幕时，如果捕获“后退”事件，则弹出“是否要退出”对话框。 确保应用不会进入关闭和打开菜单的无限循环。 |
| 菜单 | 菜单 | 菜单 | Y | 调用标准的Android上下文菜单(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 |