ModifyCasterLayout - - Alibaba Cloud Dokümantasyon Merkezi

Bir düzen yapılandırmasını değiştirir. Yalnızca değiştirilecek öğelerin iletilmesi gerekir. Değişiklik gerektirmeyen öğelerin dahil edilmesine gerek yoktur.

Operation description

Önce CreateCaster işlemi çağrılarak bir yapım stüdyosu oluşturun, ardından düzen yapılandırmasını değiştirmek için bu işlemi çağırın. Yalnızca değiştirilecek öğelerin iletilmesi gerekir. Değişiklik gerektirmeyen öğelerin dahil edilmesine gerek yoktur. Bu işlem şu anda aşağıdaki öğe dolgu modlarını destekler: varsayılan ve uyarlanabilir.

QPS sınırı

Bu işlem için tek kullanıcılık QPS sınırı saniyede 10 çağrıdır. Sınır aşılırsa API çağrısı kısıtlanır ve bu durum işinizi etkileyebilir. Bu işlemi uygun şekilde çağırın.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

live:ModifyCasterLayout

update

*Caster

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

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	No	Bölge kimliği.	cn-shanghai
VideoLayer	array<object>	Yes	Video bilgileri.
	object	No	Video bilgileri.
FillMode	string	No	Öğe dolgu modu. none (varsayılan): dolgu yok. Katman ayarları hedef olarak görüntü ile yapılandırılır. fit: uyarlanabilir. Katman ayarları hedef olarak dolgu alanı (kutucuk) ile yapılandırılır. Görüntü orijinal en-boy oranına göre ölçeklendirilir ve uzun kenar hizalama yöntemi kullanılarak dolgu alanının (kutucuk) ortasına yerleştirilir. Dolgu alanının en-boy oranı görüntüyle eşleşmiyorsa kısa kenarlar doldurulmaz (alt katman görüntüsü görüntülenir. Alt katman yapılandırılmamışsa varsayılan siyah arka plan görüntülenir).	fit
FixedDelayDuration	integer	No	Video için sabit gecikme. Bu, altyazı senkronizasyonu için kullanılabilir. Birim: milisaniye. Varsayılan değer: 0. Geçerli değerler: 0 ile 5000 arası.	5000
HeightNormalized	number	No	Katman öğesinin normalleştirilmiş yükseklik oranı. Dolgusuz mod kullanılıyorsa öğenin genişliği bu yüksekliğe göre orantılı olarak ölçeklendirilir. Varsayılan değer: 0, bu da görüntünün orijinal boyutunda görüntülendiğini belirtir. Uyarlanabilir mod kullanılıyorsa bu alan zorunludur ve 0'dan büyük olmalıdır. Dolgu alanının (kutucuk) normalleştirilmiş yükseklik oranını belirtir.	1
PositionNormalized	array	No	Katman öğesinin normalleştirilmiş konum değerleri `[x,y]`. Varsayılan değer: `[0,0]`. Not Not: x ve y değerleri normalleştirilmiş olmalıdır.	0.3
	number	No	Katman öğesinin normalleştirilmiş konum değerleri `[x,y]`. Varsayılan değer: `[0,0]`. Not Not: x ve y değerleri normalleştirilmiş olmalıdır.	0.5
PositionRefer	string	No	Öğenin konumu için referans koordinatı. Geçerli değerler: topLeft (varsayılan): sol üst. topRight: sağ üst. bottomLeft: sol alt. bottomRight: sağ alt. center: orta. topCenter: üst orta. bottomCenter: alt orta. leftCenter: sol orta. rightCenter: sağ orta.	topLeft
WidthNormalized	number	No	Katman öğesinin normalleştirilmiş genişlik oranı. Dolgusuz mod kullanılıyorsa öğenin yüksekliği bu genişliğe göre orantılı olarak ölçeklendirilir. Varsayılan değer: 0, bu da görüntünün orijinal boyutunda görüntülendiğini belirtir. Uyarlanabilir mod kullanılıyorsa bu alan zorunludur ve 0'dan büyük olmalıdır. Dolgu alanının (kutucuk) normalleştirilmiş genişlik oranını belirtir.	1
AudioLayer	array<object>	Yes	Ses bilgileri.
	object	No	Ses bilgileri.
FixedDelayDuration	integer	No	Ses için sabit gecikme. Bu, altyazı senkronizasyonu için kullanılabilir. Birim: milisaniye. Varsayılan değer: 0. Geçerli değerler: 0 ile 5000 arası.	5000
ValidChannel	string	No	Ses seviyesi girişi olarak kullanılabilecek ses kanalları. Geçerli değerler: leftChannel: sol kanal. rightChannel: sağ kanal. all (varsayılan): her iki kanal.	all
VolumeRate	number	No	Katman öğesinin normalleştirilmiş yükseklik oranı. Öğenin genişliği bu yüksekliğe göre orantılı olarak ölçeklendirilir. Varsayılan değer: 0, bu da öğenin orijinal boyutunda görüntülendiğini belirtir.	1
BlendList	array	Yes	Video kaynağı öğesinin konum kimliği (LocationId). LocationId için Video kaynağı ekleme konusuna bakın. Öğeler sırasıyla VideoLayers öğelerine karşılık gelir.	RV02
	string	No	Video kaynağı öğesinin konum kimliği (LocationId). LocationId için Video kaynağı ekleme konusuna bakın. Öğeler sırasıyla VideoLayers öğelerine karşılık gelir.	RV02
