Panduan Tonton Berikutnya untuk developer aplikasi

Ikuti panduan ini saat Anda menyisipkan konten ke dalam saluran Tonton Berikutnya.

Jenis konten yang akan disertakan dalam saluran Tonton Berikutnya

Batasi penambahan terprogram aplikasi pada film dan acara TV tradisional. Jangan menambahkan klip dan konten berdurasi singkat lainnya.

Sertakan film yang belum selesai

Tambahkan film yang belum selesai ditonton ke saluran Tonton Berikutnya menggunakan TYPE_MOVIE. Film dianggap belum selesai jika sudah dimulai tetapi belum selesai berdasarkan pedoman berikut:

  • Film dimulai jika pengguna menonton lebih dari 3% atau 2 menit, stempel waktu mana pun yang lebih awal.
  • Film akan selesai jika kredit akhir dimulai. Dalam hal ini, jangan tambahkan ke saluran Tonton Berikutnya. Anda dapat menentukan status ini menggunakan teknologi yang mendeteksi kredit akhir secara otomatis atau menggunakan perkiraan berdasarkan panjang konten.

Sertakan episode TV yang belum tuntas

Tambahkan episode TV yang belum selesai ditonton ke saluran Tonton Berikutnya menggunakan TYPE_TV_EPISODE. Suatu episode belum selesai jika sudah dimulai tetapi belum selesai berdasarkan pedoman berikut:

  • Episode akan dimulai jika pengguna menonton lebih dari 2 menit.
  • Episode selesai jika kredit akhir dimulai. Dalam hal ini, jangan tambahkan ke saluran Tonton Berikutnya. Anda dapat menentukan status ini menggunakan teknologi yang mendeteksi kredit akhir secara otomatis atau menggunakan perkiraan berdasarkan panjang konten, seperti yang tersisa kurang dari 3 menit dalam satu episode.

Menangani episode TV baru dan episode TV berikutnya

Tambahkan episode baru dan episode berikutnya dari serial yang telah dimulai pengguna, berdasarkan panduan berikut, ke saluran Tonton Berikutnya menggunakan TYPE_TV_EPISODE:

  • Pengguna memulai serial jika menonton lebih dari 2 menit, atau 1 menit setelah pengantar selesai, dari episode mana pun dalam serial.
  • Jika pengguna memulai sebuah serial dan menyelesaikan sebuah episode, dan episode berikutnya dalam serial tersebut tersedia di layanan Anda, tambahkan episode berikutnya ke saluran Tonton Berikutnya menggunakan WATCH_NEXT_TYPE_NEXT.
  • Jika pengguna telah sepenuhnya melihat semua episode saat ini dalam sebuah serial dan season atau episode baru tersedia, tambahkan episode baru ini ke saluran Tonton Berikutnya menggunakan WATCH_NEXT_TYPE_NEW. Tambahkan episode baru terlepas dari berapa lama pengguna telah menonton serial, misalnya setelah satu tahun atau lebih.

Kapan harus menambahkan item ke saluran Tonton Berikutnya

Tambahkan konten yang belum selesai dan episode baru dari serial yang telah ditonton sebelumnya ke saluran Tonton Berikutnya sesuai dengan pedoman berikut.

Kapan harus menambahkan konten yang belum selesai

Saat pengguna memiliki bagian konten yang belum selesai, segera tambahkan konten tersebut ke saluran Tonton Berikutnya saat salah satu hal berikut terjadi:

  • Pengguna keluar dari aplikasi di Android TV.
  • Pengguna menjeda atau menghentikan pemutaran suatu konten selama lebih dari 5 menit.

Dalam skenario ini, segera publikasikan konten yang belum selesai, dengan latensi maksimum 5 detik. Misalnya, saat pengguna keluar dari aplikasi Android TV, publikasikan item yang belum selesai menggunakan API Tonton Berikutnya dalam waktu 5 detik.

Publikasikan konten yang belum selesai ditonton ke Android TV menggunakan Tonton Berikutnya di mana pun penayangannya dilakukan. Misalnya, jika pengguna menonton film di browser Chrome dan menjedanya, aplikasi di Android TV harus segera memublikasikan konten yang belum selesai ditonton ke Android TV, dengan latensi maksimum 5 detik.

Kapan harus menambahkan episode baru

Segera tambahkan episode baru dari serial yang sudah ditonton jika semua hal berikut terpenuhi:

  • Episode baru tersedia di layanan Anda.
  • Pengguna menyelesaikan episode sebelumnya.
  • Pengguna berhak menonton episode baru.

Tambahkan episode baru terlepas dari berapa lama pengguna telah menonton serial, misalnya setelah satu tahun atau lebih.

Kelayakan update konten dan UI

Pengguna harus berinteraksi dengan konten dalam aplikasi Anda agar konten memenuhi syarat untuk dipublikasikan ke saluran Tonton Berikutnya.

Jangan menambahkan lebih dari satu episode dari Serial TV yang sama. Misalnya, jangan tambahkan episode yang belum selesai dan episode baru dari serial yang sama.

Jangan update semua item di baris Mainkan Berikutnya saat satu item berubah. Hanya update item yang menerima interaksi pengguna sejak update terakhir.

Data yang harus disertakan untuk item Tonton Berikutnya

Sertakan hal berikut untuk setiap item Tonton Berikutnya:

  • Jenis Tonton Berikutnya
  • Posisi pemutaran terakhir
  • Durasi
  • Waktu engagement terakhir
  • Atribut program video: selain atribut wajib yang ditandai dalam tabel atribut program video, atribut Content ID harus ditetapkan untuk setiap program video. Atribut Content ID harus cocok dengan ID internal yang Anda berikan di feed Media Actions. Hal ini memungkinkan Android TV merekonsiliasi aset dengan lebih efektif dan menyediakan fitur keyakinan tinggi kepada pengguna.

Menghapus konten dari saluran Tonton Berikutnya

Menghapus konten setelah pengguna selesai menonton film atau tidak ada episode yang belum ditonton untuk serial TV.