在主畫面上推薦內容

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 建立的頻道時的畫面。 如果應用程式建立了 預設版本、 或之後使用者選取及新增任何由您的應用程式建立的管道。

，瞭解如何調查及移除這項存取權。

注意： 這項前瞻相容行為只是暫時性措施，我們會稍後再移除。 為確保相容性，最佳做法是 API (如上所述)。