Stream pulling and pushing | ApsaraVideo Live - ApsaraVideo Live: Central de Documentação do Alibaba Cloud

O recurso de pull e push de streams do ApsaraVideo Live permite puxar fontes existentes de transmissão ao vivo ou vídeo sob demanda (VOD) e enviá-las como novos streams ao vivo (transmissão pseudo-ao vivo).

Visão geral

O pull e push de streams obtém conteúdo de transmissões ao vivo de terceiros ou vídeos gravados e o distribui aos espectadores em tempo real, sem as etapas tradicionais de ingestão.

Crie, visualize e gerencie tarefas no console do ApsaraVideo Live ou chamando operações de API.

Fluxo de pull e push de streams:

Observações de uso

O pull e push de streams é um recurso pago. O faturamento começa às 00:00 de 05 de dezembro de 2025. Preços: Taxas de pull e push de streams.
Cada tarefa envia um único stream. Para enviar múltiplos streams, crie várias tarefas.
É sua responsabilidade garantir que o conteúdo utilizado com o recurso de pull e push de streams esteja em conformidade com todas as leis e regulamentos aplicáveis. O ApsaraVideo Live fornece apenas o serviço de transmissão de streams. Se forem identificadas ameaças legais, o ApsaraVideo Live interromperá o serviço para o conteúdo relacionado e se reserva o direito de tomar medidas legais.
Para puxar ou enviar streams fora da China, defina a região da tarefa como uma região fora da China.
O pull e push de streams suporta callbacks de eventos. Callbacks de eventos de pull e push de streams.
Cada conta pode executar até 100 tarefas simultâneas. Limites.

Pré-requisitos

O ApsaraVideo Live está ativado e você fez login no console. Ativar e adquirir o ApsaraVideo Live.

Você possui as informações necessárias sobre a fonte ao vivo ou VOD.

Cenário	Informações
Ao vivo	A URL de reprodução do stream ao vivo. Protocolos de origem suportados: RTMP, SRT e HTTP-FLV.
VOD	O ID do ativo de mídia da fonte VOD. Obter ou atualizar informações de ativos de mídia.
Vídeo	O caminho da URL da fonte de vídeo. Nota O caminho da URL do vídeo deve começar com http:// ou https:// e terminar com .mp4 ou .flv.

Nota

Limite de 30 IDs de ativos de mídia VOD ou caminhos de URL de fonte de vídeo.
Codecs de vídeo suportados: H.264 e H.265.
Codec de áudio suportado: AAC. Taxa de amostragem: 16 kHz a 44,1 kHz.
Fontes VOD devem usar o formato MP4 ou FLV.

Uma URL de ingestão foi gerada a partir do seu domínio de ingestão. Gerar URLs de streaming.

Procedimento

Criar uma tarefa

Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay. A página Pulled-stream Relay será exibida.
Selecione uma região de centro ao vivo.
Clique em Create Task.

Configure os parâmetros da tarefa.

A tabela a seguir descreve os parâmetros da tarefa.

Parâmetro	Descrição
Region	Região da tarefa. Selecione com base na região dos dados de origem ou na região de destino do push. Nota Regiões suportadas: China (Shanghai), China (Beijing), China (Shenzhen), Singapura e Indonésia (Jakarta).
Task Name	Nome personalizado para a tarefa.
Task Time	Especifique os horários de início e término do trabalho. Nota A tarefa inicia automaticamente no horário especificado. Caso pare ou falhe ao iniciar, clique em Enable ou Restart no console.
Callback Information	Obrigatório. URL do webhook para notificações de eventos da tarefa.
Source Type	Tipo do stream de origem. Detalhes do parâmetro: este item da lista. Ao vivo. VOD. Caminho da URL do vídeo.
Playback Times	Contagem de repetições para os vídeos da lista de reprodução. Escolha loop infinito ou especifique uma quantidade. Loop infinito. Reprodução em horário especificado. Nota Disponível apenas quando o Tipo de Stream de Origem estiver definido como VOD ou Caminho da URL do Vídeo.
Destination Ingest URL	URL de destino RTMP para onde o stream será enviado. Nota Exemplo de URL de ingestão do ApsaraVideo Live: rtmp://ingestdomain.com//?auth_key=922353-0-0-f68cba72490a3328a1167c9**

Parâmetros por tipo de stream de origem:

Quando o Tipo de Stream de Origem for Ao vivo, a fonte suporta RTMP, SRT e HTTP-FLV.
Se o Tipo de Stream de Origem for VOD, insira o ID do ativo de mídia. Obter ou atualizar informações de ativos de mídia.
Caso o Tipo de Stream de Origem seja Caminho da URL do Vídeo, insira a URL do vídeo.

Nota
O caminho da URL do vídeo deve começar com http:// ou https:// e terminar com .mp4 ou .flv.

Clique em Submit para criar a tarefa.

Nota

Também é possível utilizar a operação de API Criar uma tarefa de pull e push de streams.

Consultar uma tarefa

Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay para acessar a página Pulled-stream Relay.
Selecione a região onde criou a tarefa de Pulled-stream Relay. Em seguida, realize uma busca por termo usando Task ID, Task Name ou Destination Ingest URL.

Nota

Também é possível utilizar a operação de API Consultar tarefas de pull e push de streams.

Modificar uma tarefa

Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay para acessar a página Pulled-stream Relay.
Na página Pulled-stream Relay, localize a tarefa que deseja modificar e clique em Edit na coluna Actions.
Na página de edição, modifique os parâmetros conforme necessário e clique em Submit.
1. Para tarefas no estado Not Started, edite o Task Time, as Callback Information e o Source Type.
2. Se a tarefa estiver no estado Stopped, edite as Callback Information e o Source Type.
3. Em qualquer outro estado, a edição da tarefa não é permitida.

Nota

Também é possível utilizar a operação de API Atualizar uma tarefa de pull e push de streams.

Excluir uma tarefa

Importante

Tarefas de pull e push de streams excluídas não podem ser recuperadas.

Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay para acessar a página Pulled-stream Relay.
Na página Pulled-stream Relay, localize a tarefa que deseja excluir e clique em Delete na coluna Actions.
Na caixa de diálogo exibida, clique em Delete para excluir a tarefa.

Nota

Também é possível utilizar a operação de API Excluir uma tarefa de pull e push de streams.

Iniciar uma tarefa

Nota

Somente tarefas no estado Stopped podem ser ativadas.
A tarefa inicia automaticamente no horário especificado.

Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay para acessar a página Pulled-stream Relay.
Na página Pulled-stream Relay, localize a tarefa que deseja iniciar e clique em Enable na coluna Actions.
Na caixa de diálogo exibida, clique em Enable para iniciar a tarefa.

Reiniciar uma tarefa

Nota

Somente tarefas no estado Running podem ser reiniciadas.

Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay para acessar a página Pulled-stream Relay.
Na página Pulled-stream Relay, localize a tarefa que deseja reiniciar e clique em Restart na coluna Actions.
Na caixa de diálogo exibida, clique em Restart para reiniciar a tarefa.

Nota

Também é possível utilizar a operação de API Reiniciar uma tarefa de pull e push de streams.

Parar uma tarefa

Nota

É possível Stop uma tarefa com status Running.

Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, escolha Feature Management> Pulled-stream Relay para acessar a página Pulled-stream Relay.
Na página Pulled-stream Relay, localize a tarefa que deseja parar e clique em Stop na coluna Actions.
Na caixa de diálogo exibida, clique em Stop para parar a tarefa.

Nota

Também é possível utilizar a operação de API Parar uma tarefa de pull e push de streams.