当 TV 应用体验一致、逻辑性和可预测性强时，用户会乐于使用。他们应该能够在您的应用内以及整个 Android TV 中导航，而不会迷路或不得不“重置”UI 并重新开始。用户欣赏清晰、多彩且实用的界面，这些界面使体验变得神奇。牢记这些理念，您可以创建一个完美融入 Android TV 并按用户预期执行的应用。
这些清单涵盖了应用和游戏的开发主要方面，有助于确保您的应用提供最佳体验。仅适用于游戏的其他注意事项在游戏部分中介绍。
有关使 Android TV 应用有资格通过 Google Play 分发的标准，请参阅TV 应用质量。
TV 外形尺寸支持
这些清单项目适用于游戏和应用。
- 使用清单中的
CATEGORY_LEANBACK_LAUNCHER过滤器识别主要 TV 活动。 - 为您的应用支持的每种语言提供首页横幅，并具有以下特征
- 横幅尺寸为 320x180 px。
- 横幅资源位于
drawables/xhdpi目录中。 - 横幅图像包含本地化文本以识别应用。
- 考虑您的应用是否需要阻止设备进入环境模式。这与媒体播放应用特别相关。
- 不要声明硬件要求，这些硬件可能不受支持。
- 确保您的权限不暗示硬件要求。
用户界面设计
这些清单项目适用于游戏和应用。
- 通过设置
android:screenOrientation="landscape"指定横向方向的活动。 - 为横向模式提供适当的布局资源。
- 确保文字和控件足够大，以便从远处观看。
- 为高清电视屏幕提供高分辨率位图和图标。
- 确保您的图标和徽标符合Android TV规范。
- 在您的布局中考虑超扫描。
- 当主动播放用户发起的媒体播放时，防止设备进入环境模式。
- 确保每个UI元素都适用于方向键和游戏手柄。请参阅电视导航和处理电视硬件。
- 随着用户浏览内容，更改背景图片。
- 在Leanback片段中自定义背景颜色以匹配您的品牌。
- 确保您的UI不需要触摸屏。请参阅触摸屏和声明不需要触摸屏。
- 遵循有效广告指南。
- 要引导用户完成一系列决策，请使用Leanback库的引导步骤API。
搜索和内容发现
这些清单项目适用于游戏和应用。
电视主屏幕
这些清单项目适用于主屏幕的布局和内容。
频道
- 提供一个有意义的名称来代表频道的內容。不要使用您的应用名称作为频道名称。
- 除非与用户进行某些交互，否则不要更改频道名称。
- 为每个频道包含一个关联的图标。该图标不需要是您应用的确切图标；它可以是频道中内容的品牌化表示。
- 使每个频道都唯一，并且不要模仿“接下来播放”行的功能。例如，允许用户继续观看他们上次观看视频的位置不是使用频道的有效用途。
频道中的内容
- 将频道中的每个节目限制为单个内容。节目不得包含视频集合。
- 不要将节目用于促销信息或广告。
- 为每个节目包含合适的描述，并正确映射其元数据。例如，内容分级不得出现在预期标题的位置。
- 不要裁剪或拉伸代表节目内容的预览图像。它们必须符合可用的纵横比之一。
- 用户选择节目后立即开始播放。
接下来播放
- 除非用户以某种方式与“接下来播放”行进行交互，否则不要向其中添加内容。例如，您可以添加用户当前正在观看的系列剧的下一集，但当用户完成当前系列剧时，不要添加相关的但不同的系列剧。
- 将“接下来播放”内容限制为传统的电视节目、电影或活动。不要向“接下来播放”行添加剪辑。
播放应用
这些清单项目适用于执行媒体播放的应用。
- 注册媒体会话以通知平台媒体播放状态，并允许将播放控件委托给应用。
- 在屏幕上播放视频时设置
FLAG_KEEP_SCREEN_ON标志，以防止设备在播放期间进入待机状态或环境模式。 - 使用媒体控制器测试和媒体会话验证器验证媒体命令是否准确地公开元数据并控制播放。
- 遵守与环境模式相关的质量指南。环境模式让用户在观看会话之间保持安静的娱乐状态，并防止屏幕烧屏。
游戏
这些清单项目适用于游戏。
- 在清单中设置
isGame标志，以便您的游戏显示在主屏幕的游戏部分。 - 确保游戏手柄支持不依赖于“开始”、“选择”或“菜单”按钮。并非所有手柄都具有这些按钮。
- 使用通用的游戏手柄图形（无特定手柄品牌）来显示游戏按钮映射。
- 检查以太网和Wi-Fi连接。
- 为用户提供一种干净的方式来退出您的应用。
分发到 Android TV
要了解如何分发到Android TV，请参阅在Google Play上发布电视应用的详细指南。