影片節目的屬性取決於內容類型。節目類型會告知系統預期的中繼資料,以便適當填入 UI。
影片節目可以是下列其中一種類型:
使用 PreviewProgram.Builder 建構程式。如要進一步瞭解各欄位的可能值,請參閱建構工具中各 setter 的參考文件。
val program = 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 | ✔ | ✔ | ✔ | (✔) | |||
| Episode Number | ✔ | ||||||
| Episode Title | (✔) | ||||||
| 類型 | (✔) | (✔) | (✔) | (✔) | |||
| 意圖 URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| 互動次數 | (✔) | (✔) | |||||
| 互動類型 | (✔) | (✔) | |||||
| 內部供應商 ID | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 項目數量 | (✔) | (✔) | |||||
| Live | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| 標誌 URI (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 標誌內容說明 (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 優惠價格 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 海報圖片顯示比例 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| 海報圖片 URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| 預覽影片 URI | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 發布日期 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| 評論評分 | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| 評論評分樣式 | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| 季別顯示編號 | ✔ | ✔ | |||||
| Short Description | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Start Time UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| End Time UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| 起始價格 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 縮圖顯示比例 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| 縮圖 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 指定確切的預覽影片大小。