影片節目的屬性取決於內容類型。節目類型會告知系統應預期哪些中繼資料，以便適當填入使用者介面。
影片節目可以是下列其中一種類型：
使用 PreviewProgram.Builder 建構程式。如要進一步瞭解每個欄位的可能值，請參閱建構工具中各個設定器的參考文件。
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。標有 ✔ 的屬性為必填，標有 (✔) 的屬性則為選填。
| 屬性 | 電影 | 電視影集 | 整季電視劇集 | 電視劇集 | 剪輯片段 | 事件 | 頻道 |
|---|---|---|---|---|---|---|---|
| Author | (✔) | ||||||
| 適用地區 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 規範類型 | (✔) | (✔) | (✔) | (✔) | |||
| 頻道 ID | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Content ID | (✔) | ||||||
| 內容分級 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| DurationMillis | ✔ | ✔ | ✔ | (✔) | |||
| 劇集編號 | ✔ | ||||||
| 劇集名稱 | (✔) | ||||||
| 類型 | (✔) | (✔) | (✔) | (✔) | |||
| Intent URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| 互動次數 | (✔) | (✔) | |||||
| 互動類型 | (✔) | (✔) | |||||
| 內部供應商 ID | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 項目數量 | (✔) | (✔) | |||||
| Live | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| 標誌 URI (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 標誌內容說明 (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 優惠價格 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 海報圖片顯示比例 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| 海報圖片 URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| 預覽影片 URI | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 發布日期 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| 評論評分 | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| 評論評分樣式 | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| 季別顯示編號 | ✔ | ✔ | |||||
| Short Description | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 開始時間 (世界標準時間，以毫秒為單位) (*) | ✔ | ✔ | ✔ | ✔ | |||
| UTC 結束時間毫秒數 (*) | ✔ | ✔ | ✔ | ✔ | |||
| 起始價格 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 縮圖顯示比例 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 縮圖 URI | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 標題 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| 影片高度 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 影片寬度 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 重量 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
預覽圖片
預覽圖的建議尺寸如下：
| 屬性 | 顯示比例 | 寬度 | 高度 |
ASPECT_RATIO_16_9 |
16:9 | 272 dp | 153 dp |
ASPECT_RATIO_3_2 |
3:2 | 229.5 dp | 153 dp |
ASPECT_RATIO_4_3 |
4:3 | 204 dp | 153 dp |
ASPECT_RATIO_1_1 |
1:1 | 153 dp | 153 dp |
ASPECT_RATIO_2_3 |
2:3 | 102 dp | 153 dp |
ASPECT_RATIO_MOVIE_POSTER |
1:1.441 | 106 dp | 153 dp |
為獲得最佳畫質，請使用顯示比例為 16:9 或 4:3 的預覽影片，且影片大小至少須符合下表規定。使用不透明的標誌，提供最佳使用者體驗。
您可以使用 VIDEO_WIDTH 和 VIDEO_HEIGHT 指定確切的預覽影片尺寸。