Modifikasi Template Live AI Studio dengan API ModifyLiveAIStudio - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Mengubah templat virtual studio tertentu.

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

update

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
StudioName	string	Yes	Nama templat virtual studio. Parameter ini sama dengan parameter StudioName pada operasi pembuatan.	stu02
Description	string	No	Deskripsi kustom.	custom
Width	integer	No	Lebar layar pratinjau. Unit: px.	1920
Height	integer	No	Tinggi layar pratinjau. Unit: px. Lebar × tinggi layar pratinjau hanya mendukung spesifikasi berikut: Lanskap lancar 360P: 640×360 Potret lancar 360P: 360×640 Lanskap definisi standar 480P: 854×480 Potret definisi standar 480P: 480×854 Lanskap HD 720P: 1280×720 Potret HD 720P: 720×1280 Lanskap Full HD 1080P: 1920×1080 Potret Full HD 1080P: 1080×1920.	1080
BackgroundType	string	No	Jenis materi latar belakang. Nilai valid: VOD: video on demand PIC: gambar LIVE: aliran langsung. Valid values: VOD : Video on demand. PIC : Gambar. LIVE : Aliran langsung	VOD
BackgroundResourceId	string	No	ID sumber daya VOD dari materi latar belakang. Dapatkan ini dari konsol VOD.	d0eb493192c771efba644531858c0102
BackgroundResourceUrl	string	No	URL akses sumber daya materi latar belakang.	https://xxx.com/2.mp4
MediaType	string	No	Jenis materi multimedia. Nilai valid: VOD: video on demand PIC: gambar LIVE: aliran langsung. Valid values: VOD : Video on demand. PIC : Gambar. LIVE : Aliran langsung	VOD
MediaResourceId	string	No	ID resource VOD materi multimedia. Dapatkan dari konsol VOD.	d0eb493192c771efba644531858c01102
MediaResourceUrl	string	No	URL akses resource materi multimedia. Parameter ini atau ID resource harus disediakan.	https://xxx.com/1.mp4
MediaLayout	object	No	Informasi posisi tata letak materi multimedia.
PositionX	number	No	Parameter posisi, koordinat X. Rentang nilai: 0~1. Posisi materi menggunakan sudut kiri atas sebagai titik referensi.	0
PositionY	number	No	Parameter posisi, koordinat Y. Rentang nilai: 0~1. Posisi materi menggunakan sudut kiri atas sebagai titik referensi.	0
HeightNormalized	number	No	Nilai tinggi ternormalisasi materi, yaitu rasio tinggi materi terhadap latar belakang. Rentang nilai: 0~1.	0.5
MattingType	string	Yes	Jenis matting. Nilai valid: green: matting layar hijau blue: matting layar biru complex: matting adegan nyata. Valid values: green : Matting layar hijau. blue : Matting layar biru. complex : Matting adegan nyata.	complex
MattingLayout	object	Yes	Informasi posisi tata letak aliran sumber setelah matting.
PositionX	number	No	Parameter posisi, koordinat X. Rentang nilai: 0~1. Posisi materi menggunakan sudut kiri atas sebagai titik referensi.	0
PositionY	number	No	Parameter posisi, koordinat Y. Rentang nilai: 0~1. Posisi materi menggunakan sudut kiri atas sebagai titik referensi.	0
HeightNormalized	number	No	Nilai tinggi ternormalisasi, yaitu rasio tinggi potret hasil matting terhadap latar belakang. Rentang nilai: 0~1.	0.5

Elemen respons

Element	Type	Description	Example
	object	Struktur tanggapan.
RequestId	string	ID permintaan.	0BA6B3C4-525A-5381-A2B0-5351323F31C5

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0BA6B3C4-525A-5381-A2B0-5351323F31C5"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	LiveServiceNotFound	%s, please check and try again later.
400	InvalidParameter.PurchaseTime	%s, please check and try again later.
400	InvalidParameter.ExpireTime	%s, please check and try again later.
400	MissingParameter	%s.
400	InvalidChargeType.Malformed	%s, please check and try again later.
400	InvalidChargeType.PostSupport	%s, please check and try again later.
400	InvalidCasterTemplate.Malformed	%s, please check and try again later.
400	InvalidParameter.Malformed	There are invalid parameters: %s.
400	InvalidParameter.ChargeType	%s, please check and try again later.
400	InvalidPeriod.Malformed	%s, please check and try again later.
400	InvalidUserId.Malformed	%s, please check userId.
400	InvalidClientToken.Malformed	%s, please check and try again later.
400	IncorrectCasterStatus	%s, please check and try again later.
401	CasterNumberExceed	%s, please check and try again later.
403	PermissionDenied	%s, please check and try again later.
404	InvalidParameter.NormType	%s, please check and try again later.
404	InvalidConfiguration.NotFound	%s, please check and try again later.
408	ModifyLiveAIStudio.Timeout	%s, please try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.