Menambahkan program ke saluran Tonton Berikutnya

Saluran Tonton Berikutnya adalah baris kedua yang muncul di layar utama, setelah baris aplikasi. Sistem akan membuat dan menyimpan saluran ini. Aplikasi Anda dapat menambahkan program ke saluran Tonton Berikutnya: program yang ditandai pengguna sebagai menarik, berhenti ditonton di pertengahan jalan, atau yang terkait dengan konten yang ditonton pengguna (seperti episode berikutnya dalam sebuah serial atau season berikutnya dari sebuah acara).

Saluran Tonton Berikutnya memiliki beberapa batasan: aplikasi Anda tidak dapat memindahkan, menghapus, atau menyembunyikan baris saluran Tonton Berikutnya.

Langkah

Memasukkan program ke saluran Tonton Berikutnya mirip dengan memasukkan program ke saluran Anda sendiri. Lihat bagian berikut untuk mengetahui detail khusus tentang Tonton Berikutnya.

Saat menyisipkan konten ke saluran Tonton Berikutnya, Anda harus mengikuti pedoman berikut:

Memilih jenis program

Ada empat jenis program Tonton Berikutnya. Pilih jenis yang sesuai:

Jenis Catatan
WATCH_NEXT_TYPE_CONTINUE Pengguna berhenti saat menonton konten.
WATCH_NEXT_TYPE_NEXT Program berikutnya yang tersedia dalam serial yang sedang ditonton pengguna. Misalnya, saat pengguna menonton episode 3 dari sebuah serial, aplikasi dapat menyarankan agar mereka menonton episode 4.
WATCH_NEXT_TYPE_NEW Konten baru yang dengan jelas mengikuti apa yang ditonton pengguna telah tersedia. Misalnya, pengguna sedang menonton episode nomor 5 dari suatu serial dan episode 6 tersedia untuk ditonton.
WATCH_NEXT_TYPE_WATCHLIST Dimasukkan oleh sistem atau aplikasi saat pengguna menyimpan suatu program.

Untuk informasi selengkapnya, lihat atribut Tonton Berikutnya.

Menggunakan builder WatchNextProgram

Gunakan WatchNextProgram.Builder. Untuk mengetahui informasi selengkapnya, lihat Atribut Tonton Berikutnya.

Kotlin

val builder = WatchNextProgram.Builder()
builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE)
        .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
        .setLastEngagementTimeUtcMillis(time)
        .setTitle("Title")
        .setDescription("Program description")
        .setPosterArtUri(uri)
        .setIntentUri(uri)
        .setInternalProviderId(appProgramId)

val watchNextProgramUri = context.contentResolver
        .insert(TvContractCompat.WatchNextPrograms.CONTENT_URI,
                builder.build().toContentValues())

Java

WatchNextProgram.Builder builder = new WatchNextProgram.Builder();
builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE)
        .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
        .setLastEngagementTimeUtcMillis(time)
        .setTitle("Title")
        .setDescription("Program description")
        .setPosterArtUri(uri)
        .setIntentUri(uri)
        .setInternalProviderId(appProgramId);

Uri watchNextProgramUri = context.getContentResolver()
        .insert(TvContractCompat.WatchNextPrograms.CONTENT_URI, builder.build().toContentValues());

Gunakan TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId) untuk membuat Uri yang diperlukan untuk memperbarui program Tonton Berikutnya.

Saat pengguna menambahkan program ke saluran Tonton Berikutnya, sistem akan menyalin program ke baris. Tindakan ini mengirimkan intent TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT untuk memberi tahu aplikasi bahwa program telah ditambahkan. Intent ini mencakup dua ekstra: ID program yang disalin dan ID program yang dibuat untuk program di saluran Tonton Berikutnya.