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

Adiciona um layout a um estúdio de produção.

Descrição da operação

Antes de chamar esta operação, você deve criar um estúdio de produção e adicionar fontes de vídeo. Para obter mais informações sobre como criar um estúdio de produção, consulte CreateCaster.

Limites de QPS

O limite de consultas por segundo (QPS) para esta operação é de 10 chamadas por segundo por usuário. As chamadas de API que excederem esse limite serão limitadas, o que pode afetar seus negócios. Não exceda esse limite.

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

create

*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	Os layouts de vídeo.
	object	Não	O layout de vídeo.
FillMode	string	Não	O modo de preenchimento do elemento. Valores válidos: none (padrão): Sem redimensionamento. O vídeo é exibido em seu tamanho original. fit: O vídeo é redimensionado para caber na área de preenchimento, mantendo sua proporção. O vídeo é centralizado na área de preenchimento. Se a proporção da área de preenchimento for diferente da do vídeo, a área ao longo da borda mais curta não será preenchida. Essa área exibe o vídeo da camada subjacente. Se nenhuma camada subjacente estiver configurada, essa área ficará preta.	fit
FixedDelayDuration	integer	Não	A latência fixa para a camada de vídeo. Use este parâmetro para sincronizar o vídeo com as legendas. Unidade: milissegundos. Valor padrão: 0. Valores válidos: 0 a 5000.	5000
HeightNormalized	number	Não	A altura normalizada da camada. Se você definir FillMode como none, a largura da camada será redimensionada proporcionalmente à altura. O valor padrão é 0. Um valor 0 indica que o vídeo é exibido em seu tamanho original. Se você definir FillMode como fit, este parâmetro é obrigatório e seu valor deve ser maior que 0. O valor especifica a altura normalizada da área de preenchimento.	1
PositionNormalized	array	Não	A posição da camada de vídeo. O valor é uma coordenada normalizada `[x,y]`. Valor padrão: `[0,0]`. Nota: As coordenadas x e y devem ser normalizadas.	0.3
	number	Não	O valor.	0
PositionRefer	string	Não	O ponto de referência para a posição da camada. Valores válidos: topLeft (padrão): Superior esquerdo. topRight: Superior direito. bottomLeft: Inferior esquerdo. bottomRight: Inferior direito. center: Centro. topCenter: Centro superior. bottomCenter: Centro inferior. leftCenter: Centro esquerdo. rightCenter: Centro direito.	topLeft
WidthNormalized	number	Não	A largura normalizada da camada. Se você definir FillMode como none, a altura da camada será redimensionada proporcionalmente à largura. O valor padrão é 0. Um valor 0 indica que o vídeo é exibido em seu tamanho original. Se você definir FillMode como fit, este parâmetro é obrigatório e seu valor deve ser maior que 0. O valor especifica a largura normalizada da área de preenchimento.	1
AudioLayer	array<object>	Sim	Os layouts de áudio.
	object	Não	O layout de áudio.
FixedDelayDuration	integer	Não	A latência fixa para a camada de áudio. Use este parâmetro para sincronizar o áudio com as legendas. Unidade: milissegundos. Valor padrão: 0. Valores válidos: 0 a 5000.	5000
ValidChannel	string	Não	Os canais de som usados para entrada de áudio. Valores válidos: leftChannel: Canal esquerdo. rightChannel: Canal direito. all (padrão): Ambos os canais.	all
VolumeRate	number	Não	O fator de multiplicação de volume para o fluxo de áudio. Valores válidos: 0 a 10.0. 1.0 (padrão): O volume original é usado. Um valor menor que 1 diminui o volume. Um valor maior que 1 aumenta o volume.	1.0
BlendList	array	Sim	Os IDs de localização das fontes de vídeo. A ordem dos IDs de localização corresponde à ordem das camadas de vídeo especificadas no parâmetro VideoLayer. Para obter mais informações sobre os IDs de localização, consulte AddCasterVideoResource. Para LocationId, consulte Adicionar uma fonte de vídeo. Este ID corresponde à ordem dos elementos VideoLayers.	RV01
	string	Não	O ID de localização.	RV01
MixList	array	Sim	Os IDs de localização das fontes de áudio. A ordem dos IDs de localização corresponde à ordem das camadas de áudio especificadas no parâmetro AudioLayer. Para obter mais informações sobre os IDs de localização, consulte AddCasterVideoResource. Para LocationId, consulte Adicionar uma fonte de vídeo. Corresponde à ordem dos elementos AudioLayers.	RV01
	string	Não	O ID de localização.	RV01
CasterId	string	Sim	O ID do estúdio de produção. Se você criar um estúdio de produção chamando a operação CreateCaster, o CasterId será retornado na resposta. Se você criar um estúdio de produção no console LIVE, acesse Estúdio de Produção > Estúdio de Produção em Nuvem para visualizar o nome do estúdio de produção. Nota O nome do estúdio de produção na página Estúdio de Produção em Nuvem é o ID do estúdio de produção.	LIVEPRODUCER_POST-cn-0pp1czt****

Nota

Nos parâmetros da solicitação, N representa o número de sequência de um elemento. Por exemplo, VideoLayer.N.FillMode especifica o modo de preenchimento para a enésima camada de vídeo. VideoLayer.1.FillMode especifica o modo de preenchimento para a primeira camada de vídeo e VideoLayer.2.FillMode especifica o modo de preenchimento para a segunda camada de vídeo.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
LayoutId	string	O ID do layout. Você pode usar este ID como um parâmetro de solicitação ao chamar operações para gerenciar layouts, como excluir, modificar ou consultar layouts para um estúdio de produção ou um estúdio virtual.	21926b36-7dd2-4fde-ae25-51b5bc8e****
RequestId	string	O ID da solicitação.	16A96B9A-F203-4EC5-8E43-CB92E68F****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter	%s.	Missing parameter
400	InvalidParameter.Malformed	There are invalid parameters: %s.	There are invalid parameters: %s.
400	InvalidCasterId.Malformed	%s, please check and try again later.	The parameter CasterId is invalid, please check and try again.
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	InvalidUserId.Malformed	%s, please check userId.	The userId passed in is invalid, please check.
400	InvalidBlendList.ExceedNorm	%s, please check and try again later.	BlendList size exceeds specification, 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	InvalidHeightOrWidthNormalized	%s, please check and try again later.	HeightNormalized or WidthNormalized parameters are invalid, please check and try again.
400	InvalidMixList.ExceedNorm	%s, please check and try again later.	MixList size exceeds specification, 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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.