Jika peristiwa yang dikonfigurasikan dalam templat memicu panggilan balik selama streaming langsung, Tencent Cloud akan mengirimkan permintaan ke server pelanggan yang bertanggung jawab atas respons tersebut. Setelah berhasil melewati verifikasi, server akan mendapatkan paket JSON panggilan balik.
Saat ini, peristiwa berikut dapat memicu pemberitahuan selama streaming langsung: push streaming, interupsi streaming, perekaman, pengambilan tangkapan layar, dan deteksi pornografi.
Detail Lengkap Proses
Deskripsi Proses:
1. Host mengonfigurasikan URL pemberitahuan pesan peristiwa dan fitur, seperti perekaman dan pengambilan tangkapan layar, di konsol atau dengan memanggil API TencentCloud.
2. Host melakukan push dan menghentikan streaming.
3. Ketika suatu peristiwa terjadi, pesan akan dikirimkan ke backend pelanggan melalui layanan pemberitahuan pesan peristiwa.
Protokol Pemberitahuan Pesan Peristiwa
Protokol jaringan
Permintaan: Permintaan HTTP POST dengan paket JSON. Konten paket spesifik untuk setiap jenis pesan akan dijelaskan di bagian selanjutnya.
Respons: Kode status HTTP = 200. Server mengabaikan konten spesifik di paket respons. Untuk memastikan kompatibilitas dengan protokol, Anda sebaiknya menambahkan JSON: {"code":0}`` ke respons.
Keandalan pemberitahuan
Layanan pemberitahuan peristiwa memiliki mekanisme percobaan ulang. Untuk peristiwa pengambilan tangkapan layar, maksimum 5 percobaan ulang akan dilakukan dengan interval 2 menit. Untuk peristiwa push streaming, interupsi streaming, perekaman, dan deteksi pornografi, maksimum 12 percobaan ulang akan dilakukan dengan interval 1 menit.
Agar percobaan ulang dengan frekuensi sering tidak terlalu membebani server dan bandwidth Anda, pastikan paket respons ditampilkan sebagaimana diharapkan. Percobaan ulang akan terpicu dalam kasus-kasus berikut:
Tidak ada paket respons yang ditampilkan dalam waktu lama (minimal 20 detik).
CSS membantu Anda mengonfigurasikan URL panggilan balik secara terpisah untuk peristiwa push streaming, interupsi streaming, perekaman, pengambilan tangkapan layar, dan deteksi pornografi.
2. Klik Domain Management (Manajemen Domain) untuk menemukan nama domain push target, lalu klik Manage > Template Configuration (Kelola > Konfigurasi Templat) untuk mengikatkannya dengan templat panggilan balik. Petunjuk lengkapnya dapat dipelajari di Callback Configuration (Konfigurasi Panggilan Balik).
API Server
1. Panggil API CreateLiveCallbackTemplate untuk membuat templat panggilan balik dan mengatur parameter panggilan balik.
2. Panggil API CreateLiveCallbackRule untuk mengatur parameter DomainName (nama domain push) dan TemplateId (kembali ke langkah 1). Masukkan AppName ke URL push dan pemutaran ulang untuk mengaktifkan panggilan balik untuk streaming langsung tertentu.
Parameter Panggilan Balik
Setelah templat berhasil diikatkan dengan nama domain, jika peristiwa yang dikonfigurasikan di templat terpicu selama streaming langsung, Tencent Cloud akan mengirimkan paket JSON yang berisi informasi panggilan balik ke server pelanggan. Berikut adalah penjelasan terperinci seputar parameter panggilan balik:
