Resource liveStream berisi informasi tentang streaming video yang Anda transmisikan ke YouTube. Streaming menyediakan konten yang akan disiarkan kepada pengguna YouTube. Setelah dibuat, resource liveStream dapat terikat ke satu atau beberapa resource liveBroadcast.
Metode
API ini mendukung metode berikut untuk resource liveStreams:
- list
- Menampilkan daftar streaming video yang cocok dengan parameter permintaan API. Coba sekarang.
- insert
- Membuat streaming video. Streaming memungkinkan Anda mengirim video ke YouTube, yang kemudian dapat menyiarkan video tersebut kepada audiens. Coba sekarang.
- update
- Memperbarui streaming video. Jika properti yang ingin diubah tidak dapat diperbarui, Anda harus membuat aliran baru dengan setelan yang sesuai. Coba sekarang.
- hapus
- Menghapus streaming video. Coba sekarang.
Representasi resource
Struktur JSON berikut menunjukkan format resource liveStreams:
{
"kind": "youtube#liveStream",
"etag": etag,
"id": string,
"snippet": {
"publishedAt": datetime,
"channelId": string,
"title": string,
"description": string,
"isDefaultStream": boolean
},
"cdn": {
"ingestionType": string,
"ingestionInfo": {
"streamName": string,
"ingestionAddress": string,
"backupIngestionAddress": string
},
"resolution": string,
"frameRate": string
},
"status": {
"streamStatus": string,
"healthStatus": {
"status": string,
"lastUpdateTimeSeconds": unsigned long,
"configurationIssues": [
{
"type": string,
"severity": string,
"reason": string,
"description": string
}
]
}
},
"contentDetails": {
"closedCaptionsIngestionUrl": string,
"isReusable": boolean
}
}Properti
Tabel berikut menentukan properti yang muncul dalam resource ini:
| Properti | |
|---|---|
kind |
stringMengidentifikasi jenis resource API. Nilainya akan menjadi youtube#liveStream. |
etag |
etagEtag resource ini. |
id |
stringID yang ditetapkan YouTube untuk mengidentifikasi streaming secara unik. |
snippet |
objectObjek snippet berisi detail dasar tentang streaming, termasuk channel, judul, dan deskripsinya. |
snippet.publishedAt |
datetimeTanggal dan waktu streaming dibuat. Nilai ditentukan dalam format ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ). |
snippet.channelId |
stringID yang digunakan YouTube untuk mengidentifikasi secara unik channel yang mengirimkan streaming. |
snippet.title |
stringJudul streaming. Panjang nilai harus antara 1 dan 128 karakter. |
snippet.description |
stringDeskripsi streaming. Nilai tidak boleh lebih dari 10.000 karakter. |
snippet.isDefaultStream |
boolean
Properti ini tidak akan digunakan lagi pada atau setelah 1 September 2020. Pada saat itu, YouTube akan berhenti membuat streaming default dan siaran default saat channel diaktifkan untuk live streaming. Lihat pengumuman penghentian penggunaan untuk detail selengkapnya.
Properti ini menunjukkan apakah streaming ini adalah streaming default untuk saluran.Cara kerja streaming default Saat channel YouTube diaktifkan untuk live streaming, YouTube akan membuat streaming default dan siaran default untuk channel tersebut. Streaming menentukan cara pemilik channel mengirim video live ke YouTube, dan siaran adalah cara penonton dapat melihat streaming default. Pemilik channel dapat menggunakan metode liveStreams.list
dan liveBroadcasts.list
untuk mengidentifikasi resource ini.Streaming default channel ada tanpa batas waktu, tidak memiliki waktu mulai atau waktu berakhir yang terkait dengannya, dan tidak dapat dihapus. Pemilik channel hanya perlu mulai mengirim bit video dan streaming akan otomatis berlanjut. Saat streaming berakhir, YouTube akan mengonversi siaran yang telah selesai menjadi video YouTube dan menetapkan ID video YouTube untuk video tersebut. Setelah konversi selesai, video akan disertakan dalam daftar video yang diupload di channel. Video tidak langsung tersedia setelah siaran berakhir, dan durasi penundaan terkait dengan durasi siaran yang sebenarnya. |
cdn |
objectObjek cdn menentukan setelan jaringan penayangan konten (CDN) live stream. Setelan ini memberikan detail tentang cara Anda melakukan streaming konten ke YouTube. |
cdn.format |
stringProperti ini tidak digunakan lagi sejak 18 April 2016, dan tidak akan didukung lagi mulai 17 Agustus 2020. Permintaan yang masih menggunakan properti ini sejak tanggal tersebut akan gagal. Sebagai gantinya, gunakan properti cdn.frameRate dan
cdn.resolution untuk menentukan kecepatan
frame dan resolusi secara terpisah.
|
cdn.ingestionType |
stringMetode atau protokol yang digunakan untuk mengirimkan streaming video. Nilai yang valid untuk properti ini adalah:
|
cdn.ingestionInfo |
objectObjek ingestionInfo berisi informasi yang disediakan YouTube yang diperlukan untuk mengirimkan streaming ke YouTube. |
cdn.ingestionInfo.streamName |
stringNama streaming yang ditetapkan YouTube ke streaming video. |
cdn.ingestionInfo.ingestionAddress |
stringURL proses transfer utama yang harus Anda gunakan untuk melakukan streaming video ke YouTube jika Anda menggunakan RTMP, DASH, atau HLS. Anda harus melakukan streaming video ke URL ini. Bergantung pada aplikasi atau alat yang Anda gunakan untuk mengenkode streaming video, Anda mungkin perlu memasukkan URL streaming dan nama streaming secara terpisah atau Anda mungkin perlu menggabungkannya dalam format berikut: STREAM_URL/STREAM_NAME |
cdn.ingestionInfo.backupIngestionAddress |
stringURL proses transfer cadangan yang harus Anda gunakan untuk melakukan streaming video ke YouTube jika Anda menggunakan RTMP, DASH, atau HLS. Anda memiliki opsi untuk melakukan streaming konten yang dikirim ke ingestionAddress secara bersamaan ke URL ini. |
cdn.ingestionInfo.rtmpsIngestionAddress |
stringURL transfer streaming utama yang harus Anda gunakan untuk melakukan streaming video ke YouTube jika Anda menggunakan RTMPS. Anda harus melakukan streaming video ke URL ini. Bergantung pada aplikasi atau alat yang Anda gunakan untuk enkode streaming video, Anda mungkin perlu memasukkan URL streaming dan nama streaming secara terpisah atau Anda mungkin perlu menggabungkannya dalam format berikut: STREAM_URL/STREAM_NAME |
cdn.ingestionInfo.rtmpsBackupIngestionAddress |
stringURL transfer cadangan yang harus Anda gunakan untuk melakukan streaming video ke YouTube jika Anda menggunakan RTMPS. |
cdn.resolution |
stringResolusi data video masuk. Nilai yang valid untuk properti ini adalah:
|
cdn.frameRate |
stringKecepatan frame data video masuk. Nilai yang valid untuk properti ini adalah:
|
status |
objectObjek status berisi informasi tentang status live stream. |
status.streamStatus |
stringStatus streaming. Nilai yang valid untuk properti ini adalah:
|
status.healthStatus |
objectObjek ini berisi informasi tentang status kondisi live stream, yang dapat digunakan untuk mengidentifikasi, mendiagnosis, dan menyelesaikan masalah streaming. |
status.healthStatus.status |
stringKode status streaming ini. Nilai yang valid untuk properti ini adalah:
|
status.healthStatus.lastUpdateTimeSeconds |
unsigned longTerakhir kali status respons streaming diperbarui. Nilai ini mencerminkan stempel waktu UNIX dalam detik. |
status.healthStatus.configurationIssues[] |
listObjek ini berisi daftar masalah konfigurasi yang memengaruhi streaming. |
status.healthStatus.configurationIssues[].type |
stringMengidentifikasi jenis error yang memengaruhi streaming. |
status.healthStatus.configurationIssues[].severity |
stringMenunjukkan seberapa parah masalah terhadap streaming. Nilai yang valid untuk properti ini adalah:
|
status.healthStatus.configurationIssues[].reason |
stringDeskripsi singkat masalah. Dokumen Masalah Konfigurasi untuk Resource LiveStream mengidentifikasi alasan yang terkait dengan setiap jenis masalah konfigurasi. |
status.healthStatus.configurationIssues[].description |
stringDeskripsi mendetail tentang masalah. Jika memungkinkan, deskripsi akan memberikan informasi tentang cara menyelesaikan masalah. Dokumen Masalah Konfigurasi untuk Resource LiveStream mencantumkan semua jenis masalah konfigurasi dan deskripsi terkait. |
contentDetails |
objectObjek content_details berisi informasi tentang streaming, termasuk URL penyerapan teks tertutup. |
contentDetails.closedCaptionsIngestionUrl |
stringURL proses transfer tempat teks tertutup streaming ini dikirim. |
contentDetails.isReusable |
booleanMenunjukkan apakah streaming dapat digunakan kembali, yang berarti dapat terikat ke beberapa siaran. Penyiar biasanya menggunakan kembali streaming yang sama untuk banyak siaran yang berbeda jika siaran tersebut terjadi pada waktu yang berbeda. Jika Anda menetapkan nilai ini ke false, streaming tidak akan dapat digunakan kembali, yang berarti streaming hanya dapat terikat ke satu siaran. Streaming yang tidak dapat digunakan kembali berbeda dengan streaming yang dapat digunakan kembali dalam hal berikut:
|