在主畫面上推薦內容

Android TV 主畫面會使用頻道節目顯示推薦內容。頻道會在主畫面上以個別資料列的形式顯示,並透過資訊卡顯示該頻道的所有可用節目。

您的應用程式至少要有一個管道。您應用程式建立的第一個頻道會成為預設頻道,Android TV 會自動在主畫面上顯示該頻道。您的應用程式可以提供其他頻道,但使用者必須選取並核准這些頻道,才能將其新增至主畫面。

如果您的應用程式包含電視節目、電影或其他影片內容,建議您支援影片預覽功能,並與「接下來請看」頻道整合。「接下來請看」頻道是由 Android 系統控制。您的應用程式可在這個頻道中新增使用者相關節目,例如使用者標示為感興趣內容、中途停止觀看的節目,或是與使用者觀看的內容相關的節目 (例如係列的下一集或節目的下一季)。

確保相容性

主畫面會根據 Android 版本,以兩種不同方式顯示建議:

  • 在 Android 8.0 (API 級別 26) 以上版本中,應用程式可透過一或多個管道,在不同的資料列顯示推薦內容。畫面上一律會顯示一個管道 (預設管道)。使用者可以探索其他頻道,並新增至其主畫面。瞭解如何在主畫面上建立推薦管道
  • 在 Android 8.0 之前,Android TV 會在一律顯示於畫面上的單一建議列中顯示所有推薦內容。瞭解如何在主畫面上建立建議列

為了在所有版本的 Android TV 上顯示推薦內容,應用程式應導入這兩個推薦 API。測試目前的系統 API 級別,並使用適當的 API 建構推薦列或管道。

Kotlin

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

Java

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

如果您的應用程式使用 API 級別 25 以下版本編譯,則仍可在 Android TV 級別 26 上執行。舊版建議行為具有前瞻相容性,但受到限制:

  • 建議列會自動轉換,在主畫面上會顯示為新頻道。
  • 轉換版本上的節目會回應推薦服務的更新,但使用者無法使用電視 UI 操控頻道的節目 (新增/移除節目、將節目複製到「接下來請看」頻道)。
  • 如果您將應用程式更新至 API 級別 26,已轉換的頻道仍會顯示在執行 API 26 的電視上。當應用程式首次顯示使用新 API 建立的頻道時,電視會從畫面上移除已轉換的頻道。如果應用程式建立預設管道,或之後使用者選取並新增應用程式建立的任何其他管道時,就會立即發生這種情況。