TV 应用核对清单

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

只有稳定、顺畅且可预测的 TV 应用体验才能让用户享受其中。 他们应该能够在您的应用和整个 Android TV 中导航，不会迷失方向，也不必“重置”界面并重新开始。用户喜欢一目了然、色彩明丽、功能丰富的界面，这样的界面能够给人美妙的体验。秉持这样的理念，您就能够打造出与 Android TV 完美契合并符合用户期望的出色应用。

这些核对清单涵盖了应用和游戏开发的主要方面，以帮助您打造出具有最佳体验的应用。游戏部分介绍了仅适用于游戏的其他注意事项。

如需了解 Android TV 应用要通过 Google Play 分发需要满足的条件，请参阅 TV 应用质量。

电视设备类型支持

以下核对清单项目适用于游戏和应用。

• 在清单中使用 CATEGORY_LEANBACK_LAUNCHER 过滤器确定主要 TV activity。
• 为应用支持的每一种语言提供一个主屏幕横幅，该横幅应具有以下特征：
  • 横幅的尺寸为 320x180 像素。
  • 横幅资源位于 drawables/xhdpi 目录中。
  • 横幅图片包括用于标识应用的本地化文本。
• 考虑您的应用是否需要阻止设备进入氛围模式。 这对于媒体播放应用尤为重要。
• 请勿针对可能不受支持的硬件声明要求。
• 确保您的权限不隐含硬件要求。

界面设计

以下核对清单项目适用于游戏和应用。

• 通过设置 android:screenOrientation="landscape" 指定横屏模式的 activity。
• 提供适用于横屏模式的布局资源。
• 确保文本和控件足够大，可以在一定距离外看清。
• 提供适合高清电视屏幕的高分辨率位图和图标。
• 确保图标和徽标符合 Android TV 规范。
• 允许在布局中进行过扫描。
• 在主动播放用户发起的媒体时，阻止设备进入氛围模式。
• 确保每个界面元素都可与方向键和游戏控制器配合使用。请参阅电视导航和处理 TV 硬件。
• 在用户浏览内容时转换显示的背景图片。
• 自定义背景颜色，以匹配 Leanback Fragment 中的品牌信息。
• 确保您的界面不需要触摸屏。请参阅触摸屏和声明不需要触摸屏。
• 遵循有效广告准则。
• 如需引导用户做出一系列决定，请使用 Leanback 库的引导步骤 API。

搜索和内容发现

以下核对清单项目适用于游戏和应用。

• 在 Android TV 全局搜索框中提供来自您的应用的搜索结果。
• 提供特定于 TV 的搜索数据字段。
• 确保应用在详情屏幕中呈现找到的内容，让用户能够立即开始观看这些内容。

TV 主屏幕

以下核对清单项目适用于主屏幕的布局和内容。

频道

• 提供一个能够代表频道内容的有意义的名称。请勿使用应用名称作为频道名称。
• 除非频道与用户进行某些交互，否则请勿更改频道名称。
• 为每个频道添加关联的图标。该图标不需要与应用的图标完全一致，它可以是频道内容的品牌形象展示。
• 使每个频道都独一无二，不要模仿“接下来播放”行的功能。例如，让用户从视频暂停位置继续观看的频道不是频道的有效用法。

频道内容

• 将频道中的每个节目限制为包含单独一条内容。一个节目不得包含多个视频的集合。
• 请勿使用节目来发布推广信息或广告。
• 为每个节目添加适当的说明，并正确映射其元数据。例如，内容分级不能出现在应该显示标题的位置。
• 请勿剪裁或拉伸代表节目内容的预览图片。它们必须符合一个可用的宽高比。
• 在用户选择节目后立即开始播放。

接下来播放

• 除非用户以某种方式与“接下来播放”行进行交互，否则不要向该行添加内容。例如，您可以添加用户当前正在观看的电视剧的下一集，但当用户观看完当前的电视剧后，请勿添加相关（但不同）的电视剧。
• 将“接下来播放”内容限制为传统的电视节目、影片或节目。请勿在“接下来播放”行中添加视频剪辑。

播放应用

以下核对清单项目适用于执行媒体播放的应用。

• 注册媒体会话，以告知平台媒体播放状态，并将播放控件委托给应用。
• 在屏幕上播放视频时设置 FLAG_KEEP_SCREEN_ON 标志，以阻止设备在播放期间进入待机或氛围模式。
• 使用媒体控制器测试和媒体会话验证程序验证媒体命令是否准确地公开元数据并控制播放。
• 遵循氛围模式相关质量指南。氛围模式可在用户观看时段之间为其提供安静的娱乐体验，并防止屏幕烧屏。
• 分析应用的内存，并务必检查 ActivityManager.isLowRamDevice() ，以发现低 RAM 设备。对于这些设备，您必须遵循优化内存用量准则中的要求。

游戏

以下核对清单项目适用于游戏。

• 在清单中设置 isGame 标志，以便您的游戏显示在主屏幕的游戏部分中。
• 确保游戏控制器支持不依赖于“开始”“选择”或“菜单”按钮。并非所有控制器都有这些按钮。
• 使用通用的游戏手柄图片（没有具体的控制器品牌）来显示游戏按钮映射。
• 检查以太网以及 WLAN 连接。
• 为用户提供简单明了的应用退出方式。

分发到 Android TV 平台

如需了解如何分发到 Android TV，请参阅有关在 Google Play 上发布 TV 应用的详细指南。