视频节目属性

视频节目属性取决于其内容的类型。节目类型告知系统需要什么元数据，以便正确填充界面。视频节目可以是以下类型之一：

使用 PreviewProgram.Builder 制作节目。如需详细了解各个字段可能的值，请参阅构建器上各个 setter 的参考文档。

Kotlin

    val program = PreviewProgram.Builder()
            .setChannelId(channelId)
            .setTitle(clip.getTitle())
            .setDescription(clip.getDescription())
            .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
            // Set required attributes
            .build()

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 中相应 setter 的链接。标有 ✔ 的属性为必需属性，标有 (✔) 的属性为可选属性：

属性 电影 电视连续剧 电视剧季 电视剧集 剪辑 活动 频道
作者 (✔)
适用范围 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
规范类型 (✔)(✔)(✔)(✔)
频道 ID ✔✔ ✔✔ ✔✔✔
Content ID (✔)
内容分级 (✔)(✔) (✔)(✔) (✔)(✔)(✔)
DurationMillis ✔✔✔(✔)
剧集号 ✔
剧集名称 (✔)
类型 (✔)(✔) (✔)(✔)
Intent URI ✔✔ ✔ ✔ ✔✔✔
互动计数 (✔)(✔)
互动类型 (✔)(✔)
内部提供商 ID (✔)(✔)(✔)(✔)(✔)(✔)(✔)
项目计数(✔) (✔)
直播 (✔)(✔)(✔)(✔)(✔)
徽标 URI (*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
徽标内容说明 (*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
优惠价格 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
海报图片宽高比 ✔✔ ✔✔ ✔✔✔
海报图片 URI ✔✔ ✔✔ ✔✔✔
预览视频 URI (✔)(✔)(✔)(✔)(✔)(✔)(✔)
发行日期 (✔)(✔)(✔)(✔)(✔)(✔)
审核评分 (✔)(✔)(✔)(✔)(✔)
审核评分样式 (✔)(✔)(✔)(✔)(✔)
剧季展示编号 ✔ ✔
简短说明 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
开始时间 UTC 毫秒 (*) ✔✔✔✔
结束时间 UTC 毫秒 (*) ✔✔✔✔
起价 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
缩略图宽高比 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
缩略图 URI (✔)(✔)(✔)(✔)(✔)(✔)(✔)
标题 ✔✔ ✔✔ ✔✔✔
视频高度 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
视频宽度 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
重量 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
预览图片

建议的预览图片尺寸为：

属性 宽高比 宽度 高度
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 指定确切的预览视频尺寸。

上一页
主屏幕上的频道
下一页
音频节目属性