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

Atualiza uma tarefa de retransmissão de streams mistos.

Descrição da operação

Certifique-se de que uma tarefa de retransmissão de streams mistos foi criada antes de chamar esta operação. Você pode chamar a operação StartLiveMPUTask para criar uma tarefa de retransmissão de streams mistos.

Limite de QPS

Você pode chamar esta operação até 500 vezes por segundo por conta. As solicitações que excederem esse limite serão descartadas e você sofrerá interrupções no serviço. Recomendamos que você observe esse limite ao chamar esta operação.

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

update

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AppId	string	Sim	O ID do aplicativo. Você pode especificar apenas um ID de aplicativo. O ID pode ter até 64 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-).	yourAppId
ChannelId	string	Sim	O ID do canal. Você pode especificar apenas um ID de canal. O ID pode ter até 64 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-).	yourChannelId
TaskId	string	Sim	O ID da tarefa. Você pode especificar apenas um ID de tarefa. O ID pode ter até 55 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). O ID deve ser único.	yourTaskId
MixMode	string	Não	O modo de mixagem de streams. Valores válidos: 0: o modo de retransmissão de stream único. Neste modo, o serviço apenas retransmite o stream único original, mas não transcodifica streams mistos. Você não precisa definir parâmetros para a transcodificação de streams mistos. 1 (padrão): o modo de retransmissão de streams mistos.	0
StreamURL	string	Não	A URL de ingestão. Você pode especificar apenas uma URL de ingestão no formato Real-Time Messaging Protocol (RTMP). A URL pode ter até 2.048 caracteres. Para obter informações sobre as regras de geração de URLs de ingestão, consulte URLs de ingestão e streaming. Nota Se a URL de ingestão estiver sob um nome de domínio para o qual a proteção contra hotlink está ativada, você deve incluir um token de acesso na URL. Você não pode usar a mesma URL de ingestão em tarefas diferentes. Você não pode usar a mesma URL de ingestão dentro de 10 segundos após a interrupção de uma tarefa.	rtmp://example.com/live/stream
MultiStreamURL	array<object>	Não	As múltiplas URLs de ingestão a serem retransmitidas. Este parâmetro permite especificar várias URLs de ingestão.
	object	Não
