ModifyCasterLayout - ApsaraVideo Live: Central de Documentação do Alibaba Cloud

Modifica uma configuração de layout. Apenas os itens a serem modificados precisam ser passados. Itens que não requerem modificação não precisam ser incluídos.

Descrição da operação

Crie um estúdio de produção chamando primeiro a operação CreateCaster e, em seguida, chame esta operação para modificar a configuração de layout. Apenas os itens a serem modificados precisam ser passados. Itens que não requerem modificação não precisam ser incluídos. Atualmente, esta operação suporta os seguintes modos de preenchimento de elemento: padrão e adaptativo.

Limite de QPS

O limite de QPS por usuário para esta operação é de 10 chamadas por segundo. Se o limite for excedido, a chamada de API será limitada, o que pode afetar seus negócios. Chame esta operação adequadamente.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

live:ModifyCasterLayout

update

*Caster

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região.	cn-shanghai
VideoLayer	array<object>	Sim	As informações de vídeo.
	object	Não	As informações de vídeo.
FillMode	string	Não	O modo de preenchimento do elemento. none (padrão): sem preenchimento. As configurações da camada são configuradas com a imagem como alvo. fit: adaptativo. As configurações da camada são configuradas com a área de preenchimento (caixa) como alvo. A imagem é dimensionada com base na proporção original e centralizada dentro da área de preenchimento (caixa) usando um método de alinhamento pela borda longa. Se a proporção da área de preenchimento não corresponder à imagem, as bordas curtas não são preenchidas (a imagem da camada inferior é exibida. Se nenhuma camada inferior for configurada, o fundo preto padrão é exibido).	fit
FixedDelayDuration	integer	Não	O atraso fixo para o vídeo. Isso pode ser usado para sincronização de legendas. Unidade: milissegundos. Valor padrão: 0. Valores válidos: 0 a 5000.	5000
HeightNormalized	number	Não	A proporção de altura normalizada do elemento da camada. Se o modo sem preenchimento for usado, a largura do elemento será dimensionada proporcionalmente com base nesta altura. Valor padrão: 0, o que indica que a imagem é exibida em seu tamanho original. Se o modo adaptativo for usado, este campo é obrigatório e deve ser maior que 0. Ele especifica a proporção de altura normalizada da área de preenchimento (caixa).	1
PositionNormalized	array	Não	Os valores de posição normalizados `[x,y]` do elemento da camada. Valor padrão: `[0,0]`. null Nota: Os valores x e y devem ser normalizados.	0.3
	number	Não	Os valores de posição normalizados `[x,y]` do elemento da camada. Valor padrão: `[0,0]`. null Nota: Os valores x e y devem ser normalizados.	0.5
PositionRefer	string	Não	A coordenada de referência para a posição do elemento. Valores válidos: topLeft (padrão): canto superior esquerdo. topRight: canto superior direito. bottomLeft: canto inferior esquerdo. bottomRight: canto inferior direito. center: centro. topCenter: centro superior. bottomCenter: centro inferior. leftCenter: centro esquerdo. rightCenter: centro direito.	topLeft
WidthNormalized	number	Não	A proporção de largura normalizada do elemento da camada. Se o modo sem preenchimento for usado, a altura do elemento será dimensionada proporcionalmente com base nesta largura. Valor padrão: 0, o que indica que a imagem é exibida em seu tamanho original. Se o modo adaptativo for usado, este campo é obrigatório e deve ser maior que 0. Ele especifica a proporção de largura normalizada da área de preenchimento (caixa).	1
AudioLayer	array<object>	Sim	As informações de áudio.
	object	Não	As informações de áudio.
FixedDelayDuration	integer	Não	O atraso fixo para o áudio. Isso pode ser usado para sincronização de legendas. Unidade: milissegundos. Valor padrão: 0. Valores válidos: 0 a 5000.	5000
ValidChannel	string	Não	Os canais de áudio que podem ser usados como entrada de volume. Valores válidos: leftChannel: canal esquerdo. rightChannel: canal direito. all (padrão): ambos os canais.	all
VolumeRate	number	Não	A proporção de altura normalizada do elemento da camada. A largura do elemento é dimensionada proporcionalmente com base nesta altura. Valor padrão: 0, o que indica que o elemento é exibido em seu tamanho original.	1
BlendList	array	Sim	O ID de localização (LocationId) do elemento de recurso de vídeo. Para o LocationId, consulte Adicionar uma fonte de vídeo. Os elementos correspondem aos elementos VideoLayers em ordem.	RV02
	string	Não	O ID de localização (LocationId) do elemento de recurso de vídeo. Para o LocationId, consulte Adicionar uma fonte de vídeo. Os elementos correspondem aos elementos VideoLayers em ordem.	RV02
MixList	array	Sim	O ID de localização (LocationId) do elemento de recurso de áudio. Para o LocationId, consulte Adicionar uma fonte de vídeo. Os elementos correspondem aos elementos AudioLayers em ordem.	RV02
	string	Não	O ID de localização (LocationId) do elemento de recurso de áudio. Para o LocationId, consulte Adicionar uma fonte de vídeo. Os elementos correspondem aos elementos AudioLayers em ordem.	RV02
CasterId	string	Sim	O ID do estúdio de produção. Se você criou o estúdio de produção chamando a operação CreateCaster, verifique o parâmetro CasterId retornado pela operação CreateCaster. Se você criou o estúdio de produção no console do ApsaraVideo Live, acesse Console do ApsaraVideo Live > Estúdio de Produção > Estúdio de Produção em Nuvem para visualizar o ID. null O nome do estúdio de produção na lista de estúdios de produção na página Estúdio de Produção em Nuvem do console do ApsaraVideo Live é o ID do estúdio de produção.	LIVEPRODUCER_POST-cn-0pp1czt****
LayoutId	string	Sim	O ID do layout. Se você adicionou o layout do estúdio de produção chamando a operação AddCasterLayout, verifique o parâmetro LayoutId retornado pela operação AddCasterLayout.	21926b36-7dd2-4fde-ae25-51b5bc8e****

null

N nos parâmetros da solicitação indica o número de sequência do elemento. Por exemplo, VideoLayer.N.FillMode especifica o modo de preenchimento do enésimo elemento. VideoLayer.1.FillMode especifica o modo de preenchimento do primeiro elemento e VideoLayer.2.FillMode especifica o modo de preenchimento do segundo elemento.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
LayoutId	string	O ID do layout. Isso pode ser usado como um parâmetro de solicitação para consultar a lista de layouts do estúdio de produção.	21926b36-7dd2-4fde-ae25-51b5bc8e****
RequestId	string	O ID da solicitação.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.