TV 应用质量

与使用手机或平板电脑相比,用户在看电视时会有不同的期望。典型的电视用户坐在离屏幕约 10 英尺的位置,因此,小细节不太明显,而小号文字也很难看清。由于用户离电视较远,因此必须使用遥控设备来导航和做出选择,而不是轻触屏幕上的元素。这些差异大大影响了提供出色的电视用户体验的要求。

为提供出色的电视用户体验,首先要查阅并遵循 Android TV 设计准则。如需了解电视应用的基本实现要求,请查看构建电视应用培训内容。

如需了解如何在 Google Play 中发布 TV 应用,请参阅分发到 Android 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-OV

应用不会显示被屏幕边缘部分切断的任何文本或功能。如需了解详情,请参阅过扫描

TV-TR

应用不会部分遮住其他应用。应用填充整个屏幕并且采用非透明背景。

TV-DP

应用的功能可使用五向方向键来进行导航,除非此应用需要游戏控制器,如以下“功能”表格的“控制器”部分中的 TV-GP 标准所指定。 如需了解详情,请参阅 TV 导航

TV-DK

如果应用需要 TV-GP 标准中指定的游戏控制器,则所有功能均可使用标准的 Android 游戏控制器按键来进行导航。如需了解详情,请参阅处理游戏手柄按钮按下操作

TV-DM

应用不依赖有菜单按钮的遥控器设备来访问界面控件。

TV-DB

按返回按钮可返回 Android TV 主屏幕。如需了解详情,请参阅提供适当的返回按钮行为

TV-DL

如果应用在“直播”标签页上集成了直播电视 Feed,则该应用需要符合流畅播放和直接返回要求。 如需了解详情,请参阅返回按钮

TV-SB

应用内搜索查询显示在搜索框中,与 SearchFragment 提供的界面相似,且结果与该查询相关。如需了解详情,请参阅在 TV 应用内搜索

功能和性能

遵循这些标准能够确保应用配置正确,并提供预期的功能行为。

类型 测试 说明
SDK TV-PS 除了核心性能和稳定性要求之外,应用还通过将 minSdkVersion 值设置为 31 或更低值来声明支持常用的 Android TV 设备,从而设置最低 Android SDK 版本
清单 TV-ML

应用清单会设置一个类别为 CATEGORY_LEANBACK_LAUNCHER 的 Intent 类型 ACTION_MAIN。如需了解详情,请参阅声明 TV activity

TV-MT

应用清单会将硬件功能 android.hardware.touchscreen 和“声明 TV 的硬件要求”中列出的其他功能设置为非必需功能。如需了解详情,请参阅为电视声明硬件要求

游戏控制器 TV-GP

如果应用使用游戏控制器作为主要输入法,则通过 <uses-feature> 清单标记来声明相应的要求。如需了解详情,请参阅声明对游戏控制器的支持

TV-GC

如果应用提供了有关使用游戏控制器的直观说明,该说明不含品牌信息,并且显示兼容的按钮布局。如需了解详情,请参阅处理游戏控制器

广告 TV-AP

应用支持使用方向键控制器与广告进行互动。 如需了解详情,请参阅启用方向键导航

TV-AD

对于非视频全屏广告,应用允许用户立即用方向键或游戏手柄控制器关闭广告。

TV-AU

对于可点击的非全屏、非视频广告,应用不允许将广告链接到网址。

TV-AA

对于可点击的非全屏、非视频广告,应用不允许广告链接到电视设备上不可用的另一个应用。

网络内容 TV-WB

对于网络内容,应用可能仅使用 WebView 组件。应用不得尝试启动网络浏览器应用。

媒体播放 TV-NP

如果应用在用户返回主屏幕或切换到其他应用后继续播放音频,则需在主屏幕建议行上提供“正在播放”卡,以便用户返回该应用来控制播放。如需了解详情,请参阅显示“闻曲知音”卡片

我们建议您在用户切换出应用时暂停视频,并且不要将视频与正在播放卡片集成。

TV-PA

如果应用提供“正在播放”卡,则选择此卡可让用户进入一个允许暂停播放的界面。

TV-PP

如果应用播放视频或音乐内容,当播放期间发送了播放或暂停键事件时,应用在媒体播放和暂停之间切换。如需了解详情,请参阅 KEYCODE_MEDIA_PLAY_PAUSE

