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

Modifica as configurações de áudio de uma cena. Esta operação também permite adicionar uma configuração de áudio ou aplicar uma configuração de áudio existente a uma nova cena.

Descrição da operação

Primeiro, chame a operação CreateCaster para criar um estúdio de produção. Em seguida, você pode chamar esta operação para atualizar a configuração de áudio de uma cena. Esta operação suporta o modo de mixagem de áudio e o modo de áudio segue vídeo (AFV).

Limites de QPS

Você pode realizar até 10 consultas por segundo (QPS) por conta Alibaba Cloud. Chamadas de API que excederem esse limite serão limitadas, o que pode afetar seus negócios. Recomendamos que você respeite 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:UpdateCasterSceneAudio

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
AudioLayer	array<object>	Não	As configurações de áudio.
	object	Não	A configuração de áudio.
Filter	string	Não	Especifica se os recursos fornecidos pelo algoritmo de áudio 3A devem ser ativados. Este parâmetro consiste nos seguintes campos: enableAgc: (Opcional) Especifica se o recurso de controle automático de ganho (AGC) do algoritmo 3A deve ser ativado. Valores válidos: 0 (desativado, padrão) e 1 (ativado). enableAns: (Opcional) Especifica se o recurso de redução inteligente de ruído do algoritmo 3A deve ser ativado. Valores válidos: 0 (desativado, padrão) e 1 (ativado). ansMode: (Opcional) O modo do recurso de redução inteligente de ruído. Este campo está ativo somente quando enableAns está definido como 1. Valores válidos: 0 (redução de ruído de fala, padrão) e 1 (redução de ruído de música). Nota Para uma melhor redução de ruído, defina ansMode como 1. enableBeautify: (Opcional) Especifica se o embelezamento de voz deve ser ativado. Valores válidos: 0 (desativado, padrão) e 1 (ativado). voiceBeautifyMode: (Opcional) O modo de embelezamento de voz. Este campo está ativo somente quando enableBeautify está definido como 1. Valores válidos: 0 (voz masculina magnética, padrão) e 1 (voz feminina suave).	{ "enableAgc":0, "enableAns":1 }
FixedDelayDuration	integer	Não	A latência fixa da camada de áudio. Este parâmetro é usado para sincronizar o áudio com as legendas. Unidade: milissegundos. Valores válidos: 0 a 5000. Valor padrão: 0.	0
ValidChannel	string	Não	Os canais de som usados para entrada de volume. Valores válidos: leftChannel: o canal de som esquerdo. rightChannel: o canal de som direito. all (padrão): ambos os canais de som.	all
VolumeRate	number	Não	O multiplicador de volume para o fluxo de áudio. Valores válidos: 0 a 10.0. Valor padrão: 1.0. 1.0: O volume original é usado. Um valor menor que 1 diminui o volume. Um valor maior que 1 aumenta o volume.	1
MixList	array	Não	A lista de IDs de localização associados. A ordem dos IDs de localização deve ser a mesma da ordem das camadas de áudio.	RV01
	string	Não	O ID de localização do recurso. A ordem dos IDs de localização deve ser consistente com a ordem das camadas de áudio. Se um canal estiver ativado, use o ID de localização do canal. Caso contrário, use o ID de localização da fonte de vídeo.	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, poderá obter o ID a partir do parâmetro CasterId na resposta. Se você criar um estúdio de produção no console LIVE, acesse a página Console LIVE > Estúdio de Produção > Estúdio de Produção em Nuvem para visualizar o ID. Nota O nome do estúdio de produção na lista da página Estúdio de Produção em Nuvem é o ID do estúdio de produção.	LIVEPRODUCER_POST-cn-0pp1czt****
SceneId	string	Sim	O ID da cena. Se você consultar a lista de cenas em um estúdio de produção chamando a operação DescribeCasterScenes, poderá obter o ID a partir do parâmetro ComponentId na resposta.	a2b8e671-2fe5-4642-a2ec-bf93880e1****
FollowEnable	integer	Não	Especifica se o modo AFV deve ser ativado. Se você deixar este parâmetro vazio, a última configuração será mantida. Valores válidos: 0: modo de mixagem de áudio. 1: modo de áudio segue vídeo.	1

Nos parâmetros da solicitação, N indica o número de sequência. Por exemplo:

AudioLayer.N.VolumeRate especifica o multiplicador de volume para o N-ésimo elemento.
AudioLayer.1.VolumeRate especifica o multiplicador de volume para o primeiro elemento.
AudioLayer.2.VolumeRate especifica o multiplicador de volume para o segundo elemento.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Exemplos

Resposta de sucesso

JSON formato

{
  "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	InvalidParameter.Malformed	There are invalid parameters: %s.	There are invalid parameters: %s.
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	IncorrectSceneStatus	%s, please check and try again later.	Scene status is not supported, please check and try again.
400	IncorrectSceneStatus.ConfigError	%s, please check and try again later.	Scene configuration error, 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.
412	ResourceInChannel.PreConditionFailed	%s, please try again later.	Resource pre-verification failed, please try again later.
412	ResourceInChannel.Invalid	%s, please check and try again later.	Resource and channel material address are inconsistent, 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	InvalidScene.NotFound	%s, please check and try again later.	Scene does not exist, please check and try again.
404	ResourceInChannel.NotFound	%s, please check and try again later.	The resource 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.