在主畫面上推薦內容

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

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

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

確保相容性

主畫面會根據 Android 版本，以兩種不同方式顯示推薦內容：

• 在 Android 8.0 (API 級別 26) 以上版本中，應用程式可以在一或多個管道中顯示推薦內容，並分列顯示。系統一律會顯示一個管道 (預設管道)。使用者可以探索其他頻道，並將其新增至主畫面。瞭解如何在主畫面上建立推薦頻道。
• 在 Android 8.0 之前，Android TV 會在螢幕上顯示一列推薦內容。瞭解如何在主畫面上建立推薦列。

如要在所有版本的 Android TV 上顯示推薦內容，應用程式應同時導入這兩種推薦內容 API。測試目前的系統 API 級別，並使用適當的 API 建構推薦資料列或頻道。

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

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

• 推薦內容列會自動轉換，並在主畫面上顯示為新頻道。
• 轉換後的頻道節目會回應推薦服務的更新，但使用者無法透過電視的使用者介面操控頻道節目 (新增/移除節目、將節目複製到「接著看」頻道)。
• 如果您將應用程式更新至 API 級別 26，轉換後的頻道仍會顯示在搭載 API 26 的電視上。當應用程式首次顯示使用新 API 建立的頻道時，電視會從螢幕上移除轉換後的頻道。如果應用程式建立預設頻道，系統會立即執行這項操作；如果使用者選取並新增應用程式建立的其他頻道，系統則會在稍後執行這項操作。