视频节目的属性取决于其内容的类型。 程序类型告诉系统什么元数据期望,以便UI可以适当填写。 视频节目可以是以下类型之一:
使用PreviewProgram.Builder来构建一个程序。 您可以阅读关于构建器上每个设置器的java文档中每个字段的可能值的更多信息。
PreviewProgram program = new PreviewProgram.Builder() .setChannelId(channelId) .setTitle(clip.getTitle()) .setDescription(clip.getDescription()) .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE) // Set required attributes .build();
下表显示了可以分配给每种类型视频节目的属性,并链接到PreviewProgram.Builder中相应的设置器。 标有✔的属性是必需的,标有(✔)的属性是可选的:
属性 | 电影 | 电视剧 | 电视季节 | 电视剧集 | 夹 | 事件 | 渠道 |
---|---|---|---|---|---|---|---|
作者 | (✔) | ||||||
可用性 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
规范流派 | (✔) | (✔) | (✔) | (✔) | |||
频道ID | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
内容ID | (✔) | ||||||
内容评级 | ✔ | ✔ | ✔ | ✔ | (✔) | (✔) | (✔) |
DurationMillis | ✔ | ✔ | ✔ | (✔) | |||
插曲编号 | ✔ | ||||||
情节标题 | (✔) | ||||||
类型 | (✔) | (✔) | (✔) | (✔) | |||
意图URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
互动计数 | (✔) | (✔) | |||||
交互类型 | (✔) | (✔) | |||||
内部提供商ID | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
项目数量 | (✔) | (✔) | |||||
生活 | (✔) | (✔) | (✔) | (✔) | (✔) | ||
Logo URI(*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
标识内容说明(*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
优惠价格 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
海报艺术长宽比 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
海报艺术URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
预览视频URI | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
发布日期 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
评论评级 | (✔) | (✔) | (✔) | (✔) | (✔) | ||
评论评分风格 | (✔) | (✔) | (✔) | (✔) | (✔) | ||
季节显示号码 | ✔ | ✔ | |||||
简短的介绍 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
开始时间UTC Millis(*) | ✔ | ✔ | ✔ | ✔ | |||
结束时间UTC Millis(*) | ✔ | ✔ | ✔ | ✔ | |||
起始价 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
缩略图长宽比 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
缩略图URI | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
标题 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
视频高度 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
视频宽度 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
重量 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
(*)注释:
当LIVE属性为true
时,仅在屏幕上显示START / END时间。
使用LOGO_URI时需要LOGO_CONTENT_DESCRIPTION。
预览图像
预览图像的建议尺寸为:
属性 | 纵横比 | 宽度 | 高度 |
ASPECT_RATIO_16_9 | 16:9 | 272dp | 153dp |
ASPECT_RATIO_3_2 | 3:2 | 229.5dp | 153dp |
ASPECT_RATIO_4_3 | 4:3 | 204dp | 153dp |
ASPECT_RATIO_1_1 | 1:1 | 153dp | 153dp |
ASPECT_RATIO_2_3 | 2:3 | 102dp | 153dp |
ASPECT_RATIO_MOVIE_POSTER | 1:1.441 | 106dp | 153dp |
为了获得最佳质量,预览视频应该是16:9或4:3,并且至少具有上表中指定的大小。 该徽标也应该是不透明的,以获得最佳的用户体验。
您可以使用VIDEO_WIDTH和VIDEO_HEIGHT指定确切的预览视频尺寸。