影片節目的屬性取決於內容類型。程式類型會告知系統預期的中繼資料,以便正確填入 UI。
包括:
使用 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 | ✔ | ✔ | ✔ | (✔) | |||
集別 | ✔ | ||||||
劇集標題 | (✔) | ||||||
類型 | (✔) | (✔) | (✔) | (✔) | |||
意圖 URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
互動次數 | (✔) | (✔) | |||||
互動類型 | (✔) | (✔) | |||||
內部供應商 ID | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
項目數量 | (✔) | (✔) | |||||
即時影像 | (✔) | (✔) | (✔) | (✔) | (✔) | ||
標誌 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
指定確切的預覽影片大小。