全部产品
Search
文档中心

ApsaraVideo Live:Callbacks untuk perekaman live stream

更新时间:Jul 06, 2025

Topik ini menjelaskan cara mengonfigurasi callbacks untuk perekaman live stream dan menyediakan contoh callbacks.

Metode konfigurasi callback

Anda dapat mengonfigurasi callbacks untuk perekaman live stream di konsol ApsaraVideo Live atau dengan memanggil operasi API.
  • 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 untuk perekaman live stream mencakup callbacks status rekaman dan callbacks pembuatan rekaman.
  • 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

    Catatan

    Anda 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

    ParameterDeskripsi
    domainDomain streaming.
    appNama aplikasi.
    streamNama live stream.
    eventNama 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

    ParameterDeskripsi
    domainDomain streaming.
    appNama aplikasi.
    streamNama live stream.
    uriJalur penyimpanan rekaman di bucket Object Storage Service (OSS) yang ditentukan.
    durationDurasi rekaman. Satuan: detik.
    start_timeWaktu mulai rekaman. Waktu ini adalah timestamp UNIX. Satuan: detik.
    stop_timeWaktu akhir rekaman. Waktu ini adalah timestamp UNIX. Satuan: detik.
    push_argsParameter 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.