Perekaman sesuai permintaan - ApsaraVideo Live

Setelah mengonfigurasi perekaman, Anda dapat menentukan apakah akan merekam aliran langsung sesuai permintaan.

Anda dapat menerapkan perekaman sesuai permintaan dengan menggunakan salah satu metode berikut:

Tetapkan parameter ingest. Metode ini akan didukung di masa mendatang.
Gunakan metode callback HTTP.
Untuk menerapkan perekaman sesuai permintaan menggunakan metode callback HTTP, tentukan URL callback dan nama domain, aplikasi, atau aliran langsung. Ketika layanan perekaman menerima aliran langsung yang ditentukan atau aliran dari nama domain atau aplikasi tertentu, layanan tersebut mengirim permintaan ke URL callback untuk memastikan apakah aliran langsung perlu direkam. Permintaan ini mencakup lima parameter yang dijelaskan dalam tabel berikut.

Catatan Untuk informasi lebih lanjut tentang cara mengonfigurasi perekaman sesuai permintaan, lihat Perekaman sesuai permintaan.

Parameter permintaan

Parameter	Tipe	Deskripsi
domain	String	Nama domain streaming utama.
app	String	Nama aplikasi tempat aliran langsung dimiliki.
stream	String	Nama aliran langsung.
codec	String	Format penyandian. Nilai valid: h264 h265
vbitrate	String	Bitrate video. Satuan: Kbit/s.

Parameter respons

Parameter	Tipe	Diperlukan	Deskripsi
ApiVersion	String	Tidak	Versi API. Versi default adalah 1.0.
NeedRecord	Bool	Ya	Menunjukkan apakah perekaman diperlukan.
Interval	JSONObject	Tidak	Durasi perekaman dalam setiap format di setiap siklus. Nilai valid: 5 to 21600. Satuan: detik.
Format	JSONArray	Tidak	Format perekaman. Perekaman dapat dalam format MP4, FLV, atau M3U8.

Contoh

Permintaan sampel

GET /?app=seq_all&domain=demo.aliyundoc.com&stream=ondemand8&vbitrate=2000&codec=h264 HTTP/1.1
Host: example.aliyundoc.com
User-Agent: Go-http-client/1.1
Accept-Encoding: gzip

Parameter respons

{
    "ApiVersion" : "1.0",
    "NeedRecord" : true,
    "Interval" : {
        "Mp4": 300,
        "Flv": 120,
        "M3U8": 180
    },
    "Format" : ["mp4","flv"]
}

Pemrosesan parameter respons

ApsaraVideo Live menggunakan pengaturan parameter yang dikembalikan untuk menimpa atau memodifikasi konfigurasi perekaman yang ada. Sebagai contoh, jika parameter Interval dikembalikan, ApsaraVideo Live menggunakan nilai tersebut untuk menimpa nilai parameter Interval dalam konfigurasi perekaman yang ada. Jika parameter Format dikembalikan, ApsaraVideo Live menggunakan irisan dari format yang ditentukan oleh parameter Format yang dikembalikan dan format yang tercantum dalam konfigurasi perekaman yang ada. Jika format yang ditentukan oleh parameter Format yang dikembalikan tidak tersedia dalam konfigurasi perekaman yang ada, aliran langsung tidak direkam.

Catatan

Jika kode status HTTP non-200 dikembalikan, pemanggilan operasi gagal.
Badan permintaan tidak boleh melebihi 2.048 karakter. Jika melebihi batas tersebut, badan akan dipotong untuk mencegah serangan jahat.

Catatan penggunaan

ApsaraVideo Live mendukung penarikan aliran yang dipicu, yang secara otomatis memicu ApsaraVideo Live untuk menarik aliran langsung ketika URL streaming dengan nama domain tertentu digunakan untuk pemutaran. Jika tidak ada aliran langsung yang diputar, ApsaraVideo Live tidak menarik aliran langsung dari server asal. Dalam hal ini, perekaman otomatis, perekaman sesuai permintaan, dan perekaman manual dinonaktifkan.