ApsaraVideo Live:StartLiveMPUTask

Por padrão, cada ID de aplicativo suporta no máximo 200 tarefas de ingestão de stream único e 40 tarefas de mixagem e transcodificação de streams. Para aumentar a cota, abra um ticket.

Ciclo de vida da tarefa de mixagem de streams

Início

• Quando um streamer começa a transmitir pela primeira vez, você pode chamar StartLiveMPUTask para iniciar uma tarefa de bypass.

  • Se não houver usuários no canal, um erro de "canal inexistente" será retornado.

  • O stream de bypass é gerado apenas quando um usuário inicia a ingestão de stream. Se o usuário em uma tarefa de stream único não ingerir um stream, o stream de bypass não poderá ser reproduzido.

  • Para uma tarefa de mixagem de streams, pelo menos um usuário deve estar ingerindo um stream para que o stream de bypass seja reproduzível. A área de layout para usuários que não estão ingerindo streams exibe uma tela preta.

• Você pode registrar o status da tarefa de bypass, o tipo de tarefa e os parâmetros da tarefa em seu servidor de negócios.

  • Status da tarefa: Iniciada, Parada.

  • Tipo de tarefa: Stream único, Mixagem de streams.

  • Parâmetros da tarefa: Os parâmetros de entrada mais recentes. Por exemplo, após uma chamada bem-sucedida para UpdateLiveMPUTask, registre os parâmetros mais recentes da tarefa.

• Em cenários de co-streaming ou PK, se uma tarefa foi atualizada para uma tarefa de mixagem de streams e o streamer sai inesperadamente e depois reingressa no canal, seu servidor de negócios pode chamar StartLiveMPUTask para reiniciar a tarefa de mixagem de streams com base no tipo e nos parâmetros salvos.

  • Se o sistema não tiver limpado automaticamente a tarefa antes de você iniciá-la, a tarefa será iniciada com sucesso.

  • Se o sistema ainda não tiver limpado a tarefa, um código de erro Tarefa já existe será retornado.

Fim

• Quando um streamer sai do canal, chame StopLiveMPUTask para parar a tarefa de bypass.

• Se todos os usuários na tarefa saírem do canal e StopLiveMPUTask não for chamado, o sistema para automaticamente a tarefa de bypass após 2 minutos.

Limites de QPS

O limite de consultas por segundo (QPS) para um único usuário para esta API é de 500 chamadas/segundo. Se você exceder esse limite, as chamadas de API serão limitadas. Isso pode afetar seus negócios. Recomendamos que você chame esta API de forma razoável.

SEI de layout e volume

Exemplo para um cenário de co-streaming:

Se houver apenas um streamer, a coleção stream nas informações SEI que o visualizador recebe contém informações para apenas um membro. Se o streamer estiver em uma sessão de co-streaming ou PK, a coleção stream contém informações para múltiplos membros. Por exemplo, quando o streamer streamer111 está transmitindo sozinho, o formato de quadro SEI que o visualizador recebe é o seguinte:
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"streamer111","paneid":-1,"zorder":0,"x":0,"y":0,"w":0,"h":0,"type":0,"status":1,"muted":0,"vol":0,"vad":0}],"ver":"1.0.0.20220915","ts":1697696105170} Quando o streamer streamer111 está em co-streaming com o visualizador viewer222, o formato de quadro SEI que o visualizador recebe é o seguinte:
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"streamer111","paneid":0,"zorder":1,"x":0,"y":0.25,"w":0.5,"h":0.5,"type":0,"status":1,"muted":0,"vol":1,"vad":119},{"uid":"viewer222","paneid":1,"zorder":1,"x":0.5018382,"y":0.25,"w":0.5,"h":0.5,"type":0,"status":1,"muted":0,"vol":60,"vad":123}],"ver":"1.0.0.20220915","ts":1697696106230} Ao verificar o número de elementos na matriz stream, você pode determinar se o layout ao vivo mudou. Se a matriz stream tiver um elemento, um único streamer está ingerindo um stream. Se a matriz stream tiver mais de um elemento, o streamer está em uma sessão de co-streaming ou PK. As informações de layout para cada membro indicam sua posição específica no layout do stream mixado.

SEI de pass-through

• Para usar SEI personalizado, você pode chamar o comando StartLiveMPUTask para iniciar uma tarefa de mixagem e ingestão de streams e especificar PayloadContent no parâmetro PassThrough. Você também pode chamar o comando UpdateLiveMPUTask para atualizar a tarefa e especificar PayloadContent no parâmetro PassThrough.

• O SEI personalizado pode ser enviado periodicamente. Você pode definir o período usando o parâmetro Interval em PassThrough. A unidade é milissegundos.

• O SEI personalizado também pode ser enviado com quadros-chave. Você pode definir isso usando o parâmetro FollowIdr em PassThrough.

  • Você pode enviar SEI tanto periodicamente quanto com quadros-chave. Por exemplo, Interval:1000 e FollowIdr: 1 significa que o SEI personalizado é enviado a cada 1000 ms e também com cada quadro-chave.

  • Se você não definir Interval ou FollowIdr, o SEI personalizado será enviado apenas uma vez quando a API for chamada.

Por exemplo, quando o streamer streamer111 está transmitindo sozinho, você pode chamar o comando UpdateLiveMPUTask para enviar SEI periódico. No parâmetro PassThrough, defina Interval como 1000, FollowIdr como 0 e PayloadContent como "hello world". Uma mensagem SEI personalizada é então enviada a cada 1000 ms. O formato de quadro SEI que o visualizador recebe é o seguinte:
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"streamer111","paneid":-1,"zorder":0,"x":0,"y":0,"w":0,"h":0,"type":0,"status":1,"muted":0,"vol":0,"vad":0}],"ver":"1.0.0.20220915","ts":1697696109876,"udd":"hello world"}

Mixagem de streams de múltiplos usuários entre canais

Para mixar streams de múltiplos streamers em vários canais e ingerir o stream mixado no serviço de transmissão ao vivo, você deve fornecer o UserID e o ChannelID do streamer que inicia a chamada entre canais, juntamente com os UserIDs dos outros participantes, como parâmetros de entrada ao criar a tarefa de mixagem de streams. Veja o seguinte exemplo: Em um cenário de PK ao vivo, o streamer userA no canal channelA inicia um PK entre canais com o streamer userB no canal channelB usando uma API de cliente. O stream mixado de ambos os streamers é enviado para os visualizadores no canal channelA. Neste caso, os parâmetros de canal e usuário para criar a tarefa de mixagem de streams são especificados da seguinte forma:

• ChannelID: Especifique channelA.

• UserInfos->UserId: Especifique userA e userB respectivamente.