影片節目的屬性取決於內容類型。方案類型 告知系統預期中繼資料,以便在 UI 中填入內容 才是正確的做法
可收看的節目類型如下:
使用 PreviewProgram.Builder
建構程式。如要進一步瞭解每個 setter 中每個 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
。
標示 ✔ 的屬性為必填項目。標示 (✔) 為選填項目。
屬性 | 電影 | 電視劇集 | 整季電視劇集 | 電視劇集 | 剪輯片段 | 活動 | 頻道 |
---|---|---|---|---|---|---|---|
作者 | (✔) | ||||||
適用範圍 | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
標準化類型 | (✔) | (✔) | (✔) | (✔) | |||
頻道 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
。