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 menonton di tengah, atau yang terkait dengan konten yang ditonton pengguna (seperti episode berikutnya dalam seri atau musim tayangan berikutnya).

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

Langkah

Memasukkan program ke dalam saluran Tonton Berikutnya mirip dengan menyisipkan program ke dalam saluran Anda sendiri. Lihat bagian berikut untuk detail spesifik tentang Tonton Berikutnya.

Saat menyisipkan konten ke saluran Tonton Berikutnya, Anda harus mengikuti panduan 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 yang tersedia berikutnya dalam serial yang ditonton pengguna telah tersedia. 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 5 dari sebuah 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 informasi selengkapnya, lihat Atribut Tonton Berikutnya.

Kotlin

    val builder = WatchNextProgram.Builder()
    builder.setType(TvContractCompat.WatchNextPrograms.TYPE_CLIP)
            .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_CLIP)
            .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 Anda butuhkan untuk mengupdate program Tonton Berikutnya.

Saat pengguna menambahkan program ke saluran Tonton Berikutnya, sistem akan menyalin program ke baris. Baris akan mengirimkan intent TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT untuk memberi tahu aplikasi bahwa program telah ditambahkan. Intent akan menyertakan dua tambahan: ID program yang disalin dan ID program yang dibuat untuk program dalam saluran Tonton Berikutnya.