影片節目屬性

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