只有稳定一致、符合逻辑且可预测的 TV 应用体验才能让用户享受其中。 用户应该能够在您的应用和整个 Android TV 中导航,而不会迷失方向,也无需“重置”界面并重新开始。用户喜欢清晰、多彩且能发挥奇效的界面。秉持这样的理念,您就能打造出与 Android TV 完美契合并且能满足用户期望的出色应用。
这些核对清单涵盖了应用和游戏开发的主要方面,有助于确保您的应用提供尽可能出色的体验。游戏部分介绍了仅适用于游戏的其他注意事项。
如需了解 Android TV 应用可通过 Google Play 分发需满足的条件,请参阅 TV 应用质量。
TV 设备类型支持
以下核对清单项目适用于游戏和应用。
-
在清单中使用
CATEGORY_LEANBACK_LAUNCHER
过滤器确定主要 TV activity。 -
为应用支持的每种语言提供一个主屏幕横幅,并具有以下特征:
- 横幅广告的尺寸为 320x180 像素。
- 横幅资源位于
drawables/xhdpi
目录中。 - 横幅图片包括用于标识应用的本地化文本。
- 考虑您的应用是否需要阻止设备进入氛围模式。 这与媒体播放应用密切相关。
- 不针对可能不受支持的硬件声明要求。
- 确保您的权限不隐含硬件要求。
界面设计
以下核对清单项目适用于游戏和应用。
-
通过设置
android:screenOrientation="landscape"
来指定屏幕方向为横向的 activity。 - 提供适用于横屏模式的布局资源。
- 确保文本和控件足够大,可以在一定距离外看清。
- 提供适合高清电视屏幕的高分辨率位图和图标。
- 确保您的图标和徽标符合 Android TV 规范。
- 允许在布局中进行过扫描。
- 在主动播放用户发起的媒体播放时,防止设备进入氛围模式。
- 确保每个界面元素都可与方向键和游戏控制器配合使用。请参阅 TV 导航和处理 TV 硬件。
- 在用户浏览内容时更改背景图片。
- 自定义背景颜色,以匹配 Leanback fragment 中的品牌信息。
- 确保您的界面不需要触摸屏。请参阅触摸屏和声明不需要触摸屏。
- 遵循有效广告准则。
- 如需引导用户做出一系列决定,请使用 Leanback 库的引导步骤 API。
搜索和内容发现
以下核对清单项目适用于游戏和应用。
TV 主屏幕
以下核对清单项目适用于主屏幕的布局和内容。
频道
- 提供一个能代表频道内容的有意义的名称。请勿将应用名称用作频道名称。
- 除非与用户进行了某些互动,否则请勿更改频道名称。
- 为每个频道添加关联的图标。该图标不必与应用的图标完全一致,它可以是频道中内容的品牌形象表现形式。
- 确保每个频道都是独一无二的,不要模仿“接下来播放”行的功能。 例如,让用户从视频暂停的位置继续观看并不是频道的有效用法。
频道中的内容
- 将频道中的每个节目限制为一项内容。一个节目不得包含多个视频的集合。
- 不得使用计划发布促销信息或广告。
- 为每个节目添加合适的说明,并正确映射其元数据。例如,内容分级不得出现在需显示标题的位置。
- 请勿剪裁或拉伸代表节目内容的预览图片。它们必须符合可用的宽高比之一。
- 在用户选择某个节目后开始播放。
接下来播放
- 除非用户以某种方式与“接下来播放”行进行了互动,否则不要向“接下来播放”行添加内容。例如,您可以添加用户当前正在观看的连续剧的下一集,但在用户看完当前连续剧时,不要添加相关但不同的连续剧。
- 将“接下来播放”内容限制为传统电视节目、电影或活动。不要向“接下来播放”行添加片段。
播放应用
以下核对清单项目适用于执行媒体播放的应用。
- 注册媒体会话,以向平台通知媒体播放状态,并允许将播放控件委托给应用。
-
当视频在屏幕上播放时,设置
FLAG_KEEP_SCREEN_ON
标志,以防止设备在播放过程中进入待机模式或氛围模式。 - 使用媒体控制器测试和媒体会话验证器,验证媒体命令是否准确公开元数据并控制播放。
- 遵守与氛围模式相关的质量指南。氛围模式可让用户在切换观看会话期间安静地娱乐,防止烧屏。
游戏
以下核对清单项目适用于游戏。
-
在清单中设置
isGame
标志,让您的游戏显示在主屏幕的游戏部分中。 - 确保游戏控制器支持不依赖于“开始”“选择”或“菜单”按钮。并非所有控制器都有这些按钮。
- 使用通用的游戏手柄图片(没有具体的控制器品牌)来显示游戏按钮映射。
- 检查以太网和 Wi-Fi 连接。
- 提供简洁明了的应用退出方式。
分发到 Android TV 平台
如需了解如何分发到 Android TV,请参阅在 Google Play 上发布 TV 应用的详细指南。