当电视应用体验一致、逻辑性和可预测性时，用户会乐在其中。他们应该能够在您的应用内以及整个 Android TV 中导航，而不会迷路或不得不“重置”UI 并重新开始。用户欣赏清晰、多彩且实用的界面，这些界面使体验变得神奇。牢记这些想法，您可以创建一个完美融入 Android TV 并按用户预期执行的应用。
这些清单涵盖了应用和游戏开发的主要方面，有助于确保您的应用提供最佳体验。仅针对游戏的其他注意事项在游戏部分中介绍。
有关使 Android TV 应用有资格通过 Google Play 分发的标准，请参阅电视应用质量。
电视外形尺寸支持
这些清单项适用于游戏和应用。
- 使用清单中的
CATEGORY_LEANBACK_LAUNCHER过滤器识别主要的电视活动。 - 为您的应用支持的每种语言提供首页横幅，并具有以下特征
- 横幅尺寸为 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 上发布电视应用的详细指南。