管理电视控制器

电视设备需要一个辅助硬件设备来与应用交互——一个基本的遥控器或游戏控制器。因此，您的应用必须支持方向键（D 键）输入。此外，您的应用可能需要处理控制器脱机以及来自多种类型控制器的输入。

本指南讨论了处理电视设备控制器所需的条件。

D 键的最低限度控制

电视设备的默认控制器是 D 键。一般来说，您的应用必须能够通过仅具有上、下、左、右、选择、后退和主页按钮的遥控器进行操作。如果您的应用是一款通常需要带有其他控件的游戏控制器的游戏，请尝试仅使用这些 D 键控件来支持游戏玩法。否则，警告用户需要控制器，并允许他们使用 D 键控制器优雅地退出游戏。

有关使用电视设备的 D 键控制器导航的更多信息，请参阅电视导航。

处理控制器断开连接

电视的控制器通常是蓝牙设备，它们可能会尝试通过定期进入睡眠模式并与电视设备断开连接来节省电量。这意味着，如果应用未配置为处理这些重新连接事件，则可能会中断或重新启动。这些事件可能发生在以下任何情况下

在播放时长数分钟的视频时，D 键或游戏控制器可能会进入睡眠模式，与电视设备断开连接，并在稍后重新连接。
在游戏过程中，新玩家可能会使用尚未连接的游戏控制器加入游戏。
在游戏过程中，玩家可能会离开游戏并断开游戏控制器的连接。

任何容易出现断开连接和重新连接事件的电视应用活动都必须配置为在应用清单中处理重新连接事件。以下代码示例演示了如何启用活动以处理配置更改，包括键盘或导航设备连接、断开连接或重新连接

<activity
  android:name="com.example.android.TvActivity"
  android:label="@string/app_name"
  android:configChanges="keyboard|keyboardHidden|navigation"
  android:theme="@style/Theme.Leanback">

  <intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
  </intent-filter>
  ...
</activity>

此配置更改使应用能够在重新连接事件中继续运行，而不是由 Android 框架重新启动，这并不是良好的用户体验。

处理 D 键输入变化

电视设备用户可能有多种类型的控制器可用于其电视。例如，用户可能同时拥有基本的 D 键控制器和游戏控制器。当游戏控制器用于 D 键功能时提供的键码可能与基本 D 键发送的键码不同。

处理方向键输入的变化，以便用户无需切换控制器即可操作您的应用。有关处理输入变化的更多信息，请参阅处理方向键输入。

处理按钮事件

当用户点击控制器上的按钮时，您的应用会收到一个包含KeyEvent的事件。按钮的预期行为可能是媒体事件，例如播放、暂停或停止，也可能是电视类型事件，例如选择或导航。为了提供良好的用户体验，请为控制器按钮分配一致的行为。

电视 UI 事件

将电视 UI 行为分配给生成KeyEvent类型的按钮，如下表所示

`KeyEvent`	行为
`KEYCODE_BUTTON_B`、`KEYCODE_BACK`	返回
`KEYCODE_BUTTON_SELECT`、`KEYCODE_BUTTON_A`、`KEYCODE_ENTER`、`KEYCODE_DPAD_CENTER`、`KEYCODE_NUMPAD_ENTER`	选择
`KEYCODE_DPAD_UP`、`KEYCODE_DPAD_DOWN`、`KEYCODE_DPAD_LEFT`、`KEYCODE_DPAD_RIGHT`	导航

媒体事件

当用户正在观看媒体时，请为生成KeyEvent类型的按钮分配行为，如下表所示。如果您的应用正在控制MediaSession，请使用MediaControllerAdapter来调用表中显示的MediaControllerCompat.TransportControls方法之一。请注意，在此上下文中，选择按钮充当播放或暂停按钮。

