在主畫面上推薦內容

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 以下版本編譯,仍可在等級 26 的 Android TV 上執行。舊的推薦行為具有前瞻相容性,但會受到限制:

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