MixList	array	Yes	Ses kaynağı öğesinin konum kimliği (LocationId). LocationId için Video kaynağı ekleme konusuna bakın. Öğeler sırasıyla AudioLayers öğelerine karşılık gelir.	RV02
	string	No	Ses kaynağı öğesinin konum kimliği (LocationId). LocationId için Video kaynağı ekleme konusuna bakın. Öğeler sırasıyla AudioLayers öğelerine karşılık gelir.	RV02
CasterId	string	Yes	Yapım stüdyosu kimliği. Yapım stüdyosunu CreateCaster işlemi çağrısını yaparak oluşturduysanız CreateCaster işlemi tarafından döndürülen CasterId parametresini kontrol edin. Yapım stüdyosunu ApsaraVideo Live konsolunda oluşturduysanız kimliği görüntülemek için ApsaraVideo Live konsolu > Yapım Stüdyosu > Bulut Yapım Stüdyosu yolunu izleyin. Not ApsaraVideo Live konsolunun Bulut Yapım Stüdyosu sayfasındaki yapım stüdyosu listesinde yer alan yapım stüdyosu adı, yapım stüdyosu kimliğidir.	LIVEPRODUCER_POST-cn-0pp1czt****
LayoutId	string	Yes	Düzen kimliği. Yapım stüdyosu düzenini AddCasterLayout işlemi çağrısını yaparak eklediyseniz AddCasterLayout işlemi tarafından döndürülen LayoutId parametresini kontrol edin.	21926b36-7dd2-4fde-ae25-51b5bc8e****

Not

İstek parametrelerindeki N, öğenin sıra numarasını belirtir. Örneğin, VideoLayer.N.FillMode N'inci öğenin dolgu modunu belirtir. VideoLayer.1.FillMode birinci öğenin dolgu modunu, VideoLayer.2.FillMode ise ikinci öğenin dolgu modunu belirtir.

Response elements

Element	Type	Description	Example
	object
LayoutId	string	Düzen kimliği. Bu, yapım stüdyosu düzenleri listesini sorgulamak için bir istek parametresi olarak kullanılabilir.	21926b36-7dd2-4fde-ae25-51b5bc8e****
RequestId	string	İstek kimliği.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Examples

Success response

JSON format

{
  "LayoutId": "21926b36-7dd2-4fde-ae25-51b5bc8e****",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidCasterId.Malformed	%s, please check and try again later.	The parameter CasterId is invalid, please check and try again.
400	InvalidUserId.Malformed	%s, please check userId.	The userId passed in is invalid, please check.
400	InvalidLayoutId.Malformed	%s, please check and try again later.	The LayoutId is invalid, please check and try again.
400	InvalidParameter.Malformed	There are invalid parameters: %s.	There are invalid parameters: %s.
400	InvalidVideoLayersAndBlendListSize.Mismatch	%s, please check and try again later.	The size of the VideoLayers does not match the size of the BlendList, please check and try again.
400	InvalidAudioLayersAndMixListSize.Mismatch	%s, please check and try again later.	The size of the AudioLayers does not match the size of the MixList, please check and try again.
400	InvalidPositionNormalized.Malformed	%s, please check and try again later.	The parameter PositionNormalized is invalid, please check and try again.
400	InvalidBlendList.ExceedNorm	%s, please check and try again later.	BlendList size exceeds specification, please check and try again.
400	InvalidMixList.ExceedNorm	%s, please check and try again later.	MixList size exceeds specification, please check and try again.
400	InvalidHeightOrWidthNormalized	%s, please check and try again later.	HeightNormalized or WidthNormalized parameters are invalid, please check and try again.
400	InvalidVideoLayersConfig	%s, please check and try again later.	The size of the VideoLayers does not match the size of the BlendList, please check and try again.
400	InvalidAudioLayersConfig	%s, please check and try again later.	The size of the AudioLayers does not match the size of the MixList, please check and try again.
401	IllegalOperation	%s, please check and try again later.	Operation not allowed, please check and try again.
500	InternalError	%s, please try again later.	Internal error, please try again later.
404	InvalidCaster.NotFound	%s, please check and try again later.	The guide station does not exist, please check and try again.
404	InvalidLayout.NotFound	%s, please check and try again later.	LayoutId does not exist, please check and try again.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.