ModifyCasterComponent - - Alibaba Cloud Dokümantasyon Merkezi

Bir yapım stüdyosu bileşenini değiştirir.

Operation description

Metin, görüntü veya çeviri altyazısı bileşeni gibi bir yapım stüdyosu bileşenini değiştirmek için bu işlemi çağırabilirsiniz.

QPS sınırları

Tek bir kullanıcı için saniyedeki sorgu (QPS) sınırı saniyede 10 çağrıdır. Sınır aşılırsa API çağrıları kısıtlanır ve bu durum işinizi etkileyebilir. Bu işlemi gerektiği ş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:ModifyCasterComponent

update

*Caster

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

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	No	Bölge kimliği.	cn-shanghai
CasterId	string	Yes	Yapım stüdyosunun kimliği. Bu kimlik, CreateCaster işlemini çağırdıktan sonra döndürülür. LIVE konsolunda bir yapım stüdyosu oluşturursanız, kimliği bulmak için LIVE > Yapım Stüdyosu > Bulut Yapım Stüdyosu sayfasına gidin. Not Bulut Yapım Stüdyosu sayfasındaki listede yer alan yapım stüdyosu adı, yapım stüdyosu kimliğidir.	LIVEPRODUCER_POST-cn-0pp1czt****
ComponentId	string	Yes	Bileşen kimliği. Bu kimlik, AddCasterComponent işlemini çağırdıktan sonra döndürülür.	05ab713c-676e-49c0-96ce-cc408da1****
ComponentName	string	No	Bileşenin adı. Varsayılan değer, bileşen kimliğidir.	text01
ComponentType	string	No	Bileşenin türü. Geçerli değerler: text: Metin bileşeni. TextLayerContent parametresi yalnızca ComponentType değerini text olarak ayarlarsanız gereklidir. image: Görüntü bileşeni. ImageLayerContent parametresi yalnızca ComponentType değerini image olarak ayarlarsanız gereklidir. caption: Çeviri altyazısı bileşeni. CaptionLayerContent parametresi yalnızca ComponentType değerini caption olarak ayarlarsanız gereklidir.	text
Effect	string	No	Bileşenin görüntüleme efekti. Geçerli değerler: none (varsayılan): efekt yok. animateH: yatay kaydırma. animateV: dikey kaydırma.	animateV
ComponentLayer	string	No	Katmanın boyutu ve düzeni. Değer bir JSON dizesidir. Aşağıdaki özellikler desteklenir: HeightNormalized: Normalleştirilmiş yükseklik. WidthNormalized: Normalleştirilmiş genişlik. PositionNormalized: Katmanın normalleştirilmiş konumu. PositionRefer: Katman konumu için referans noktası.	{"HeightNormalized":"1","PositionRefer":"topRight","WidthNormalized":"0","PositionNormalized":["0.1","0.2"]}
TextLayerContent	string	No	Metin katmanının özellikleri. Değer bir JSON dizesidir. Aşağıdaki özellikler desteklenir: Önemli ComponentType değerini text olarak ayarlarsanız bu parametre gereklidir. SizeNormalized: Normalleştirilmiş yazı tipi boyutu. Yazı tipi boyutu şu formül kullanılarak hesaplanır: font_size/output_height. Değer `[0,1]` aralığında olmalıdır. Hesaplanan yazı tipi boyutu 1024'ten büyükse 1024 değeri kullanılır. BorderWidthNormalized: Metin kenarlığının normalleştirilmiş genişliği. Normalleştirilmiş genişlik, yazı tipi boyutuna göre şu formül kullanılarak hesaplanır: BorderWidth/FontSize. Değer `[0,1]` aralığında olmalıdır. Hesaplanan değer 16'dan büyükse 16 değeri kullanılır. Varsayılan değer: 0. FontName: Yazı tipi adı. Geçerli değerler hakkında daha fazla bilgi için Yapım stüdyosu yazı tipleri bölümüne bakın. Varsayılan değer: KaiTi. BorderColor: Metin kenarlığının rengi. Geçerli değerler 0x000000 ile 0xffffff arasındadır. Varsayılan değer boş bir dizedir ve bu parametrenin kullanılmadığını gösterir. Text: Metin içeriği. Varsayılan değer boş bir dizedir. Color: Metnin rengi. Varsayılan değer: kırmızı olan 0xff0000.	{"BorderWidthNormalized":"1","SizeNormalized":"0.2","Color":"0x000000","FontName":"KaiTi","BorderColor":"0x000000","Text":"hello world!"}
ImageLayerContent	string	No	Görüntü katmanının özellikleri. Değer bir JSON dizesidir. Önemli ComponentType değerini image olarak ayarlarsanız bu parametre gereklidir. MaterialId, medya varlığı kitaplığındaki materyalin kimliğidir.	{"MaterialId":"6cf724c6ebfd4a59b5b3cec6f10d5ecf"}
CaptionLayerContent	string	No	Altyazı katmanının özellikleri. Değer bir JSON dizesidir. Aşağıdaki özellikler desteklenir: Önemli ComponentType değerini caption olarak ayarlarsanız bu parametre gereklidir. SizeNormalized: Normalleştirilmiş yazı tipi boyutu. Yazı tipi boyutu şu formül kullanılarak hesaplanır: font_size/output_height. Değer `[0,1]` aralığında olmalıdır. Hesaplanan yazı tipi boyutu 1024'ten büyükse 1024 değeri kullanılır. BorderWidthNormalized: Metin kenarlığının normalleştirilmiş genişliği. Normalleştirilmiş genişlik, yazı tipi boyutuna göre şu formül kullanılarak hesaplanır: BorderWidth/FontSize. Değer `[0,1]` aralığında olmalıdır. Hesaplanan değer 16'dan büyükse 16 değeri kullanılır. Varsayılan değer: 0. FontName: Yazı tipi adı. Geçerli değerler hakkında daha fazla bilgi için Yapım stüdyosu yazı tipleri bölümüne bakın. Varsayılan değer: KaiTi. BorderColor: Metin kenarlığının rengi. Geçerli değerler 0x000000 ile 0xffffff arasındadır. Varsayılan değer boş bir dizedir ve bu parametrenin kullanılmadığını gösterir. LocationId: Çeviri kaynağının kanal kimliği. SourceLan: Video kaynağındaki sesin kaynak dili. Geçerli değerler: en (İngilizce), cn (Çince), es (İspanyolca) ve ru (Rusça). Varsayılan değer: cn. TargetLan: Çeviri için hedef dil. Bu parametreyi ayarlamazsanız yalnızca konuşma tanıma gerçekleştirilir. Bu parametreyi ayarlarsanız çeviri de gerçekleştirilir. Geçerli değerler: en (İngilizce), cn (Çince), es (İspanyolca) ve ru (Rusça). ShowSourceLan: Kaynak dilin görüntülenip görüntülenmeyeceğini belirtir. Geçerli değerler: true (görüntüle) ve false (görüntüleme). Varsayılan değer: false. Truncation: Altyazının kısaltılıp kısaltılmayacağını belirtir. Geçerli değerler: true (kısalt) ve false (kısaltma). Varsayılan değer: false. SourceLanPerLineWordCount: Kaynak dil için satır başına kelime sayısı. Bu parametre yalnızca Truncation değeri true olarak ayarlandığında etkili olur. Varsayılan değer: 20. TargetLanPerLineWordCount: Hedef dil için satır başına kelime sayısı. Bu parametre yalnızca Truncation değeri true olarak ayarlandığında etkili olur. Varsayılan değer: 20.	{"BorderWidthNormalized":0.01,"SizeNormalized":0.05,"Color":"0x000000","LocationId":"RV01","SourceLan":"cn","FontName":"KaiTi","BorderColor":"0xffffff"}

