影片節目屬性

影片節目的屬性取決於內容類型。程式類型會告知系統預期的中繼資料,以便正確填入 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_WIDTHVIDEO_HEIGHT 指定確切的預覽影片大小。