Panduan migrasi untuk penghentian penggunaan siaran dan streaming default

Ringkasan

Panduan ini ditujukan bagi developer aplikasi klien API yang menggunakan resource liveStream dan liveBroadcast default channel YouTube untuk melakukan streaming konten live. Panduan ini bertujuan membantu Anda memastikan aplikasi menangani penghentian siaran default dan streaming default dengan baik, dan relevan bagi Anda jika salah satu pernyataan berikut berlaku untuk aplikasi Anda:

  • Aplikasi memeriksa nilai properti resource liveBroadcast isDefaultBroadcast.
  • Aplikasi memeriksa nilai properti resource liveStream isDefaultStream.

  • Aplikasi memanggil liveBroadcasts.list metode dan menetapkan nilai parameter broadcastType ke persistent. Mulai tanggal penghentian:

    • Jika nilai parameter broadcastType adalah persistent, metode liveBroadcasts.list tidak akan menampilkan hasil apa pun.
    • Jika nilai parameter broadcastType adalah all, metode liveBroadcasts.list tidak akan menampilkan siaran persisten yang ada sebelum waktu tersebut.

Jika aplikasi Anda terpengaruh, lihat bagian Memperbarui aplikasi, yang menjelaskan perubahan prosedural yang mungkin perlu dilakukan aplikasi Anda sebagai akibat dari penghentian ini. Bagian tersebut mengidentifikasi langkah-langkah tertentu dalam panduan Siklus siaran yang mungkin tidak diikuti oleh klien API Anda jika saat ini menggunakan siaran dan streaming default.

Apa yang terjadi?

Sejak tahun 2015, YouTube telah otomatis membuat streaming default dan siaran default untuk channel saat channel tersebut diaktifkan untuk live streaming. Streaming default ada tanpa batas waktu dan tidak dapat dihapus. Demikian pula, siaran default dianggap persisten. Siaran tersebut selalu ada, tidak memiliki waktu mulai atau berakhir yang terkait dengannya, dan tidak terikat ke peristiwa tertentu.

Mulai tanggal penghentian yang disebutkan di atas, YouTube tidak akan lagi membuat streaming dan siaran default. Perubahan ini memengaruhi aplikasi klien yang mengandalkan resource tersebut untuk menyiarkan konten live. Perubahan ini juga akan memengaruhi aplikasi yang antarmuka penggunanya disesuaikan untuk membedakan antara resource default tersebut dan siaran serta streaming lain yang dibuat oleh pemilik channel.

Daripada mengandalkan resource default, klien API perlu membuat dan mengelola resource liveBroadcast dan liveStream serta mengikat resource tersebut.

Memperbarui aplikasi

Untuk meninjau terminologi dengan cepat, siaran mewakili peristiwa yang dapat ditonton di YouTube saat terjadi, dan streaming adalah mekanisme untuk mengirim konten video sebenarnya ke YouTube. Siaran dapat dan harus terikat ke tepat satu streaming.

Bermigrasi dari siaran default

Sebelum penghentian ini, klien API dapat memilih antara menggunakan siaran default channel atau membuat siaran khusus peristiwa. Siaran default adalah resource persisten yang dapat digunakan kembali untuk beberapa peristiwa, sedangkan resource siaran khusus peristiwa adalah resource sekali pakai yang sesuai dengan tepat satu video YouTube.

Aplikasi klien Anda menggunakan siaran default jika memanggil metode liveBroadcasts.list dan melakukan salah satu hal berikut:

  • Menetapkan nilai parameter broadcastType ke persistent. Permintaan ini hanya mengambil siaran default.
  • Menetapkan nilai parameter broadcastType ke all, lalu mengidentifikasi resource liveBroadcast dalam respons API yang nilai properti isDefaultBroadcast -nya adalah true.

Setelah penghentian, YouTube hanya akan mendukung siaran khusus peristiwa. Artinya, daripada mengandalkan siaran default, aplikasi klien perlu membuat liveBroadcast resource untuk setiap peristiwa siaran.

Untuk membuat resource liveBroadcast, panggil metode liveBroadcasts.insert. Proses ini dijelaskan di langkah 1.1 panduan "Siklus siaran".

Jika belum melakukannya, antarmuka pengguna Anda juga perlu menyediakan mekanisme bagi pengguna untuk membedakan dan memilih antara siaran khusus peristiwa mendatang.

Bermigrasi dari streaming default

