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 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, atau yang terkait dengan konten yang ditonton pengguna (seperti episode berikutnya dalam sebuah serial atau season berikutnya dari sebuah acara).
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 di satu atau beberapa saluran yang muncul di baris terpisah. Satu saluran (saluran default) selalu muncul. Pengguna dapat menemukan dan menambahkan saluran lain ke layar utama mereka. 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 mengimplementasikan 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 di saluran yang dikonversi merespons update dari layanan rekomendasi Anda, tetapi pengguna tidak dapat menggunakan UI TV untuk memanipulasi program di saluran (menambah/menghapus program, menyalin program ke saluran Tonton Berikutnya).
- 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 terjadi langsung jika aplikasi membuat saluran default, atau nanti saat pengguna memilih dan menambahkan saluran lain yang dibuat oleh aplikasi Anda.