`KeyEvent`	TransportControls 调用	行为
`BUTTON_SELECT`、`BUTTON_A`、`ENTER`、`DPAD_CENTER`、`KEYCODE_NUMPAD_ENTER`	`play()`	播放
`BUTTON_START`、`BUTTON_SELECT`、`BUTTON_A`、`ENTER`、`DPAD_CENTER`、`KEYCODE_NUMPAD_ENTER`	`pause()`	暂停
`BUTTON_R1`	`skipToNext()`	跳到下一项
`BUTTON_L1`	`skipToPrevious()`	跳到上一项
`DPAD_RIGHT`、`BUTTON_R2`、`AXIS_RTRIGGER`、`AXIS_THROTTLE`	`fastForward()`	快进
`DPAD_LEFT`、`BUTTON_L2`、`AXIS_LTRIGGER`、`AXIS_BRAKE`	`rewind()`	倒回
N/A	`stop()`	停止

注意：当您使用MediaSession时，请勿覆盖媒体特定按钮（例如KEYCODE_MEDIA_PLAY或KEYCODE_MEDIA_PAUSE）的处理方式。系统会自动触发相应的MediaSession.Callback方法。

提供合适的返回按钮行为

返回按钮绝不能充当切换按钮。例如，不要使用它来打开和关闭菜单。仅使用它以面包屑样式向后导航到播放器之前访问过的屏幕。

由于返回按钮仅执行线性向后导航，因此您可以使用它退出由其他按钮打开的应用内菜单并返回到应用。连续按返回按钮最终必须始终导致进入 Android TV 主屏幕。例如：游戏玩法 > 游戏暂停屏幕 > 游戏主屏幕 > Android TV 主屏幕或电视节目播放 > 电视应用主屏幕 > Android TV 主屏幕。

有关导航设计的更多信息，请参阅设计返回和向上导航。要了解实现方法，请参阅提供正确的返回导航。

处理游戏的控制器

支持方向键控制

围绕方向键控制规划您的控制方案，因为此控制集是 Android TV 设备的默认设置。玩家需要能够使用方向键控制游戏的各个方面，不仅是控制核心游戏玩法，还包括导航菜单和广告。因此，请确保您的 Android TV 游戏不要使用“点击此处继续”之类的语言来提及触摸界面。

您塑造玩家与控制器的交互方式可能是实现出色用户体验的关键。请考虑以下最佳实践

提前告知控制器要求：使用您的 Google Play 说明来告知玩家有关控制器的任何期望。如果游戏更适合使用带操纵杆的游戏手柄而不是仅带方向键的游戏手柄，请明确说明。使用不适合游戏的控制器进行游戏的玩家可能会遇到糟糕的体验，并给您的游戏评分很低。
使用一致的按钮映射：直观的按钮映射是良好用户体验的关键。例如，通过使用 A 按钮确认和 B 按钮取消来遵守公认的习惯。您还可以通过可重新映射性提供灵活性。有关按钮映射的更多信息，请参阅处理控制器操作。
检测控制器功能并相应调整：查询控制器以了解其功能，以优化控制器和游戏之间的匹配。例如，您可能希望玩家通过在空中挥动控制器来操控物体，但如果玩家的控制器缺少加速度计和陀螺仪硬件，则挥动不起作用。查询控制器，如果不受支持，则切换到可用的替代控制方案。有关查询控制器功能的更多信息，请参阅支持跨 Android 版本的控制器。

使用合适的按钮

并非所有游戏控制器都提供开始、搜索或菜单按钮。请确保您的 UI 不依赖于这些按钮的使用。

处理多个控制器

当多名玩家使用各自的控制器玩游戏时，必须映射每个玩家-控制器对。有关如何实现控制器编号识别的信息，请参阅 getControllerNumber()。

处理控制器断开连接

如果控制器在游戏过程中断开连接，请暂停游戏并显示一个对话框，提示断开连接的玩家重新连接其控制器。

此外，在对话框中提供故障排除技巧。例如，告诉玩家“检查您的蓝牙连接”。有关实现输入设备支持的更多信息，请参阅处理控制器操作和蓝牙概述。

显示控制器说明

如果您的游戏提供视觉游戏控制说明，请使用不含品牌的控制器图像，并且仅包含与 Android 兼容的按钮。

有关 Android 兼容控制器的示例图像，请下载Android TV 游戏手柄模板 (ZIP)。它包含黑色背景上的白色控制器和白色背景上的黑色控制器（如图 1 所示）作为 PNG 文件和 Adobe® Illustrator® 文件。

图 1. 使用 Android TV 游戏手柄模板的控制器说明示例。

处理电视硬件

屏幕键盘