Yapım stüdyosu yazı tipleri

Yazı tipi	FontName değeri
KaiTi	KaiTi
Alibaba PuHuiTi-Regular	AlibabaPuHuiTi-Regular
Alibaba PuHuiTi-Bold	AlibabaPuHuiTi-Bold
Alibaba PuHuiTi-Light	AlibabaPuHuiTi-Light
Source Han Sans-Regular	NotoSansHans-Regular
Source Han Sans-Bold	NotoSansHans-Bold
Source Han Sans-Light	NotoSansHans-Light

Response elements

Element	Type	Description	Example
	object
ComponentId	string	Bileşen kimliği. Yapım stüdyosunun bileşenlerini sorgulamak için bu kimliği bir istek parametresi olarak kullanabilirsiniz.	05ab713c-676e-49c0-96ce-cc408da1****
RequestId	string	İstek kimliği.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Examples

Success response

JSON format

{
  "ComponentId": "05ab713c-676e-49c0-96ce-cc408da1****",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidUserId.Malformed	%s, please check userId.	The userId passed in is invalid, please check.
400	InvalidCasterId.Malformed	%s, please check and try again later.	The parameter CasterId is invalid, please check and try again.
400	MissingParameter	%s.	Missing parameter
400	InvalidParameter.Malformed	There are invalid parameters: %s.	There are invalid parameters: %s.
400	InvalidPositionNormalized.Malformed	%s, please check and try again later.	The parameter PositionNormalized is invalid, 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	InvalidComponent.NotFound	%s, please check and try again later.	The component to be operated does not exist. Please check and try again.
404	CanvasNotExist	%s, please check and try again later.	Canvas does not exist, please check and try again.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.