Android Studio V3.12环境下TV开发教程
（转自Android官网https://developer.android.com/training/tv/start）
文章源自：光谷佳武 https://blog.csdn.net/jiawuhan/article/details/80618879
管理电视控制器
电视设备需要一个辅助硬件设备来与应用程序进行交互，形式为基本的遥控器或游戏控制器。 这意味着您的应用必须支持D-pad输入。 这也意味着你的应用程序可能需要处理离线的控制器，以及来自多种类型的控制器的输入。
本课讨论处理电视设备控制器的要求。
D-pad最低限度的控制
电视设备的默认控制器是D-pad。 一般来说，您的应用程序应该可以从仅具有上，下，左，右，选择，后退和主页按钮的遥控器操作。 如果您的应用程序是通常需要带有附加控件的游戏控制器的游戏，则您的应用程序应尝试使用这些D-pad控件进行游戏。 在这种情况下，您的应用程序还应警告用户需要控制器，并允许他们使用D-pad控制器优雅地退出游戏。 有关使用电视设备的D-pad控制器进行导航的更多信息，请参阅创建电视导航 。
手柄控制器断开连接
电视控制器通常是蓝牙设备，它可能会尝试通过定期进入睡眠模式和断开电视设备来节省电量。 这意味着如果应用程序未配置为处理这些重新连接事件，则可能会中断或重新启动应用程序。 这些事件可能发生在以下任何情况下：
- 在观看几分钟长的视频时，D-Pad或游戏控制器进入睡眠模式，断开与电视设备的连接，然后重新连接。
- 在游戏过程中，新玩家使用当前未连接的游戏控制器加入游戏。
- 在游戏过程中，玩家离开游戏并断开游戏控制器。
任何可能断开和重新连接事件的TV应用程序活动都必须配置为处理应用程序清单中的重新连接事件。 以下代码示例演示了如何启用活动来处理配置更改，包括连接，断开连接或重新连接的键盘或导航设备：
<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-pad输入变化
电视设备用户可能有多种类型的控制器，他们使用他们的电视。 例如，用户可能同时拥有基本的D-pad控制器和游戏控制器。 游戏控制器在用于D-pad功能时提供的键码可能与物理D-pad发送的键码不同。
你的应用程序应该处理来自游戏控制器的D-pad输入的变化，所以用户不必物理地切换控制器来操作你的应用程序。 有关处理这些输入变化的更多信息，请参阅处理控制器操作 。
处理按钮事件
当用户点击控制器上的按钮时，您的应用会收到一个带有KeyEvent的事件。 该按钮的预期行为可能是媒体事件（如播放，暂停或停止），也可能是电视类型的事件（如选择或导航）。 为了提供良好的用户体验，您的应用应该为控制器按钮分配一致的行为。
电视用户界面事件
生成这些KeyEvent的按钮应该由应用根据下表处理。
| KeyEvent的 | 行为 |
|---|---|
| BUTTON_B，BACK | 背部 |
| BUTTON_SELECT，BUTTON_A，ENTER，DPAD_CENTER，KEYCODE_NUMPAD_ENTER | 选择 |
| DPAD_UP，DPAD_DOWN，DPAD_LEFT，DPAD_RIGHT | 导航 |
媒体活动
当用户正在观看媒体时，生成这些KeyEvent的按钮应按照下表处理。 如果您的应用程序正在控制MediaSession，它应该调用其中一个TransportControls方法，如下所示。 请注意，选择按钮在这种情况下充当播放/暂停按钮。
| KeyEvent的 | TransportControls调用 | 行为 |
|---|---|---|
| BUTTON_SELECT，BUTTON_A，ENTER，DPAD_CENTER， KEYCODE_NUMPAD_ENTER |
pause() |
玩 |
| 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() |
倒带 |
| （没有KeyEvent与Stop关联） | stop() |
停止 |
处理游戏的控制器
支持D-pad控制
由于此控件集是Android TV设备的默认设置，因此围绕方向键盘（D-pad）控件规划控制方案。 玩家需要能够在游戏的各个方面使用D-Pad，而不仅仅是控制核心游戏玩法，还需要导航菜单和广告。 出于这个原因，您还应该确保您的Android TV游戏不涉及触摸界面。 例如，Android TV游戏不应该告诉玩家“ 点击此处继续”。
如何塑造播放器与控制器的交互可能是实现卓越用户体验的关键：
- 预先沟通控制器要求 。 使用您的Google Play说明与玩家沟通对控制器的任何期望。 如果一个游戏比一个只有一个D-pad的游戏手柄更适合于游戏手柄，请明确说明这一点。 使用不合适的控制器进行游戏的玩家很可能会有次级体验，并在评分中惩罚您的游戏。
- 使用一致的按钮映射 。 直观灵活的按钮映射是获得良好用户体验的关键。 例如，您应该使用A按钮接受 ，并按下B按钮取消 ，以遵守接受的海关。 您还可以提供可重新映射形式的灵活性。 有关按钮映射的更多信息，请参阅处理控制器操作 。
- 检测控制器功能并据此进行调整 。 向控制器查询其功能以优化控制器和游戏之间的匹配。 例如，您可能希望玩家通过在空中挥动控制器来引导物体。 如果玩家的控制器缺乏加速计和陀螺仪硬件，挥手将无法工作。 所以，你的游戏应该查询控制器，如果不支持运动检测，切换到另一种可用的控制方案。 有关查询控制器功能的更多信息，请参阅Android版本的支持控制器 。
提供适当的后退按钮行为
后退按钮不应该充当切换。 例如，不要用它来打开和关闭菜单。 它应该仅通过前一个屏幕（例如：游戏玩法>游戏暂停屏幕>游戏主屏幕> Android主屏幕）向后导航，即面包屑式。
由于后退按钮只应执行线性（向后）导航，因此您可以使用后退按钮离开游戏内菜单（由不同的按钮打开）并返回游戏状态。 有关导航设计的更多信息，请参阅导航 。 要了解实施情况，请参阅提供适当的后退导航 。
使用适当的按钮
并非所有游戏控制器都提供开始，搜索或菜单按钮。 确保你的用户界面不依赖于这些按钮的使用。
处理多个控制器
当多个玩家正在玩一个游戏时，每个玩家都有自己的控制器，因此映射每个玩家 - 控制器对非常重要。 有关如何实现控制器编号标识的信息，请参阅getControllerNumber() 。
手柄控制器断开连接
当游戏过程中控制器断开连接时，游戏应该暂停，并且会出现一个对话框，提示断开的玩家重新连接他或她的控制器。
该对话框还应提供故障排除提示（例如，弹出对话框告诉玩家“检查您的蓝牙连接”）。 有关实现输入设备支持的更多信息，请参阅处理控制器操作 。 有关蓝牙连接的特定信息位于蓝牙 。
显示控制器说明
如果您的游戏提供视觉游戏控制指令，则控制器图像应该没有品牌，并且只包含与Android兼容的按钮 。
有关Android兼容控制器的示例图像，请下载Android TV游戏板模板（ZIP） 。 它包括黑色背景上的白色控制器和白色背景上的黑色控制器（如图1所示），作为PNG文件和Adobe®Illustrator®文件。
图1.使用Android TV游戏板模板（ZIP）的示例控制器说明。