All Products
Search

This Product

    ApsaraVideo Live:AddLiveStreamMerge

    Document Center

    ApsaraVideo Live:AddLiveStreamMerge

    Last Updated:Dec 13, 2025

    Menambahkan konfigurasi penggabungan aliran primary/backup.

    Deskripsi operasi

    Anda dapat memanggil operasi ini hingga 100 kali per detik per akun. Permintaan yang melebihi batas tersebut akan di-drop dan berpotensi menyebabkan gangguan layanan.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    live:AddLiveStreamMerge

    create

    *Domain

    acs:cdn:*:{#accountId}:domain/{#DomainName}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    ID wilayah.

    cn-shanghai
    DomainName

    string

    Yes

    Domain streaming.

    example.com
    AppName

    string

    Yes

    AppName untuk aliran yang digabungkan. Nilai ini harus sesuai dengan AppName dalam URL streaming akhir agar aturan diterapkan. Wildcard (*) tidak diizinkan.

    app
    StreamName

    string

    Yes

    StreamName untuk aliran yang digabungkan. Nilai ini harus sesuai dengan StreamName dalam URL streaming akhir agar aturan diterapkan. Wildcard (*) tidak diizinkan.

    StreamName
    InAppName1

    string

    Yes

    AppName dari aliran input primary. Nilai ini harus sesuai dengan AppName dalam URL ingest aliran primary.

    app1
    InStreamName1

    string

    Yes

    StreamName dari aliran input primary. Nilai ini harus sesuai dengan StreamName dalam URL ingest aliran primary.

    InStream1
    InAppName2

    string

    Yes

    AppName dari aliran input backup. Nilai ini harus sesuai dengan AppName dalam URL ingest aliran backup.

    app2
    InStreamName2

    string

    Yes

    StreamName dari aliran input backup. Nilai ini harus sesuai dengan StreamName dalam URL ingest aliran backup.

    stream2
    StartTime

    string

    Yes

    Waktu ketika aturan penggabungan menjadi aktif, dalam UTC.

    Format: yyyy-MM-ddTHH:mm:ssZ.

    2020-05-29T00:00:00Z
    EndTime

    string

    Yes

    Waktu ketika aturan penggabungan berakhir, dalam UTC.

    Format: yyyy-MM-ddTHH:mm:ssZ.

    Catatan

    Durasi maksimum antara waktu mulai dan waktu berakhir adalah 7 hari.

    2020-05-29T01:00:00Z
    Protocol

    string

    No

    Protokol dari aliran live input. Nilai yang valid:

    • rtmp (default)

    • rtc

    rtmp
    LiveMerger

    string

    No

    Menentukan engine yang digunakan.

    • on: Menggunakan engine liveswitch baru.

    • off: Menggunakan engine lama, seperti rtmpr. Ini adalah nilai default.

    off
    MergeParameters

    string

    No

    Mengonfigurasi kondisi pemicu failover. Pemicu:

    1. Pemutusan aliran eksplisit, seperti EOF dan error jaringan.

    2. Laju stutter melebihi 60% dalam 5 detik terakhir.

    3. Tidak ada data frame yang diterima selama 2 detik.

    4. Laju frame rata-rata turun di bawah ali_low_frame_rate_threshold dalam rentang ali_max_no_frame_timeout detik terakhir, meskipun tanpa stuttering.

    5. Jika block_all_jitter diatur ke 1, Aturan 2, 3, dan 4 tidak berlaku.

    Nilai yang valid:

    • ali_low_frame_rate_threshold: (1,200).

    • ali_max_no_frame_timeout: (2,10)

    • block_all_jitter: 0 atau 1.

    ali_low_frame_rate_threshold=10&ali_max_no_frame_timeout=5&block_all_jitter=0
    Catatan

    Nilai AppName, InAppName1, dan InAppName2 harus saling unik. Demikian pula, nilai StreamName, InStreamName1, dan InStreamName2 juga harus saling unik.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    16A96B9A-F203-4EC5-8E43-CB92E68F****
    Message

    string

    • Informasi tambahan. Biasanya berupa deskripsi singkat tentang kegagalan panggilan untuk membantu Anda mengidentifikasi masalah.

    • Nilai yang valid: OK, config invalid, degrade to no livemerger.

    OK

    Pesan "config invalid, degrade to no livemerger" menunjukkan bahwa konfigurasi untuk engine liveswitch baru tidak lengkap. Sistem secara otomatis menurunkan spesifikasi ke engine lama.

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****",
  "Message": "OK"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidStartTime.Malformed Specified parameter StartTime is not valid.
    400 InvalidEndTime.Malformed Specified parameter EndTime is not valid.
    400 InvalidStartTime.ValueNotSupported The specified value of parameter StartTime is not supported. The value specified for the StartTime parameter is invalid.
    400 InvalidParam Parameter invalid. Illegal input parameters
    400 QuotaExceeded.Merge Exceed max merge count limit
    400 ConfigAlreadyExists Config has already exist.
    400 Duration.Exceed Duration between StartTime and EndTime is too long.
    400 InvalidParam.CodeIllegalDuration %s. The value of start time should be less than the value of end time .
    500 InternalError The request processing has failed due to backend service exception.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.