ApsaraVideo Live：CreateEventSub

Anda dapat memanggil operasi ini untuk membuat callback guna berlangganan event channel atau pengguna. Saat membuat callback, Anda dapat mengonfigurasi parameter seperti URL callback dan tipe event.

Batas QPS

Anda dapat memanggil operasi ini hingga 100 kali per detik per akun. Permintaan yang melebihi batas ini akan dibuang dan dapat menyebabkan gangguan layanan. Pastikan Anda mematuhi batas tersebut saat memanggil operasi ini.

CallBack

Pesan callback dikirim ke URL callback yang ditentukan oleh parameter CallbackUrl. Contoh kode berikut memberikan ilustrasi:

Request:

POST /callbackURL

Body
application/json

{
    "MsgId": "Message ID",
    "MsgTimestamp": 12312324, // Stempel waktu UNIX saat pesan dikirim.
    "SubscribeID": "Subscription ID",
    "AppId":"",     // ID aplikasi tempat pesan dihasilkan.
    "ChannelID":"", // ID channel tempat pesan dihasilkan.
    "Contents": [
      {
        "Event": "UserEvent",// Tipe event yang di-subscribe. Dalam kasus ini, tipe event adalah event pengguna.
        "UserEvent": {
          "UserId": "80331631628*****",    // ID pengguna.
          "EventTag": "Publish",    // Event. Nilai yang valid: Join, Leave, Publish, Unpublish, dan Roleupdate.
          "SessionId": "0dr15rrnhkz0jnvz6o8sxo0*****", // ID sesi tempat event dihasilkan.
          "Timestamp": 1609854786,    // Stempel waktu UNIX saat event terjadi.
          "Reason": 1, // Alasan bergabung atau meninggalkan channel. Parameter ini hanya tersedia jika event adalah event Join.
          "Role": 1, // Peran pengguna. Peran meliputi streamer dan viewer.
          "CurrentMedias":"1,2,3"// Jenis aliran yang diambil oleh pengguna.
        }
      },
      {
        "Event": "ChannelEvent",// Tipe event yang di-subscribe. Dalam kasus ini, tipe event adalah event channel.
        "ChannelEvent": {
          "ChannelId": "88888****",
          "EventTag": "Open",   // Event. Nilai yang valid: Open dan Close.
          "Timestamp": 1609854530 // Stempel waktu UNIX saat event terjadi.
        }
      }
   ]
}

Response 
HTTP STATUS 200

Parameter event pengguna

Parameter event channel

Otentikasi callback

Otentikasi callback diaktifkan secara default. Logika otentikasi berikut berlaku:

• Saat ApsaraVideo Live memulai permintaan callback, header Ali-Rtc-Timestamp dan Ali-Rtc-Signature disertakan dalam permintaan HTTP atau HTTPS sehingga server penerima pesan callback dapat mengotentikasi signature. Nilai Ali-Rtc-Timestamp dihitung berdasarkan rumus berikut: Ali-Rtc-Signature=MD5SUM(MD5CONTENT). Dalam rumus tersebut, MD5CONTENT adalah string dengan format berikut: Nama domain callback|Nilai Ali-Rtc-Timestamp|Kunci otentikasi. Nama domain callback adalah nama domain dalam URL callback. Kunci otentikasi adalah AppKey aplikasi.

• Setelah menerima pesan callback, server penerima pesan callback menggabungkan nama domain callback, nilai header Ali-Rtc-Timestamp, dan kunci otentikasi dalam format di atas. Server menghitung nilai MD5 dari string tersebut untuk mendapatkan string terenkripsi. Kemudian, server membandingkan string terenkripsi tersebut dengan nilai header Ali-Rtc-Signature dalam permintaan HTTP atau HTTPS yang dikirim oleh Real-Time Communication (RTC). Jika kedua nilai berbeda, permintaan tersebut tidak valid.

Retry callback

Setelah Alibaba Cloud memulai permintaan callback, callback dianggap berhasil hanya jika server bisnis Anda mengembalikan kode status HTTP 200. Jika callback gagal, ApsaraVideo Live mengirim ulang permintaan callback sebanyak 7 kali dengan interval 1 detik, 2 detik, 5 detik, 10 detik, 60 detik, 120 detik, dan 300 detik. Catatan callback dibuat setiap kali permintaan callback dikirim ulang.

Penanganan eksepsi

Mekanisme keep-alive diterapkan antara klien yang telah bergabung ke channel atau memulai pengambilan aliran dan server Alibaba Cloud. Jika server tidak menerima informasi heartbeat dari klien selama 90 detik, server menganggap klien mengalami timeout dan pengguna meninggalkan channel, lalu memicu callback. Heartbeat gagal terdeteksi jika terjadi pemutusan jaringan atau aplikasi keluar secara tidak sengaja.