URL	string	Não	A URL de ingestão. Apenas o formato RTMP é suportado. A URL pode ter até 2.048 caracteres. Para obter informações sobre as regras de geração de URLs de ingestão, consulte URLs de ingestão e streaming.	rtmp://example.com/live/stream****
IsAliCdn	boolean	Não	Especifica se a retransmissão de stream deve ser realizada usando o Alibaba Cloud CDN. Valores válidos: false: realiza a retransmissão de stream usando um serviço de CDN que não seja o Alibaba Cloud CDN. true: realiza a retransmissão de stream usando o Alibaba Cloud CDN. Nota O valor padrão deste parâmetro é false.	false
SingleSubParams	object	Não	Os parâmetros de retransmissão de stream único. Esses parâmetros são obrigatórios se você definir MixMode como 0.
SourceType	string	Não	O tipo da fonte de vídeo. Este parâmetro é válido apenas quando você define StreamType como 2. Valores válidos: camera (padrão) shareScreen	camera
StreamType	string	Não	O tipo do stream que você deseja retransmitir. Valores válidos: 0 (padrão): stream original 1: apenas a faixa de áudio 2: apenas a faixa de vídeo	0
UserId	string	Sim	O ID do usuário. No modo de retransmissão de stream único, você pode retransmitir apenas um stream em uma solicitação.	yourSubUserId
TranscodeParams	object	Não	Os parâmetros de retransmissão de streams mistos. Esses parâmetros são obrigatórios se você definir MixMode como 1.
Background	object	Não	A imagem de fundo global.
RenderMode	string	Não	O modo de exibição da imagem de fundo global. 0: dimensiona a imagem de fundo proporcionalmente para caber na visualização, com a exibição de barras pretas. 1 (padrão): corta a imagem de fundo para caber na visualização.	1
URL	string	Não	A URL da imagem de fundo global.	yourImageUrl
EncodeParams	object	Não	Os parâmetros de codificação para o stream de saída.
AudioOnly	string	Não	Especifica se o stream de saída é um stream apenas de áudio. Valores válidos: true: O stream de saída é um stream apenas de áudio. Se você definir este parâmetro como true, precisará configurar apenas os parâmetros relacionados ao áudio em EncodeParams. false (padrão): O stream de saída não é um stream apenas de áudio. Se você definir este parâmetro como false, precisará configurar todos os parâmetros em EncodeParams, exceto os parâmetros VideoCodec e EnhancedParam.	false
AudioBitrate	string	Não	A taxa de bits do áudio. Valores válidos: [8,500]. Unidade: Kbit/s.	128
AudioChannels	string	Não	O número de canais de som. Valores válidos: 1 e 2.	2
AudioSampleRate	string	Não	A taxa de amostragem de áudio. Valores válidos: 8000, 16000, 32000, 44100 e 48000. Unidade: Hz.	44100
VideoCodec	string	Não	O codec de vídeo. Valores válidos: H.264 (padrão) H.265	H.264
VideoBitrate	string	Não	A taxa de bits do vídeo. Valores válidos: [1,10000]. Unidade: Kbit/s.	3500
VideoFramerate	string	Não	A taxa de quadros do vídeo. Valores válidos: [1,60]. Unidade: quadros por segundo (FPS).	25
VideoGop	string	Não	O tamanho do grupo de imagens (GOP) do vídeo. Valores válidos: [1,60].	20
VideoHeight	string	Não	A altura do vídeo. Valores válidos: [0,1920]. Unidade: pixels.	1000
VideoWidth	string	Não	A largura do vídeo. Valores válidos: [0,1920]. Unidade: pixels.	1920
EnhancedParam	string	Não	O parâmetro usado para aprimoramento de codificação, que é uma string JSON. O parâmetro inclui os campos opcionais profile e preset. profile: o nível de codificação. Se o codec de vídeo for H.264, os valores válidos deste campo são baseline, main e high. Se o codec de vídeo for H.265, o valor válido deste campo é main. preset: ajusta o equilíbrio entre a velocidade de codificação e a qualidade do vídeo. Os valores válidos deste campo são ultrafast, superfast, veryfast, faster, fast, medium, slow, slower, veryslow e placebo. Cada valor especifica um nível de equilíbrio entre a velocidade de codificação e a qualidade do vídeo. Por exemplo, o preset ultrafast tem a velocidade de codificação mais rápida, mas a qualidade de vídeo mais baixa, enquanto o preset placebo sacrifica a velocidade de codificação para obter a melhor qualidade de vídeo. Nota Um valor de superfast para o campo preset é adequado para cenários de comunicação em tempo real. Recomendamos que você não defina o campo se não for um engenheiro de codificação profissional.	{"profile": "high", "preset": "veryfast"}
Layout	object	Não	As informações de layout do vídeo. Nota Se a transcodificação de vídeo for necessária, você deve especificar as informações de layout do vídeo, incluindo a coordenada x e a coordenada y, a largura e a altura, e a camada. Para transcodificação apenas de áudio, deixe as informações de layout do vídeo vazias.
UserPanes	array<object>	Não	As informações sobre os painéis.
	array<object>	Não	As informações sobre o painel.
