Topik ini menjelaskan cara mengonfigurasi callbacks untuk perekaman live stream dan menyediakan contoh callbacks.
Metode konfigurasi callback
- Untuk informasi lebih lanjut tentang cara mengonfigurasi callbacks untuk perekaman live stream di konsol ApsaraVideo Live, lihat Konfigurasikan Callbacks Rekaman.
- Untuk informasi lebih lanjut tentang cara mengonfigurasi callbacks untuk perekaman live stream dengan memanggil operasi API, lihat AddLiveRecordNotifyConfig.
Contoh callbacks
- Callbacks status rekaman: dipanggil saat rekaman dimulai dan diakhiri. Pesan callback memberi tahu bahwa rekaman dimulai atau diakhiri.
- Callbacks pembuatan rekaman: dipanggil saat rekaman dibuat. Pesan callback berisi nama, waktu mulai, waktu akhir, dan durasi rekaman.
Konten callback dalam format JSON disertakan dalam badan permintaan dari permintaan HTTP POST dan dikirim ke URL callback. URL callback ditentukan oleh parameter NotifyUrl dalam konfigurasi callbacks untuk perekaman live streaming. Penerima dapat mengurai badan permintaan dan mendapatkan konten callback.
Callbacks Status Rekaman
CatatanAnda dapat memanggil operasi API untuk mengonfigurasi callbacks status rekaman. Konten callback dapat dihasilkan jika parameter NeedStatusNotify diatur ke true.
Parameter NeedStatusNotify adalah parameter permintaan dari operasi AddLiveRecordNotifyConfig. Parameter ini menentukan apakah akan mengaktifkan callbacks status rekaman.
Tabel 1. Parameter
Parameter Deskripsi domain Domain streaming. app Nama aplikasi. stream Nama live stream. event Nama event. Nilai yang valid: - record_started: Rekaman dimulai.
- record_paused: Rekaman dijeda.
- record_resumed: Rekaman dilanjutkan.
Contoh callback untuk awal rekaman:{ "domain": "gs_domain", "app": "gs_app", "stream": "gs_stream", "event": "record_started" }Callbacks Pembuatan Rekaman
Tabel 2. Parameter
Parameter Deskripsi domain Domain streaming. app Nama aplikasi. stream Nama live stream. uri Jalur penyimpanan rekaman di bucket Object Storage Service (OSS) yang ditentukan. duration Durasi rekaman. Satuan: detik. start_time Waktu mulai rekaman. Waktu ini adalah timestamp UNIX. Satuan: detik. stop_time Waktu akhir rekaman. Waktu ini adalah timestamp UNIX. Satuan: detik. push_args Parameter ingest stream yang diawali dengan callback_, seperti callback_arg1 dan callback_myid. Catatan- Contoh callback ini berlaku jika Anda tidak memiliki template callback kustom.
- Setiap parameter hanya mendukung satu nilai. Jika Anda memberikan beberapa nilai ke sebuah parameter, callback hanya akan mengembalikan nilai pertama yang diberikan ke parameter tersebut. Sebagai contoh, jika Anda memberikan value1 lalu value2 ke parameter
callback_args1, callback hanya akan mengembalikan"callback_args1": "value1".
Contoh callback untuk pembuatan rekaman:{ "domain": "demo.aliyundoc.com", "app": "liveApp****", "stream": "liveStream****", "uri": "liveApp****/liveStream****/0_2017-03-08-23:09:46_2017-03-08-23:10:40.flv", "duration": 69.403, "start_time": 1488985786, "stop_time": 1488985840, "push_args": { "callback_args1": "value1", "callback_myid": "1231389741" } }
Referensi
Untuk informasi lebih lanjut, lihat Kelola Callbacks.