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. Tujuannya adalah membantu Anda memastikan bahwa aplikasi Anda menangani penghentian penggunaan siaran default dan streaming default dengan baik, dan relevan bagi Anda jika salah satu pernyataan berikut berlaku untuk aplikasi Anda:

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

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

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

Jika aplikasi Anda terpengaruh, lihat bagian Mengupdate aplikasi Anda, yang menjelaskan perubahan prosedural yang mungkin perlu dilakukan aplikasi Anda sebagai akibat dari penghentian penggunaan ini. Bagian tersebut mengidentifikasi langkah-langkah tertentu dalam panduan Siklus proses siaran yang biasanya 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 channel saat channel tersebut diaktifkan untuk live streaming. Aliran default ada tanpa batas waktu dan tidak dapat dihapus. Demikian pula, siaran default dianggap persisten. Acara ini selalu ada, tidak memiliki waktu mulai atau berakhir yang terkait dengannya, dan tidak terikat pada acara tertentu.

Mulai tanggal penghentian penggunaan 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 dibuat oleh pemilik channel.

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

Memperbarui aplikasi Anda

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

Bermigrasi dari siaran default

Sebelum penghentian penggunaan ini, klien API dapat memilih antara menggunakan siaran default channel atau membuat siaran khusus acara. Siaran default adalah resource persisten yang dapat digunakan kembali untuk beberapa acara, sedangkan resource siaran khusus acara 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:

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

Setelah penghentian penggunaan, YouTube hanya akan mendukung siaran khusus acara. Artinya, alih-alih mengandalkan siaran default, aplikasi klien perlu membuat resource liveBroadcast untuk setiap peristiwa siaran individual.

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

Jika belum melakukannya, antarmuka pengguna Anda juga perlu menyediakan mekanisme bagi pengguna untuk membedakan dan memilih siaran spesifik per acara mendatang.

Bermigrasi dari aliran 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 stream default, aplikasi tersebut dapat membuat stream yang dapat digunakan kembali untuk setiap siaran. Untuk membuat resource liveStream, panggil metode liveStreams.insert, dengan mengikuti petunjuk di langkah 1.2 dalam panduan "Siklus proses siaran". Secara default, aliran 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 satu-ke-satu antara siaran dan aliran.

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 aliran default untuk setiap properti, yang kemungkinan merupakan setelan yang ingin Anda gunakan di aplikasi klien jika Anda bermigrasi dari penggunaan aliran default.

Mengikat siaran ke aliran

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

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

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

  • Jika menggunakan streaming yang dapat digunakan kembali, Anda dapat membuat streaming sekali, lalu mengikat setiap siaran ke streaming tersebut.
  • Jika Anda tidak menggunakan stream yang dapat digunakan kembali, Anda perlu membuat siaran dan stream, 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 sebagaimana akan ditampilkan kepada penonton YouTube, tetapi siaran tidak terlihat oleh penonton lain.

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

Jika Anda 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 otomatis dimulai setiap kali Anda mulai 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 harus diaktifkan untuk siaran lainnya. Jika Anda 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 satunya dan tidak menggunakan yang lain.

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