UserInfo	object	Não	The information about the user whose stream is played in the pane. If you leave this parameter empty, the system automatically sets this parameter based on the order in which streamers join the channel. Nota If you specify the information about a user by using this parameter, the information about the user must also be specified by using the TranscodeParams.UserInfos parameter. This parameter is valid only when you set StreamType to 0 or 2.
SourceType	string	Não	The type of the video source. This parameter is valid only when you set StreamType to 2. Valid values: camera (default) shareScreen	camera
ChannelId	string	Não	The ID of the channel where the user is. If the user is in the same channel, you can leave this parameter empty. We recommend that you specify this parameter when you perform stream mixing across channels.	yourChannelId
UserId	string	Não	The user ID.	yourSubUserId
Height	string	Não	The height of the pane. The value is normalized.	0.2632
Width	string	Não	The width of the pane. The value is normalized.	0.3564
X	string	Não	The x-coordinate of the pane. The value is normalized.	0.2456
Y	string	Não	The y-coordinate of the pane. The value is normalized.	0.3789
ZOrder	string	Não	The layer in which the pane resides. A value of 0 indicates the bottom layer. Each increment of the value by 1 indicates the next upper layer.	0
BackgroundImageUrl	string	Não	The URL of the background image of the pane. This image is displayed if the user turns off the camera or is not present in the channel.	yourImageUrl
RenderMode	string	Não	The display mode of the pane. Valid values: 0: scales the video proportionally to fit the view, with black bars displayed. 1 (default): crops the video to fit the view.	1
UserInfos	array<object>	Não	As informações sobre os usuários cujos streams são assinados. Se você deixar este parâmetro vazio, os streams de todos os usuários serão mixados.
	object	Não	As informações sobre o usuário.
SourceType	string	Não	O tipo da fonte de vídeo que é assinada. Este parâmetro é válido apenas quando você define StreamType como 2. Valores válidos: camera (padrão) shareScreen	camera
StreamType	string	Não	O tipo do stream retransmitido que é assinado. Valores válidos: 0 (padrão): stream original 1: apenas a faixa de áudio 2: apenas a faixa de vídeo	0
ChannelId	string	Não	O ID do canal onde o usuário assinante está. Se o usuário estiver no mesmo canal, você pode deixar este parâmetro vazio. Recomendamos que você especifique este parâmetro ao realizar a mixagem de streams entre canais.	yourChannelId
UserId	string	Sim	O ID do usuário assinante.	yourSubUserId
SeiParams	object	Não	Os parâmetros de informações de aprimoramento suplementar (SEI).
LayoutVolume	object	Não	O SEI de layout e volume. Se você deixar este parâmetro vazio, o SEI de layout e volume padrão será usado.
FollowIdr	string	Não	Especifica se o SEI deve ser incluído em um quadro de Instantaneous Decoder Refresh (IDR). Valores válidos: 0: não inclui o SEI. 1: inclui o SEI.	0
Interval	string	Não	O intervalo no qual o SEI é enviado. Valores válidos: [1000,5000]. Unidade: milissegundos.	1000
PassThrough	object	Não	Especifica se o SEI deve ser repassado.
FollowIdr	string	Não	Especifica se o SEI deve ser incluído em um quadro IDR. Valores válidos: 0: não inclui o SEI. 1: inclui o SEI.	0
Interval	string	Não	O intervalo no qual o SEI é enviado. Valores válidos: [1000,5000]. Unidade: milissegundos.	1000
PayloadContent	string	Não	O conteúdo do payload do SEI.	yourPayloadContent
PayloadContentKey	string	Não	A chave do conteúdo do payload do SEI. Se você não especificar este parâmetro, o valor padrão udd será usado.	yourPayloadContentKey

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	0F72851F-5DC1-1979-9B2C-450040316C3E

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0F72851F-5DC1-1979-9B2C-450040316C3E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParam	%s.	Parameter verification failed
400	InvalidAppId	%s, please check and try again later.	AppId is invalid, please check and try again.
400	MissingParam	%s, please check and try again later.	Parameter is missing, please check and try again.
500	InternalError	InternalError
403	OperationDenied	Your account has not enabled the Live service
403	Forbidden	%s, please check and try again later.	No permission, 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.