开发者控制台

控制器行为指导

控制器行为指导

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

通过远程控制输入游戏控制器输入的运动和输入事件,执行应用控制器的输入。

本页推荐了不同控制器中建议的应用功能。这些指导均不是发布Amazon 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