Bergabunglah bersama kami di ⁠#Android11: The Beta Launch Show pada tanggal 3 Juni!

Merekomendasikan konten di layar utama

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

Aplikasi Anda harus memiliki setidaknya satu saluran. Saluran pertama yang dibuat aplikasi Anda akan menjadi saluran default, dan Android TV akan otomatis menampilkannya di layar utama. Aplikasi Anda dapat menawarkan saluran lain, tetapi pengguna harus memilih dan menyetujui saluran tersebut sebelum ditambahkan ke layar utama.

Jika aplikasi Anda menampilkan acara TV, film, atau konten video lainnya, sebaiknya Anda mendukung pratinjau video dan berintegrasi dengan saluran Watch Next. 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-tengah, atau yang terkait dengan konten yang sedang ditonton pengguna (seperti episode berikutnya dalam sebuah seri atau season berikutnya dari sebuah acara).

Memastikan kompatibilitas

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

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

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

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
    }
    

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

  • Baris rekomendasi otomatis dikonversi dan muncul sebagai saluran baru di layar utama.
  • Program-program di saluran yang dikonversi merespons update dari layanan rekomendasi Anda, tetapi pengguna tidak dapat menggunakan UI TV untuk memanipulasi program-program di saluran tersebut (menambah/menghapus program, menyalin program ke saluran Watch Next).
  • Jika Anda mengupdate aplikasi ke API level 26, saluran yang dikonversi akan tetap 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 saluran default, atau nanti ketika pengguna memilih dan menambahkan saluran lain yang dibuat oleh aplikasi Anda.