与使用手机或平板电脑相比,用户在看电视时会有不同的期望。典型的电视用户坐在离屏幕约 10 英尺的位置,因此,小细节不太明显,而小号文字也很难看清。由于用户离电视较远,因此必须使用遥控设备来导航和做出选择,而不是轻触屏幕上的元素。这些差异大大影响了提供出色的电视用户体验的要求。
为提供出色的电视用户体验,首先要查阅并 遵循 Android TV 设计准则。如需了解电视应用的基本实现要求,请同时查看构建电视 应用培训内容。
TV 应用兼容性核对清单
兼容性核对清单定义了一些标准,可帮助您评估应用针对 Android TV OS 提供的支持服务级别。
支持服务级别包括:
第 3 层级 - 支持 TV
您的应用符合在 Android TV OS 设备上运行的基本要求。
第 2 层级 - 针对 TV 进行了优化
您的应用为 Android TV OS 设备提供了更量身定制的顺畅体验。
第 1 层级 - 针对 TV 提供差异化体验
您的应用充分利用了 Android TV OS 的高级功能,提供了优质体验。
第 3 层级 - 支持 TV
| 类型 | 测试 | 说明 |
|---|---|---|
| 启动器 | TV-LM | 安装后,应用会在 Android TV 启动器中显示一个启动器图标。如需了解详情,请参阅声明 TV activity。 |
| TV-LB | 应用在 Android TV 启动器中显示 320x180 像素的全尺寸横幅和至少 160x160 像素(xhdpi 密度)的应用图标作为其启动器图标。如需了解详情,请参阅 Android TV 应用图标和横幅准则。 | |
| TV-BN | 应用的启动横幅包含应用的名称。 | |
| TV-LG | 如果应用是一款游戏,则出现在 Android TV 启动器的游戏行中。如需了解详情,请参阅在主屏幕上显示游戏。 | |
| TV-LS | 应用成功运行,且没有错误消息,包括在安装、加载和测试期间。如需了解详情,请参阅运行 TV 应用。 | |
| 布局 | TV-LO | 应用支持横屏模式,且没有纵向黑边或邮筒模式。原始格式视频的竖条只能使用黑色。如需了解更多 信息,请参阅构建基本 TV 布局。 |
| TV-OV | 应用不会显示被屏幕边缘部分切断的任何文本或功能。如需了解详情,请参阅过扫描。 | |
| TV-TR | 应用不会部分遮住其他应用。应用填充整个屏幕并且采用非透明背景。 | |
| 导航 | TV-DP | 应用功能可使用 5 向方向键来进行导航,除非此应用需要游戏控制器(如以下“功能”表的“控制器”部分中的 TV-GP 标准中所指定)。如需了解详情,请参阅 TV 导航。 |
| TV-DK | 如果应用需要游戏控制器(如 TV-GP 标准中所指定),则所有功能均可使用标准的 Android 游戏控制器按键来进行导航。如需了解详情,请参阅处理游戏手柄按钮按下操作。 | |
| TV-DM | 应用不依赖有菜单按钮的遥控器来访问界面控件。 | |
| TV-DB | 按返回按钮可返回 Android TV 主屏幕。如需了解详情,请参阅提供适当的返回按钮行为。 | |
| TV-DL | 如果应用在“直播”标签页上集成了直播电视 Feed,则需符合流畅播放和直接返回要求。如需了解详情,请参阅返回按钮。 | |
| SDK | TV-PS | 除了核心性能和稳定性要求之外,应用还通过将 minSdkVersion 值设置为 31 或更低版本来声明对常用 Android TV 设备的支持。 |
| 清单 | TV-ML | 应用清单会设置一个类别为 CATEGORY_LEANBACK_LAUNCHER 的 Intent 类型 ACTION_MAIN。如需了解详情,请参阅声明 TV activity。 |
| TV-MT | 应用清单会将硬件功能 android.hardware.touchscreen 和“为 TV 声明硬件要求”中列出的其他功能设置为非必需功能。如需了解详情,请参阅为 TV 声明硬件要求。 | |
| 游戏控制器 | TV-GP | 如果应用使用游戏控制器作为主要输入法,则通过 <uses-feature> 清单标记来声明相应的要求。如需了解详情,请参阅声明对游戏控制器的支持。 |
| TV-GC | 如果应用提供了有关使用游戏控制器的直观说明,该说明应不含品牌信息,并且显示兼容的按钮布局。如需了解详情,请参阅处理游戏控制器。 | |
| 广告 | TV-AP | 应用支持使用方向键与广告进行交互。如需了解详情,请参阅启用方向键导航。 |
| TV-AD | 对于非视频全屏广告,应用允许用户立即用方向键或游戏手柄关闭广告。 | |
| TV-AU | 对于可点击的非全屏、非视频广告,应用不允许将广告链接到网址。 | |
| TV-AA | 对于可点击的非全屏、非视频广告,应用不允许将广告链接到电视设备上不可用的另一个应用。 | |
| 网页内容 | TV-WB | 对于网页内容,应用必须仅使用 WebView 组件。应用不得尝试启动网络浏览器应用。 |
| 媒体播放 | TV-NP | 如果应用在用户返回主屏幕或切换到其他应用后继续播放音频,则需在系统界面中提供媒体控件(例如卡片或通知),以便用户返回该应用来控制播放。如需了解详情,请参阅显示“闻曲知音”卡片。视频应用不得使用这些媒体控件,并且当用户切换出应用时,视频必须暂停。 |
| TV-PA | 如果应用在系统界面上提供媒体控件,则选择这些控件可让用户进入一个允许暂停播放的屏幕。 | |
| TV-PN | 为继续观看而添加的内容项应遵循应用开发者指南。 | |
| 媒体播放 | TV-PC | 在播放视频或音频时,按方向键中间的按钮后会暂停正在播放的媒体。在暂停播放时,按方向键中间的按钮会恢复播放。方向键中的向左和向右按钮分别用于快进和快退当前曲目。如需了解详情,请参阅媒体事件。 |
| TV-PP | 如果应用播放视频或音乐内容,当播放期间发送了播放或暂停关键事件时,应用在媒体播放和暂停之间切换。如需了解详情,请参阅 KEYCODE_MEDIA_PLAY_PAUSE。 |
|
| 氛围模式 | TV-BU | 当用户发起主动播放视频时,应用会阻止设备进入氛围模式。如需了解详情,请参阅氛围模式。 |
| TV-BY | 当用户未发起主动播放视频或动画时,应用不会阻止设备进入氛围模式。 | |
| TV-BA | 在仅播放音频时,应用不会阻止设备进入氛围模式,除非应用会在播放音乐时实现非静态图像(例如,音乐视频或图像)体验。 | |
| 画中画 | TV-IC | 如果应用使用画中画,则会设置适当的元数据,以将其画中画使用情况归类为允许的使用类型之一。它还会声明一个标题和副标题,准确表示此画中画的用途。如需了解详情,请参阅在 TV 上执行多任务。 |
| TV-IP | 在画中画模式下,应用不会显示并非内容来源固有部分的宣传材料或广告。 | |
| TV-IQ | 在画中画模式下,应用不会降低另一个全屏 activity 的体验。应用不应使用过多资源、占用音频焦点、干扰活跃的 MediaSession 或请求过多的解码器会话。 | |
| TV-IH | 在画中画模式下,应用不会显示任何界面控件或可导航元素。应用可能会直接在画中画窗口中公开某些用户控件。 | |
| TV-IE | 进入画中画模式需要用户在应用内执行明确且有意的操作。除非用户正在通话,否则应用不会自动进入画中画模式(setAutoEnterEnabled 设置为 false)。 |
|
| TV-IS | 如果设备上停用了画中画模式,应用不得显示任何用于进入画中画模式的界面。 | |
| TV-IX | 应用仅将画中画模式用于继续进行中的 activity。画中画体验不会激励或鼓励用户在进行中的 activity 期间或结束后返回应用的全屏视图。 | |
| 内存 | TV-ME | 对于低 RAM 设备(其中 ActivityManager.isLowRamDevice() 返回 true),前台应用的最大内存用量(匿名 + 交换空间 + 图形 + 文件内存)必须保持在 优化内存用量 中定义的限制范围内(包括具体测量机制和注意事项)。 |
| Google Play | TV-G1 | 在 Google Play 商店中发布的所有新 TV 应用和现有 TV 应用都必须使用 Android App Bundle。 |
| TV-G2 | 应用必须遵循 Play 开发者政策中心的要求。 | |
| TV-G6 | 自 2026 年 8 月 1 日起,TV 应用必须同时支持 32 位和 64 位架构,并符合 16 KB 页面大小 要求。 | |
| 应用详情页面 | TV-G3 | 应用功能符合预期或符合应用在 Google Play 商店商品详情中的描述。 |
| TV-G4 | 应用提交内容已上传至少一张未经修改的高分辨率屏幕截图,其中准确地展示了 TV 应用体验的当前版本。 | |
| 登录凭证 | TV-G5 | 对于需要用户登录的应用,您必须在 Google Play 管理中心内提供登录凭证,以便测试完整的应用体验。如需了解详情,请参阅准备应用以供审核中的应用访问权限。 |
第 2 层级 - 针对 TV 进行了优化
| 类型 | 测试 | 说明 |
|---|---|---|
| 性能 | TV-BP | 应用包含基准配置文件,以提高整体性能,例如应用启动速度和减少卡顿。 |
| 界面 | TV-4K | 应用通过在应用内提供高分辨率资源(包括应用图标、横幅、内容卡片和应用中的其他资源)来兼容 4K。 |
| 连接 | TV-CT | 如果应用有支持 Cast 的移动版,则 TV 应用会与 TV Cast 接收器 (Cast Connect) 集成,以允许用户将手机或平板电脑中的内容投射到 TV 上。 |
| 登录 | TV-LI | 登录界面:用户可以使用移动账号或 Google 账号登录,实现无缝登录。 |
| TV-LC | 应用会安全地存储用户凭证,或通过基于令牌的身份验证或安全存储方法自动登录回访用户。这大大减少了初始设置后后续使用的摩擦。 | |
| 语音 | TV-VS | 应用集成了语音搜索功能,可用于自然语言内容发现。集成有助于用户输入搜索查询,而无需使用软件键盘,尤其是在应用使用不支持语音输入的自定义键盘的情况下。例如,应用可以启用 Gboard 进行语音输入,或在搜索文本字段旁边提供麦克风按钮来触发语音识别。 |
| TV-VC | 应用通过 实现 MediaSession集成了用于播放和导航的语音命令。 |
|
| 游戏控制器 | TV-GF | 游戏完全支持实体游戏控制器和虚拟游戏手柄。 |
第 1 层级 - 针对 TV 提供差异化体验
| 类型 | 测试 | 说明 |
|---|---|---|
| 互动 | TV-EC | 应用通过 Engage SDK 提交内容实体类型,供用户继续观看,例如继续观看中断的电影或观看连续剧的下一集。 |
| TV-ER | 应用提交相关内容实体类型,以通过 Engage SDK 显示推荐内容。 | |
| 设备功能 | TV-PI | 应用为相关内容选择 TV 的预设图片配置文件(电影选择影院配置文件,直播体育赛事或游戏选择低延迟 / 高对比度) |
| TV-AO | 应用通过为支持的输出设备选择最佳音频通道(例如耳机选择立体声通道,环绕扬声器选择 5.1)来无缝响应音频输出切换 | |
| TV-FR | 应用支持请求内容的帧速率,以便显示屏可以切换到正确的播放模式并避免抖动(例如,50 fps 内容选择 50 Hz) | |
| TV-TO | 应用支持触摸和点击,以实现与指针遥控器和触摸屏显示器的兼容性。当光标位于可交互的组件上方时,界面组件会显示悬停状态;组件可以点击,可滚动容器可以垂直和水平滚动。 | |
| TV-SA | 应用支持空间音频,以提供沉浸式聆听体验。例如,应用可以使用 IAMF 编解码器。 | |
| 无障碍 | TV-AX | 应用实现了增强的无障碍选项,例如音频说明、字幕显示(包括首选字幕样式和高对比度模式)、常规高对比度界面模式、简化的导航模式和可调节的播放速度。这体现了对包容性的坚定承诺,确保为所有人提供优质、无障碍且令人愉悦的体验。 |
| AI | TV-AI | 应用实现了具有 AppFunctions 或应用内 AI 的体验。 |
常见问题解答
在提交我的应用后,如何发现应用是否符合电视设备的所有要求?
如果您的应用不符合本页所述的易用性要求, Play 商店团队将通过与应用关联的 Google Play 管理中心账号中指定的电子邮件地址与您联系。
我的应用不仅仅是以电视设备为目标。如果我的应用不符合电视设备应用的要求,是否仍会在 Google Play 上针对其他设备显示我的新应用或更新版本?
只有在所有更改获得批准后,才能发布对 Google Play 商品详情的更新。如果特定于外形规格的工件的更新阻止了对其他设备(例如手机或平板电脑)的商品详情的进一步更新,您可能需要移除该工件,方法是将其替换为空提交内容,直到您可以满足要求为止。
如果我的应用符合这些发布要求,何时才能在电视设备的 Google Play 商店中上架?
符合电视要求的应用将立即出现在电视设备的 Play 商店上。
变更说明
2026 年 5 月
- TV 应用质量层级
- 添加了“针对 TV 进行了优化”(第 2 层级)和“针对 TV 提供差异化体验”(第 1 层级)质量标准,以阐明超出最低提交要求(第 3 层级)的优质 TV 体验。
搜索
Play 政策
移除了标准
TV-G7并更新了标准 TV-G6:将 16 KB 页面大小纳入 64 位要求。
2026 年 1 月
Play 政策
新标准
TV-G6:自 2026 年 8 月 1 日起,您的应用必须 支持 64 位架构。
新标准
TV-G7:自 2026 年 8 月 1 日起,您的应用必须 支持 16 KB 页面大小。
2025 年 12 月
预期性能
新标准
TV-PS:除了 核心性能和稳定性要求之外,您的 应用还必须通过将最低 Android SDK 版本设置为 31 或更低版本来支持常用 Android TV 设备。
2024 年 11 月
功能和性能
新标准
TV-ME:对于低 RAM 设备(其中
ActivityManager.isLowRamDevice()返回true), 前台应用的最大内存用量(匿名 + 交换空间 + 图形 + 文件内存)必须保持在优化内存 用量中定义的限制范围内(包括具体 测量机制和注意事项)。
2024 年 5 月
媒体播放
更新后的标准
TV-NP:该标准已更新为仅适用于音频 播放,而不适用于视频。我们现在还建议在应用处于后台时暂停视频。