当 TV 应用体验保持一致、逻辑清晰且可预测时，用户会乐于使用。用户应该能够在您的应用内以及整个 Android TV 系统中导航，而不会迷路或不得不“重置”界面并重新开始。用户欣赏清晰、色彩丰富且功能强大的界面，这些界面能带来美妙的体验。牢记这些想法，您可以打造一款完美适配 Android TV 并符合用户预期的应用。
这些核对清单涵盖了应用和游戏开发的主要方面，有助于确保您的应用提供尽可能好的体验。仅针对游戏的额外考量内容，请参阅游戏部分。
有关 Android TV 应用通过 Google Play 分发所需满足的标准，请参阅TV 应用质量准则。
TV 外形规格支持
这些核对清单项适用于游戏和应用。
- 在清单文件中使用
CATEGORY_LEANBACK_LAUNCHER过滤器标识主 TV Activity。 - 为应用支持的每种语言提供一个主屏幕横幅，并具备以下特征：
- 横幅尺寸为 320x180 像素。
- 横幅资源位于
drawables/xhdpi目录中。 - 横幅图像包含用于标识应用的本地化文本。
- 考虑您的应用是否需要阻止设备进入环境模式 (Ambient Mode)。这对于媒体播放应用尤为重要。
- 不要为可能不支持的硬件声明硬件要求。
- 确保您的权限不会暗示硬件要求。
用户界面设计
这些核对清单项适用于游戏和应用。
- 通过设置
android:screenOrientation="landscape"将 Activity 指定为横向模式。 - 为横向模式提供适当的布局资源。
- 确保文本和控件足够大，以便在远处也能看清。
- 为 HDTV 屏幕提供高分辨率位图和图标。
- 确保您的图标和徽标符合 Android TV 规范。
- 在布局中预留过扫描 (Overscan) 空间。
- 当用户主动发起媒体播放时，阻止设备进入环境模式。
- 确保每个 UI 元素都能同时通过方向键 (D-pad) 和游戏控制器进行操作。请参阅TV 导航和处理 TV 硬件。
- 在用户浏览内容时更改背景图像。
- 在 Leanback Fragment 中自定义背景颜色以匹配您的品牌形象。
- 确保您的 UI 不需要触摸屏。请参阅触摸屏和声明不需要触摸屏。
- 遵循有效广告投放指南。
- 若要引导用户完成一系列决策，请使用 Leanback 库的引导步骤 API。
搜索与内容发现
这些核对清单项适用于游戏和应用。
TV 主屏幕
这些核对清单项适用于主屏幕的布局和内容。
渠道
- 提供一个能代表频道内容的有意义名称。请勿使用应用名称作为频道名称。
- 除非有用户交互，否则请勿更改频道名称。
- 为每个频道包含一个关联图标。图标不必完全是您的应用图标；它可以是频道内容的品牌化呈现。
- 使每个频道独一无二，并且不要模仿“接下来播放”(Play Next) 行的功能。例如，让用户从上次停止播放的地方继续观看视频，这并非频道的正当用法。
频道中的内容
- 限制频道中的每个节目仅对应一段内容。节目不得包含视频合集。
- 请勿将节目用于推广信息或广告。
- 为每个节目包含合适的描述，并正确映射其元数据。例如，内容分级不应出现在预期显示标题的位置。
- 请勿裁剪或拉伸代表节目内容的预览图像。它们必须符合可用的宽高比之一。
- 用户选择节目后，应立即开始播放。
接下来播放 (Play Next)
- 除非用户以某种方式与内容进行了交互，否则不要将其添加到“接下来播放”行。例如，您可以添加用户当前正在观看的系列的下一集，但在用户看完当前系列后，不要添加相关但不同的系列。
- 将“接下来播放”的内容限制为传统的电视节目、电影或赛事。请勿在“接下来播放”行中添加短片。
播放应用
这些核对清单项适用于执行媒体播放的应用。
- 注册媒体会话以通知平台媒体播放状态，并允许将播放控制委托给应用。
- 当视频在屏幕上播放时，设置
FLAG_KEEP_SCREEN_ON标志，以防止设备在播放期间进入待机或环境模式。 - 使用 Media Controller Test 和 Media Session Validator 验证媒体命令是否准确公开了元数据并控制了播放。
- 遵守与环境模式相关的质量准则。环境模式可以在观看会话之间让用户安静地享受，并防止屏幕烧屏。
- 对应用的内存进行性能分析，并确保通过
ActivityManager.isLowRamDevice()检查低内存设备。对于此类设备，必须遵循优化内存使用指南中的要求。
游戏
这些核对清单项适用于游戏。
- 在清单文件中设置
isGame标志，以便您的游戏显示在主屏幕的游戏部分。 - 确保游戏控制器支持不依赖于“开始”(Start)、“选择”(Select) 或“菜单”(Menu) 按钮。并非所有控制器都有这些按钮。
- 使用不带有特定控制器品牌标识的通用游戏手柄图形来展示游戏按钮映射。
- 检查以太网和 Wi-Fi 连接性。
- 为用户提供一种干净的方式来退出应用。
发布到 Android TV
要了解如何分发到 Android TV，请参阅在 Google Play 上发布 TV 应用的详细指南。