TV-PC

在播放视频或音频时,按方向键中间的按钮会暂停正在播放的媒体。当播放暂停时,按方向键中间的按钮可恢复播放。方向键中的向左和向右按钮分别用于快进和快退当前曲目。 如需了解详情,请参阅媒体事件

TV-PN

系统会根据面向应用开发者的“接下来观看”准则向“接下来观看”频道添加内容。

氛围模式 TV-BU

当用户发起主动播放视频时,应用会阻止设备进入氛围模式。 如需了解详情,请参阅环境模式

TV-BY

当用户未发起主动播放视频或动画时,应用不会阻止设备进入氛围模式。

TV-BA

在仅播放音频时,应用不会阻止设备进入氛围模式,除非应用会在播放音乐时实现非静态图像(例如,音乐视频或图像)体验。

内存
TV-ME

对于低 RAM 设备(其中 ActivityManager.isLowRamDevice() 返回 true),前台应用的最大内存使用量(匿名内存 + 交换内存 + 图形内存 + 文件内存)必须保持在优化内存使用量中定义的限制范围内(包括特定的衡量机制和注意事项)。

Google Play

请遵循以下要求,确保您的应用配置与其他 Google Play 商品详情和分类保持一致:

类型 测试 说明
画中画 TV-IC

应用会设置适当的元数据,以将其画中画使用情况归类为允许的使用类型之一。它还声明了准确表示相应 PIP 用途的标题和副标题。

如需了解详情,请参阅在电视上执行多项任务

TV-IP

在画中画模式下,应用不会显示并非内容源本身固有的宣传材料或广告。

TV-IQ

在画中画模式下,应用不会降低其他全屏 activity 的体验。

应用不应使用过多的资源、占用音频焦点、干扰有效的 MediaSession 或请求过多的解码器会话。

TV-IH

应用在画中画模式下不显示任何界面控件或可导航元素。 应用可以直接在画中画窗口中公开某些用户控件

TV-IE

用户必须在应用内执行明确且有意的操作,才能进入画中画模式。除非用户正在通话,否则应用不会自动进入画中画模式(setAutoEnterEnabled 设置为 false)。

TV-IS

如果设备上的画中画模式处于停用状态,应用不得显示任何用于进入画中画模式的界面。

TV-IX

应用仅在继续进行中的活动时使用画中画模式。画中画体验不会激励或鼓励用户在活动进行期间或结束后返回应用的完整屏幕视图。

Play 政策 TV-G1

在 Google Play 商店中发布的所有新 TV 应用和现有 TV 应用都必须使用 Android App Bundle

TV-G2

您的应用必须遵守 Play 开发者政策中心的要求。

应用详情页面 TV-G3

应用功能符合预期或符合应用在 Google Play 商品详情中的描述。

TV-G4

应用提交内容已上传至少一张未经更改的高分辨率屏幕截图,其中准确地展示了电视应用的当前版本。

登录凭据 TV-G5

对于具有付费功能的应用,您必须在 Google Play 管理中心内提供登录凭据,以便我们测试完整的应用体验。 如需了解详情,请参阅准备应用以供审核中的“应用访问权限”。

常见问题解答

在提交我的应用后,如何发现应用是否符合电视设备的所有要求?

如果您的应用不符合本页所述的易用性要求,Play 商店团队将通过与应用关联的 Google Play 管理中心账号中指定的电子邮件地址与您联系。

注意:请确保应用包括电视设备所需的清单条目。否则,我们不会将其视为电视应用,也不会针对电视可用性要求对其进行审核。

我的应用不仅仅是以电视设备为目标设备类型。如果我的应用不符合电视设备应用的要求,是否仍会在 Google Play 上针对其他设备显示我的新应用或更新版本?

只有在所有更改都获得批准后,才能发布 Google Play 商品详情的更新。如果特定于设备规格的制品更新阻止了您的商品详情针对其他设备(例如手机或平板电脑)的进一步更新,您可能需要通过将该制品替换为空提交来移除它,直到您可以满足相关要求为止。

如果我的应用符合这些发布要求,何时才能在电视设备的 Google Play 商店中上架?

符合电视要求的应用将立即出现在电视设备的 Play 商店上。