电视应用质量

与使用手机或平板电脑相比,用户在观看电视时的期望有所不同。典型的电视用户距离屏幕约 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活动

电视-MT

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

游戏控制器 电视-GP

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

电视-GC

如果应用提供使用游戏控制器的视觉指导,则这些指导应无品牌标识,并显示兼容的按钮布局。更多信息,请参阅处理游戏控制器

广告 电视-AP

应用使用D-pad控件提供与广告的交互。更多信息,请参阅启用D-pad导航

电视-AD

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

电视-AU

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

电视-AA

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

网页内容 电视-WB

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

媒体播放 电视-NP

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

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

电视-PA

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

电视-PP

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

电视-PC

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

电视-PN

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

环境模式 电视-BU

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

电视-BY

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

电视-BA

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

Google Play

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

类型 测试 描述
画中画 电视-IC

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

更多信息,请参阅电视上的多任务处理

电视-IP

在画中画模式下,应用不会显示并非内容来源固有部分的促销材料或广告。

电视-IQ

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

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

电视-IH

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

电视-IE

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

电视-IS

如果设备上禁用了画中画模式,应用不得显示任何用于进入PiP的UI。

电视-IX

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

播放政策 电视-G1

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

电视-G2

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

应用详情页面 电视-G3

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

电视-G4

应用提交已上传至少一张未经修改的高分辨率屏幕截图,准确地描绘了您当前版本的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商店中。