音频节目的属性取决于内容的类型。节目类型告知系统需要什么元数据,以便正确填充界面。音频节目可以是以下类型之一:
使用 PreviewProgram.Builder
构建节目。如需详细了解各个字段可能的值,请参阅构建器上各个 setter 对应的 Java 文档。
以下示例展示了如何使用 PreviewProgram.Builder
:
PreviewProgram program = new PreviewProgram.Builder()
.setChannelId(channelId)
.setTitle(clip.getTitle())
.setDescription(clip.getDescription())
.setType(TvContractCompat.PreviewPrograms.TYPE_ALBUM)
// Set required attributes
.build();
下表显示可分配给每种类型的音频节目的属性,以及指向 PreviewProgram.Builder
中相应 setter 的链接。标有 ✔ 的属性为必需属性,标有 (✔) 的属性为可选属性。
属性 | 曲目 | 专辑 | 音乐人 | 播放列表 | 电台 |
---|---|---|---|---|---|
作者: | (✔) | (✔) | (✔) | ||
适用范围 | (✔) | (✔) | (✔) | (✔) | (✔) |
频道 ID | ✔ | ✔ | ✔ | ✔ | ✔ |
Content ID | (✔) | (✔) | (✔) | (✔) | (✔) |
时长 | ✔ | ||||
类型 | (✔) | (✔) | (✔) | (✔) | (✔) |
Intent URI | ✔ | ✔ | ✔ | ✔ | ✔ |
互动计数 | (✔) | (✔) | (✔) | ||
互动类型 | (✔) | (✔) | (✔) | ||
内部提供商 ID | (✔) | (✔) | (✔) | (✔) | (✔) |
直播 | (✔) | ||||
徽标 URI (*) | (✔) | ||||
徽标内容说明 (*) | (✔) | ||||
优惠价格 | (✔) | (✔) | (✔) | (✔) | (✔) |
海报图片宽高比 | ✔ | ✔ | ✔ | ✔ | ✔ |
海报图片 URI | ✔ | ✔ | ✔ | ✔ | ✔ |
预览音频 URI | (✔) | (✔) | (✔) | (✔) | (✔) |
预览视频 URI | (✔) | (✔) | (✔) | (✔) | (✔) |
发行日期 | (✔) | (✔) | |||
简短说明 | (✔) | (✔) | (✔) | (✔) | (✔) |
起价 | (✔) | (✔) | (✔) | (✔) | (✔) |
缩略图宽高比 | (✔) | (✔) | (✔) | (✔) | (✔) |
缩略图 URI | (✔) | (✔) | (✔) | (✔) | (✔) |
标题 | ✔ | ✔ | ✔ | ✔ | ✔ |
视频高度 | (✔) | (✔) | (✔) | (✔) | (✔) |
视频宽度 | (✔) | (✔) | (✔) | (✔) | (✔) |
Weight | (✔) | (✔) | (✔) | (✔) | (✔) |