ApsaraVideo Live:CreateEventSub

Membuat callback untuk berlangganan pesan saluran. Misalnya, saat membuat callback, Anda dapat mengonfigurasi parameter seperti URL callback dan tipe event.

Batas QPS

Batas QPS per pengguna tunggal untuk operasi ini adalah 100 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan tepat.

Callback

Contoh berikut menunjukkan konten yang dikembalikan ke pengguna melalui CallbackUrl yang ditentukan:

Request:

POST /callbackURL

Body
application/json

{
    "MsgId": "ID Pesan",
    "MsgTimestamp": 12312324, // Tampilan Unix saat pesan dikirim
    "SubscribeID": "ID Langganan",
    "AppId":"",     // AppId yang menghasilkan pesan ini 
    "ChannelID":"", // Saluran yang menghasilkan pesan ini
    "Contents": [
      {
        "Event": "UserEvent",// Event langganan: event pengguna dalam saluran
        "UserEvent": {
          "UserId": "80331631628*****",    // ID Pengguna
          "EventTag": "Publish",    // Event, termasuk Join, Leave, Publish, Unpublish, Roleupdate
          "SessionId": "0dr15rrnhkz0jnvz6o8sxo0*****", // SessionID yang menghasilkan event ini
          "Timestamp": 1609854786,    // Tampilan Unix saat event terjadi
          "Reason": 1, // Alasan bergabung atau keluar. Hanya tersedia untuk event Join.
          "Role": 1, //  Tipe peran: streamer atau penonton
          "CurrentMedias":"1,2,3"// Tipe stream: stream yang diterbitkan oleh pengguna
        }
      },
      {
        "Event": "ChannelEvent",// Event langganan: event saluran
        "ChannelEvent": {
          "ChannelId": "88888****",
          "EventTag": "Open",   // Event saluran, termasuk Open dan Close
          "Timestamp": 1609854530 // Tampilan Unix saat event terjadi
        }
      }
   ]
}

Response 
HTTP STATUS 200

UserEvent

ChannelEvent

Autentikasi callback

Fitur autentikasi callback event diaktifkan secara default. Logika autentikasinya adalah sebagai berikut:

• Saat ApsaraVideo Live memulai permintaan callback, header permintaan HTTP(S) berisi bidang Ali-Rtc-Timestamp dan Ali-Rtc-Signature agar server penerima pesan callback dapat melakukan autentikasi tanda tangan. Nilai Ali-Rtc-Timestamp dihitung sebagai berikut: Ali-Rtc-Signature=MD5SUM(MD5CONTENT), di mana MD5CONTENT=Nama domain callback|Nilai Ali-Rtc-Timestamp|Kunci Autentikasi. Nama domain callback adalah nama domain yang dikonfigurasi di URL callback, dan Kunci Autentikasi adalah AppKey yang dihasilkan saat AppId dibuat.

• Saat server penerima pesan callback menerima pesan callback, server tersebut menggabungkan nama domain callback, nilai Ali-Rtc-Timestamp, dan Kunci Autentikasi, menghitung nilai MD5 untuk memperoleh string terenkripsi, lalu membandingkan string terenkripsi yang dihitung dengan nilai bidang Ali-Rtc-Signature di header permintaan HTTP(S) yang dimulai oleh ApsaraVideo Real-time Communication. Jika tidak cocok, permintaan tidak valid.

Percobaan ulang exception callback

Saat Alibaba Cloud memulai permintaan callback, callback dianggap berhasil hanya ketika server bisnis Anda merespons dengan kode status HTTP 200. Jika callback gagal, Alibaba Cloud akan mencoba ulang 7 kali dengan interval 1 detik, 2 detik, 5 detik, 10 detik, 1 menit, 2 menit, dan 5 menit. Setiap percobaan ulang menghasilkan catatan callback yang sesuai.

Penanganan exception

Klien yang telah bergabung ke saluran atau sedang menerbitkan stream mempertahankan mekanisme heartbeat keep-alive dengan server Alibaba Cloud. Ketika heartbeat keep-alive gagal karena klien kehilangan konektivitas jaringan atau aplikasi ditutup secara abnormal (kegagalan ditentukan jika tidak ada heartbeat yang diterima dari klien selama 90 detik), server menentukan bahwa klien telah timeout dan keluar secara abnormal, serta menghasilkan callback event untuk pengguna yang berhenti menerbitkan stream dan keluar dari saluran.