Merekomendasikan konten di layar utama

Layar utama Android TV menampilkan konten yang direkomendasikan menggunakan saluran dan program kami. Saluran ditampilkan sebagai baris tersendiri di layar beranda, dengan kartu yang menampilkan semua program yang tersedia untuk saluran tersebut.

Aplikasi Anda harus memiliki setidaknya satu saluran. Channel pertama Anda dibuat oleh aplikasi Anda menjadi saluran default, dan Android TV menampilkan saluran tersebut secara otomatis di layar utama. Aplikasi Anda dapat menawarkan saluran lain, tetapi pengguna harus memilih dan menyetujui saluran tersebut sebelum mereka ditambahkan ke layar utama.

Jika aplikasi Anda menampilkan acara TV, film, atau konten video lainnya, sebaiknya Anda mendukung pratinjau video dan terintegrasi dengan saluran Tonton Berikutnya. Saluran Watch Next dikendalikan oleh sistem Android. Aplikasi Anda dapat menambahkan program terkait pengguna ke saluran ini, seperti program yang ditandai pengguna sebagai menarik, berhenti menonton di tengah jalan, atau yang terkait dengan konten yang ditonton pengguna (seperti episode berikutnya dalam serial atau season berikutnya acara TV).

Memastikan kompatibilitas

Layar utama menampilkan rekomendasi dua cara berbeda bergantung pada versi Android:

• Di Android 8.0 (API level 26) dan yang lebih baru, aplikasi dapat menampilkan rekomendasi dalam satu atau saluran lainnya yang muncul pada baris terpisah. Satu saluran (saluran default) selalu muncul. Pengguna dapat menemukan dan menambahkan saluran lain ke rumah mereka layar. Pelajari cara membuat saluran rekomendasi di layar beranda.
• Sebelum Android 8.0, Android TV menampilkan semua rekomendasi dalam satu baris rekomendasi yang selalu muncul di layar. Pelajari cara membuat baris rekomendasi di beranda layar.

Agar dapat menampilkan rekomendasi di semua versi Android TV, aplikasi Anda harus menerapkan kedua API rekomendasi. Menguji level API sistem saat ini dan menggunakan API yang sesuai untuk membuat baris atau saluran rekomendasi.

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row 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
}

Jika aplikasi Anda dikompilasi menggunakan API level 25 atau yang lebih lama, aplikasi masih dapat berjalan di Android TV di level 26. Perilaku rekomendasi lama kompatibel dengan versi yang lebih baru, tetapi dibatasi:

• Baris rekomendasi secara otomatis dikonversi dan muncul sebagai pada layar beranda.
• Program di saluran yang dikonversi merespons pembaruan dari layanan rekomendasi, tetapi pengguna tidak dapat menggunakan UI TV untuk memanipulasi program di saluran (tambahkan/hapus program, salin program ke saluran Tonton Berikutnya).
• Jika Anda mengupdate aplikasi ke level API 26, saluran yang dikonversi masih muncul di TV yang menjalankan API 26. TV akan menghapus saluran yang dikonversi dari layar saat pertama kali aplikasi Anda menampilkan saluran yang dibuat dengan API baru. Hal ini langsung terjadi jika aplikasi membuat channel default, atau nanti ketika pengguna memilih dan menambahkan saluran lain yang dibuat oleh aplikasi Anda.