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 上執行。舊的推薦行為具有前瞻相容性,但會受到限制: