Tambahkan Source Video melalui API AddCasterVideoResource - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Menambahkan sumber video ke studio produksi. Jumlah sumber video dibatasi oleh jumlah saluran input studio produksi.

Deskripsi operasi

Buat studio produksi sebelum memanggil operasi ini untuk menambahkan sumber video. Jumlah sumber video dibatasi oleh jumlah saluran input studio produksi. Untuk membuat studio produksi menggunakan operasi API, lihat CreateCaster.

Batas QPS

Batas QPS per pengguna tunggal untuk operasi ini adalah 10 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan tepat.

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:AddCasterVideoResource

create

*Caster

acs:live:*:{#accountId}:caster/{#CasterId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
CasterId	string	Yes	ID studio produksi. Jika Anda membuat studio produksi dengan memanggil operasi CreateCaster, periksa nilai parameter CasterId yang dikembalikan oleh operasi CreateCaster. Jika Anda membuat studio produksi di Konsol ApsaraVideo Live, navigasi ke Konsol ApsaraVideo Live > Studio Produksi > Studio Produksi Cloud untuk melihat nama studio produksi. Catatan Nama studio produksi dalam daftar studio produksi pada halaman Studio Produksi Cloud di Konsol ApsaraVideo Live adalah ID studio produksi.	LIVEPRODUCER_POST-cn-0pp1czt****
ResourceName	string	Yes	Nama sumber video.	test001
LocationId	string	No	Pengidentifikasi lokasi sumber video. Parameter ini wajib diisi. Menentukan nomor referensi sebuah scene dalam tata letak. Setiap lokasi dapat dikaitkan dengan paling banyak satu Sumber daya. Format harus sesuai dengan "RV01~RV12", yaitu RV + angka dalam rentang `[01~99]`.	RV01
LiveStreamUrl	string	No	URL streaming ApsaraVideo Live. Penting Parameter ini wajib diisi ketika jenis sumber video adalah aliran langsung. Jangan sertakan parameter ini dalam permintaan ketika jenis sumber video bukan aliran langsung.	rtmp://guide.aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201**?auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5**
MaterialId	string	No	ID materi pustaka aset media. Penting Parameter ini tersedia dan wajib diisi hanya ketika jenis sumber video adalah materi. Jika Anda memanggil operasi DescribeCasterConfig untuk mengkueri konfigurasi studio produksi, periksa nilai parameter UrgentMaterialId yang dikembalikan oleh operasi DescribeCasterConfig. Catatan Nilai UrgentMaterialId adalah ID materi pustaka aset media.	f080575eb5f4427684fc0715159a****
VodUrl	string	No	URL file video-on-demand. Penting Parameter ini tersedia hanya ketika jenis sumber video adalah video file dan file video belum diimpor ke pustaka aset media. Catatan File video-on-demand terbatas pada format MP4, FLV, dan TS.	http://learn.aliyundoc.com/AppName/StreamName.flv
BeginOffset	integer	No	Offset awal file video. Unit: milidetik. Penting Parameter ini hanya berlaku ketika jenis sumber video adalah video file. Catatan Nilai lebih besar dari 0 menunjukkan bahwa pembacaan dimulai dari waktu offset relatif terhadap frame pertama.	1000
EndOffset	integer	No	Offset akhir file video. Unit: milidetik. Penting Parameter ini hanya berlaku ketika jenis sumber video adalah video file. Nilai lebih besar dari 0: pembacaan berakhir pengatur waktu offset relatif terhadap frame pertama. Nilai kurang dari 0: pembacaan berakhir pengatur waktu offset relatif terhadap frame terakhir.	10000
RepeatNum	integer	No	Jumlah pengulangan video setelah pemutaran selesai. Nilai valid: Penting Parameter ini hanya berlaku ketika jenis sumber video adalah video file. 0 (default): tidak ada pengulangan. -1: mengulang tanpa batas.	0
PtsCallbackInterval	integer	No	Interval callback PTS. Unit: milidetik.	2000
FixedDelayDuration	integer	No	Penundaan tetap untuk video, yang dapat digunakan untuk sinkronisasi subtitle. Unit: ms. Nilai default: 0. Rentang nilai: `[0-5000]`.	0
ImageId	string	No	ID materi gambar pustaka aset media. Catatan Parameter ini tersedia dan wajib diisi hanya ketika jenis sumber video adalah gambar.	a089175eb5f4427684fc0715159a****
ImageUrl	string	No	URL materi gambar. Catatan Parameter ini tersedia hanya ketika jenis sumber video adalah gambar dan file gambar belum diimpor ke pustaka aset media. Format JPG dan PNG didukung. Ukuran file maksimum adalah 10 MB.	http://learn.aliyundoc.com/AppName/image.jpg

Catatan

Jenis sumber video ditentukan berdasarkan jenis Sumber daya dalam URL streaming.

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	CF60DB6A-7FD6-426E-9288-122CC1A52FA7
ResourceId	string	ID Sumber daya. ID ini dapat digunakan sebagai parameter permintaan untuk menghapus atau memodifikasi sumber video di studio produksi.	e5542d98-b08c-46bf-83e9-5b09d08c****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7",
  "ResourceId": "e5542d98-b08c-46bf-83e9-5b09d08c****"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidCasterId.Malformed	%s, please check and try again later.
400	InvalidParameter.Malformed	There are invalid parameters: %s.
400	InvalidUserId.Malformed	%s, please check userId.
400	InvalidLiveStreamUrl.Malformed	%s, please check and try again later.
400	InvalidMaterialId.Malformed	%s, please check and try again later.
400	InvalidVodUrl.Malformed	%s, please check and try again later.
400	ResourceNumberExceed	%s, please check and try again later.
400	MissingParameter	%s.
400	DuplicateLocationID	%s, please check and try again later.
400	UnexpectedLocationID	%s, please check and try again later.
401	IllegalOperation	%s, please check and try again later.
500	InternalError	%s, please try again later.
404	InvalidCaster.NotFound	%s, please check and try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.