电视应用质量

与使用手机或平板电脑时相比,用户在观看电视时有不同的期望。典型的电视用户距离屏幕约 10 英尺,因此细微的细节不太明显,小字也难以阅读。由于用户坐在远离电视的地方,因此他们必须使用遥控设备进行导航和选择,而不是触摸屏幕上的元素。这些差异会极大地影响良好电视用户体验的要求。

创建出色的电视用户体验的第一步是查看并遵循Android TV 设计指南。要了解电视应用的基本实施要求,还可以查看构建电视应用培训。

有关如何在 Google Play 中发布电视应用的信息,请参阅分发到 Android TV

视觉设计和用户交互

以下标准有助于确保您的应用遵循关键的设计和交互模式,以便在电视设备上提供一致、直观且愉悦的用户体验。

类型 测试 描述
启动器 TV-LM

安装后,应用在 Android TV 启动器中显示启动器图标。有关更多信息,请参阅声明电视活动

TV-LB

应用在 Android TV 启动器中显示 320x180 像素的全尺寸横幅和至少 160x160 像素(在xhdpi密度下)的应用图标作为其启动器图标。有关更多信息,请参阅Android TV 应用图标和横幅指南

TV-BN

应用启动横幅包含应用的名称。

TV-LG

如果应用是游戏,则它会显示在 Android TV 启动器中的“游戏”行中。
有关更多信息,请参阅在主屏幕上显示您的游戏

TV-LS

应用能够成功运行且没有任何错误消息,包括安装、加载和测试期间。有关更多信息,请参阅运行电视应用

布局 TV-LO

所有应用界面均以横向显示,且没有垂直的信箱/枕盒。原始格式视频的条形只能使用黑色。有关更多信息,请参阅构建基本电视布局

TV-OV

应用不会显示任何被屏幕边缘部分遮挡的文字或功能。有关更多信息,请参阅超扫描

TV-TR

应用不会部分遮挡其他应用。应用填充整个屏幕并具有不透明的背景。

TV-DP

应用功能可以使用五向 D 形方向键进行导航,除非应用需要游戏控制器(如以下“功能”表中“控制器”部分的 TV-GP 标准中所述)。有关更多信息,请参阅电视导航

TV-DK

如果应用需要游戏控制器(如 TV-GP 标准中所述),则所有功能都可使用标准 Android 游戏控制器按键进行导航。有关更多信息,请参阅处理游戏手柄按钮按下操作

TV-DM

应用不依赖于遥控设备具有“菜单”按钮来访问用户界面控件。

TV-DB

按下“返回”按钮将返回到 Android TV 主屏幕。有关更多信息,请参阅提供适当的“返回”按钮行为

TV-DL

如果应用在“直播”选项卡中集成了直播电视源,则该应用满足无摩擦播放和直接返回要求。有关更多信息,请参阅返回按钮

TV-SB

应用内搜索查询显示在搜索框中,类似于SearchFragment提供的用户界面,结果与该查询相关。有关更多信息,请参阅电视应用内的搜索

功能

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

类型 测试 描述
清单 TV-ML

应用清单设置了 ACTION_MAIN 类型的意图,并将其类别设置为 CATEGORY_LEANBACK_LAUNCHER。有关更多信息,请参阅 声明 TV 活动

TV-MT

应用清单将硬件特性 android.hardware.touchscreen 及“声明 TV 的硬件需求”中列出的其他特性设置为非必需。有关更多信息,请参阅 声明 TV 的硬件需求

游戏控制器 TV-GP

如果应用使用游戏控制器作为其主要输入方法,则会使用 <uses-feature> 清单标签声明相应的需求。有关更多信息,请参阅 声明对游戏控制器的支持

TV-GC

如果应用提供有关如何使用游戏控制器的视觉说明,则这些说明不包含品牌标识,并显示兼容的按钮布局。有关更多信息,请参阅 处理游戏的控制器

广告 TV-AP

