Referensi konfigurasi penggabungan live stream - ApsaraVideo Live

Mengambil konfigurasi merge 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 dapat 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:DescribeLiveStreamMerge

get

*Domain

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
DomainName	string	Yes	Domain streaming.	example.com
AppName	string	No	AppName untuk aliran yang digabungkan. Lihat AppName pada halaman Pengaturan Penggabungan Aliran Primary/Secondary.	app
StreamName	string	No	StreamName untuk aliran yang digabungkan. Lihat StreamName pada halaman Pengaturan Penggabungan Aliran Primary/Secondary.	StreamName
Protocol	string	No	Protokol streaming. Nilai yang valid: rtmp (default) rtc	rtmp

Elemen respons

Element	Type	Description	Example
	object
LiveStreamMergeList	object
LiveStreamMerge	array<object>	Informasi aliran live.
	object	Informasi aliran live.
AppName	string	AppName untuk aliran yang digabungkan.	app
AppUsing	string	AppName dari aliran input yang sedang aktif.	app1
DomainName	string	Domain streaming.	example.com
EndTime	string	Waktu berakhir penggabungan aliran.	2020-05-29T01:00:00Z
ExtraInAppStreams	string	Aliran input ke-3 hingga ke-N untuk penggabungan.	app3/stream3,app4/stream4,app5/stream5,…,appN/streamN
InAppName1	string	AppName dari aliran input primary.	app1
InAppName2	string	AppName dari aliran input backup.	app2
InStreamName1	string	StreamName dari aliran input primary.	InStream1
InStreamName2	string	StreamName dari aliran input backup.	stream2
Protocol	string	Protokol aliran live input.	rtmp
StartTime	string	Waktu mulai penggabungan aliran.	2020-05-29T00:00:00Z
StreamName	string	StreamName untuk aliran yang digabungkan.	StreamName
StreamUsing	string	StreamName dari aliran input yang sedang aktif.	InStream1
LiveMerger	string	Menunjukkan apakah mesin liveswitch digunakan untuk task saat ini. Valid values: off : off on : on	on
MergeParameters	string	Kondisi pemicu failover. Pemicu: Pemutusan aliran eksplisit, seperti EOF dan error jaringan. Laju stutter melebihi 60% dalam 5 detik terakhir. Tidak ada data frame yang diterima selama 2 detik. Rata-rata laju frame turun di bawah `ali_low_frame_rate_threshold` dalam `ali_max_no_frame_timeout` detik terakhir, meskipun tanpa stuttering. Jika block_all_jitter diatur ke 1, Aturan 2, 3, dan 4 tidak berlaku. Nilai yang valid: ali_max_no_frame_timeout: (2,10) ali_low_frame_rate_threshold: (1,200). block_all_jitter: 0 atau 1.	ali_low_frame_rate_threshold=10&ali_max_no_frame_timeout=5&block_all_jitter=0
RequestId	string	ID permintaan.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Contoh

Respons sukses

JSONformat

{
  "LiveStreamMergeList": {
    "LiveStreamMerge": [
      {
        "AppName": "app",
        "AppUsing": "app1",
        "DomainName": "example.com",
        "EndTime": "2020-05-29T01:00:00Z",
        "ExtraInAppStreams": "app3/stream3,app4/stream4,app5/stream5,…,appN/streamN",
        "InAppName1": "app1",
        "InAppName2": "app2",
        "InStreamName1": "InStream1",
        "InStreamName2": "stream2",
        "Protocol": "rtmp",
        "StartTime": "2020-05-29T00:00:00Z",
        "StreamName": "StreamName",
        "StreamUsing": "InStream1",
        "LiveMerger": "on",
        "MergeParameters": "ali_low_frame_rate_threshold=10&ali_max_no_frame_timeout=5&block_all_jitter=0\n"
      }
    ]
  },
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidParam	Parameter invalid.
400	QuotaExceeded.Merge	Exceed max merge count limit
400	ConfigAlreadyExists	Config has already exist.
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.