Streaming memungkinkan Anda mengirimkan konten audio-video ke YouTube, dan menentukan setelan cara Anda melakukan streaming konten ke YouTube. Penyiar biasanya menggunakan kembali streaming yang sama untuk banyak siaran yang berbeda jika siaran tersebut terjadi pada waktu yang berbeda.

Meskipun aplikasi Anda tidak dapat menggunakan streaming default, aplikasi tersebut dapat membuat streaming yang dapat digunakan kembali untuk setiap siaran. Untuk membuat liveStream resource, panggil liveStreams.insert metode, dengan mengikuti petunjuk di langkah 1.2 panduan "Siklus siaran". Secara default, streaming yang baru dibuat dapat digunakan kembali. Namun, jika mau, Anda dapat menetapkan properti contentDetails.isReusable ke false untuk membuat streaming sekali pakai dan memiliki hubungan satu-ke-satu antara siaran dan streaming.

Daftar berikut berisi empat properti, selain judul streaming dan deskripsi streaming, yang dapat Anda tetapkan saat membuat streaming baru. Daftar ini menampilkan nilai yang digunakan streaming default untuk setiap properti, yang kemungkinan merupakan setelan yang ingin Anda gunakan di aplikasi klien jika Anda bermigrasi dari penggunaan streaming default.

Mengikat siaran ke streaming

Setiap resource liveBroadcast harus terikat ke tepat satu streaming sebelum live streaming di YouTube dapat benar-benar dimulai. (Siaran tidak terikat ke streaming apa pun pada saat dibuat.)

Proses pengikatan ditangani secara otomatis untuk siaran default, yang terikat secara tak terpisahkan ke streaming default. Namun, setelah tanggal penghentian, aplikasi klien perlu mengelola proses tersebut untuk semua siaran.

Untuk mengikat siaran ke streaming, panggil metode liveBroadcasts.bind seperti yang dijelaskan di langkah 1.3 panduan "Siklus siaran".

  • Jika menggunakan streaming yang dapat digunakan kembali, Anda dapat membuat streaming sekali, lalu mengikat setiap siaran ke streaming tersebut.
  • Jika tidak menggunakan streaming yang dapat digunakan kembali, Anda perlu membuat siaran dan streaming, lalu mengikat keduanya.

Menguji siaran

Jika tidak menggunakan siaran default, Anda memiliki opsi untuk menguji siaran. Untuk melakukan pengujian, Anda menyematkan pemutar yang memungkinkan Anda melihat pratinjau video siaran seperti yang akan ditampilkan kepada penonton YouTube, tetapi siaran tidak terlihat oleh penonton lain.

Jika klien API Anda sebelumnya menggunakan siaran dan streaming default, dan Anda ingin menambahkan fase pengujian ke proses streaming, lihat tahap 3 panduan "Siklus siaran".

Jika Anda ingin menguji streaming, saat menyisipkan siaran, Anda perlu menetapkan properti contentDetails.monitorStream.enableMonitorStream ke true dan properti contentDetails.enableAutoStart ke false. Ini adalah nilai default untuk kedua properti.

Menggunakan fitur mulai otomatis dan berhenti otomatis

Siaran default otomatis dimulai setiap kali Anda mulai melakukan streaming video di streaming default. Demikian pula, siaran default berakhir setelah Anda berhenti melakukan streaming video. Setiap sesi streaming yang menggunakan resource default tersebut kemudian menjadi video di channel Anda.

Meskipun fitur mulai otomatis dan berhenti otomatis adalah perilaku default untuk siaran default, fitur tersebut bersifat opsional dan perlu diaktifkan untuk siaran lainnya. Jika ingin menggunakan fitur ini, saat menyisipkan siaran, Anda harus menetapkan nilai properti contentDetails.enableAutoStart dan contentDetails.enableAutoStop ke true. Fitur ini bersifat independen, sehingga Anda dapat memilih untuk menggunakan salah satu dan tidak menggunakan yang lain.

Jika Anda tidak mengaktifkan fitur mulai otomatis dan berhenti otomatis untuk siaran baru, klien API Anda perlu memanggil metode liveBroadcasts.transition untuk memperbarui status siaran saat Anda memulai dan menyelesaikan streaming video. Di panduan "Siklus Siaran" , lihat langkah 4.3 dan langkah 5.2 untuk mengetahui petunjuk tentang cara mengelola transisi ini di awal dan akhir siaran.