应用提供使用方向键控制与广告交互的功能。有关更多信息,请参阅 启用方向键导航

TV-AD

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

TV-AU

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

TV-AA

对于使用可点击的、非全屏的、非视频的广告,应用不允许广告链接到 TV 设备上不可用的其他应用。

网页内容 TV-WB

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

媒体播放 TV-NP

如果应用在用户返回主屏幕或切换到其他应用后继续播放音频,则应用会在主屏幕推荐栏上提供“正在播放”卡片,以便用户可以返回应用以控制播放。有关更多信息,请参阅 显示“正在播放”卡片

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

TV-PA

如果应用提供“正在播放”卡片,则选择此卡片会将用户带到一个屏幕,允许他们暂停播放。

TV-PP

如果应用播放视频或音乐内容,则在播放过程中发送播放或暂停键事件时,应用会在媒体播放的播放和暂停之间切换。有关更多信息,请参阅 KEYCODE_MEDIA_PLAY_PAUSE

TV-PC

在播放视频或音频时,按下方向键中心按钮会暂停正在播放的媒体。暂停播放时,按下方向键中心按钮会恢复播放。方向键左右按钮分别快进和倒回当前曲目。有关更多信息,请参阅 媒体事件

TV-PN

项目会根据 应用开发者观看下一集指南 添加到“观看下一集”频道。

环境模式 TV-BU

当有用户发起的主动视频播放时,应用会阻止设备进入环境模式。有关更多信息,请参阅 环境模式

TV-BY

当没有用户发起的主动视频播放或动画时,应用不会阻止设备进入环境模式。

TV-BA

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

Google Play

请遵循以下要求,以确保您的应用与 Google Play 上的其他列表和分类保持一致。

类型 测试 描述
画中画 TV-IC

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

有关更多信息,请参阅 TV 上的多任务处理

TV-IP

在画中画模式下,应用不会显示不属于内容源本身的促销材料或广告。

TV-IQ

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

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

TV-IH

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

TV-IE

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

TV-IS

如果设备上禁用了画中画模式,则应用不得显示任何进入 PiP 的 UI。有关更多信息,请参阅 画中画模式的最佳实践

TV-IX

应用仅将画中画模式用于正在进行的活动的延续。画中画体验不会激励或鼓励用户在活动进行期间或活动结束后返回应用的全屏视图。

播放政策 TV-G1

对于 Google Play 商店中的所有新 TV 应用和现有 TV 应用,都必须使用 Android 应用包

TV-G2

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

应用详情页面 TV-G3

应用功能按预期或应用的 Google Play 商店列表中所述的方式工作。

TV-G4

应用提交已上传至少一个未经修改的高分辨率屏幕截图,该截图准确地描绘了您当前版本的 TV 应用体验。

登录凭据 TV-G5

对于具有付费功能的应用,您必须在 Google Play Console 中提供登录凭据,以便测试完整的应用体验。有关更多信息,请参阅 准备应用以供审核中的应用访问

常见问题

提交应用后,如何才能知道应用是否不满足 TV 设备的所有要求?

如果您的应用不满足此页面上描述的可用性要求,Play 商店团队将通过与应用关联的 Google Play Console 帐户中指定的电子邮件地址与您联系。

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

我的应用的目标不仅仅是 TV 设备,还包括其他外形规格。如果我的应用不满足 TV 设备的要求,我的新应用或更新的应用是否仍会显示在其他设备的 Google Play 上?

只有在批准所有更改后,才能发布 Google Play 商店列表的更新。如果特定于外形规格的工件的更新阻止了您对其他设备(如手机或平板电脑)的列表进行进一步更新,则您可能需要通过用空提交替换该工件来将其删除,直到您可以满足要求为止。

如果我的应用满足发布要求,它何时会在 TV 设备上的 Google Play 商店中可用?

满足 TV 要求的应用将立即出现在 TV 设备上的 Play 商店中。