Panduan migrasi untuk penghentian streaming dan streaming default

Ringkasan

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

  • Composable ini memeriksa nilai properti isDefaultBroadcast resource liveBroadcast.
  • Composable ini memeriksa nilai properti isDefaultStream resource liveStream.

  • Panggilan ini memanggil metode liveBroadcasts.list dan menetapkan parameter value broadcastType ke persistent. Mulai tanggal penghentian:

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

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

Apa yang terjadi?

Sejak 2015, YouTube telah otomatis membuat streaming default dan siaran default untuk sebuah channel saat channel tersebut diaktifkan untuk live streaming. Streaming default sudah ada tanpa batas waktu dan tidak dapat dihapus. Demikian pula, siaran default dianggap persisten. Peristiwa ini selalu ada, tidak memiliki waktu mulai atau waktu berakhir yang terkait dengannya, dan tidak terikat dengan 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. Hal ini juga akan memengaruhi aplikasi yang antarmuka penggunanya disesuaikan untuk membedakan antara resource default tersebut dan siaran serta streaming lain yang telah dibuat pemilik saluran.

Sebagai ganti mengandalkan resource default, klien API harus membuat dan mengelola resource liveBroadcast dan liveStream serta mengikat resource tersebut bersama-sama.

Mengupdate aplikasi

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

Bermigrasi dari siaran default

Sebelum penghentian ini, klien API dapat memilih antara menggunakan siaran default saluran 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:

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

Setelah penghentian tersebut, YouTube hanya akan mendukung siaran khusus acara. Artinya, aplikasi klien harus membuat resource liveBroadcast untuk setiap peristiwa siaran, bukan mengandalkan siaran default.

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

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

Melakukan migrasi dari streaming default

Dengan streaming, Anda dapat mengirimkan konten audio-video ke YouTube. Streaming ini juga menentukan setelan terkait cara Anda melakukan streaming konten ke YouTube. Penyiar biasanya menggunakan kembali aliran yang sama untuk berbagai siaran jika siaran tersebut terjadi pada waktu yang berbeda.

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

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

Mengikat siaran ke streaming

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

Proses binding ditangani secara otomatis untuk siaran default, yang sangat terikat dengan streaming default. Namun, setelah tanggal penghentian, aplikasi klien perlu mengelola proses tersebut untuk semua siaran.

Untuk mengikat siaran ke aliran data, panggil metode liveBroadcasts.bind seperti yang dijelaskan di langkah 1.3 dalam panduan "Masa aktif siaran".

  • Jika menggunakan streaming yang dapat digunakan kembali, Anda dapat membuat streaming satu kali, lalu mengikat setiap siaran ke aliran tersebut.
  • Jika tidak menggunakan aliran data yang dapat digunakan kembali, Anda perlu membuat siaran dan aliran, lalu mengikat keduanya secara bersamaan.

Menguji siaran Anda

Jika tidak menggunakan siaran default, Anda memiliki opsi untuk menguji siaran Anda. Untuk melakukan pengujian, Anda menyematkan pemutar yang memungkinkan Anda melihat pratinjau video siaran seperti yang akan ditampilkan kepada penonton YouTube, tetapi siaran tersebut 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 dari panduan "Masa aktif siaran".

Jika ingin menguji streaming, saat menyisipkan siaran, Anda harus 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 secara otomatis dimulai setiap kali Anda memulai streaming video di streaming default. Demikian pula, siaran default berakhir setelah Anda menghentikan streaming video. Setiap sesi streaming yang menggunakan resource default tersebut kemudian menjadi video di channel Anda.

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

Jika Anda tidak mengaktifkan fitur mulai otomatis dan berhenti otomatis untuk siaran baru, klien API harus memanggil metode liveBroadcasts.transition untuk memperbarui status siaran saat Anda memulai dan menyelesaikan streaming video. Dalam panduan "Life of a Broadcast", lihat langkah 4.3 dan langkah 5.2 untuk mengetahui petunjuk mengelola transisi ini di awal dan akhir siaran.