ApsaraVideo Live:Retransmissão de stream por pull

Criar uma tarefa

1. Faça login no console do ApsaraVideo Live.

2. No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay.

3. Selecione uma região de centro ao vivo.

4. Clique em Create Task.

5. Configure os parâmetros da tarefa.

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

   Parâmetro	Descrição
   Region	A região da tarefa de pull de stream. Selecione uma região com base na região dos dados de origem ou na região de ingestão de stream. Nota Regiões suportadas: China (Shanghai), China (Beijing), China (Shenzhen), Singapore e Indonesia (Jakarta).
   Task Name	Um nome personalizado para a tarefa.
   Task Time	Os horários de início e fim da tarefa. Por padrão, o horário de início é cinco minutos após o horário atual, e o horário de término é 24 horas após o início. O seletor de horário oferece atalhos de 5 minutes, 30 minutes e 1 hour. Um atalho ajusta o horário de início com base no horário atual e mantém um horário de término válido. Nota A tarefa inicia automaticamente no horário especificado. Se ela parar ou falhar ao iniciar, clique em Enable ou Restart no console.
   Callback Information	Obrigatório. A URL de callback para eventos da tarefa de retransmissão de stream por pull.
   Source Type	O tipo de stream de origem. Para detalhes dos parâmetros, consulte this list item. Live Stream: Suporta protocolos de stream de origem RTMP, SRT e HTTP-FLV. VOD Asset: Suporta formato de vídeo MP4. Se houver vários vídeos com o mesmo ID de vídeo, o vídeo com a maior resolução de transcodificação será selecionado. Se o vídeo transcodificado tiver a mesma resolução, um dos vídeos será selecionado aleatoriamente. Se não houver vídeo transcodificado, o vídeo original será selecionado. Video Path
   Playback Times	O número de vezes para repetir os vídeos na lista de reprodução. Selecione repetição infinita ou especifique uma quantidade. Nota Este parâmetro está disponível apenas para fontes VOD Asset ou Video Path e controla Playback Times.
   Destination Ingest URL	A URL de ingestão de destino para onde o stream será enviado. Para fonte de stream ao vivo, rtmp:// e rtmps:// são suportados. Para fonte de vídeo sob demanda ou caminho de vídeo, apenas rtmp:// é suportado. Nota Exemplo de URL de ingestão do ApsaraVideo Live: rtmp://ingestdomain.com//?auth_key=922353-0-0-f68cba72490a3328a1167c9**

   Parâmetros em Callback configuration:

   • Video switch notification: Esta opção aparece apenas para fontes VOD Asset ou Video Path e vem desativada por padrão. Quando ativada, um callback notifica seu servidor de negócios quando a fonte troca de arquivo.

   • Callback authentication: Esta opção vem desativada por padrão. Quando ativada, as solicitações de callback incluem os cabeçalhos ALI-LIVE-TIMESTAMP e ALI-LIVE-SIGNATURE.

     Método de cálculo do ALI-LIVE-SIGNATURE

     ALI-LIVE-SIGNATURE=LOWERCASE_HEX(MD5(SIGNCONTENT))
     SIGNCONTENT=PullFlowPushTaskID|ALI-LIVE-TIMESTAMP Value|Authentication KEY

     Descrição dos campos:

     • PullFlowPushTaskID: Após a conclusão da criação, pode ser obtido no console.

     • ALI-LIVE-TIMESTAMP: O timestamp UNIX (em segundos) em que a solicitação de callback foi originada.

     • Authentication KEY: A chave de autenticação configurada pelo usuário para o endereço de callback.

   • Authentication key: Este campo é exibido apenas quando Callback authentication está ativado. Insira de 16 a 64 caracteres ASCII visíveis (0x21 a 0x7e).

   Parâmetros por tipo de stream de origem:

   1. Se Source Stream Type estiver definido como Live Stream, a fonte suporta RTMP, SRT e HTTP-FLV.

   2. Se Source Stream Type estiver definido como VOD Asset, insira o ID do ativo de mídia na lista de vídeos. É possível adicionar até 30 vídeos, e o sistema os reproduzirá em sequência. Para Playback Times, selecione Loop ou Specified.

   3. Se Source Stream Type estiver definido como Video Path, 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.

6. Clique em Submit para criar a tarefa.

Consultar uma tarefa

1. Faça login no console do ApsaraVideo Live.

2. No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay.

3. Selecione a região onde você criou a tarefa de Pulled-stream Relay. Em seguida, realize uma consulta por termo usando Task ID, Task Name ou Destination Ingest URL.

Copiar uma tarefa

1. No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay para acessar a página Pulled-stream Relay.

2. Selecione a região do centro ao vivo da tarefa. Localize a tarefa na lista e clique em Copy na coluna Actions.

3. Na página de criação de tarefa, revise ou altere a configuração pré-preenchida e clique em Submit para criar uma tarefa. As seguintes regras se aplicam:

   • Se a tarefa original estiver Not Started, a configuração original e os horários de início e fim serão pré-preenchidos. O nome da tarefa não será pré-preenchido.

   • Caso a tarefa original esteja Running, Recovering ou Stopped, a configuração original será pré-preenchida, o horário de início será definido para cinco minutos após o horário atual e o horário de término original será mantido. O nome da tarefa não será pré-preenchido.

   • Se a tarefa original estiver Ended, a ação Copy ficará indisponível.

   • Em todos os cenários de cópia, o campo Task Name é limpo. Se você o deixar vazio, o sistema gera um nome no formato taskname_Timestamp.

Modificar uma tarefa

1. Faça login no console do ApsaraVideo Live.

2. No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay.

3. Na página Pulled-stream Relay, localize a tarefa que deseja modificar e clique em Edit na coluna Actions.

4. Na página de edição, modifique os parâmetros conforme necessário e clique em Submit.

   1. Para tarefas no status Not Started, é possível modificar Task Time, Callback URL, Playback Times, configurações editáveis de fonte em Source Information, Callback authentication, Authentication key e Video switch notification.

   2. Quando a tarefa estiver Stopped, permita a modificação de Callback URL, Playback Times, configurações editáveis de fonte em Source Information, Callback authentication, Authentication key e Video switch notification.

   3. Em qualquer status da tarefa, Region, Destination URL, Source Type e Source Protocol não podem ser modificados. Configurações de tarefa não podem ser alteradas em outros status.

Excluir uma tarefa

1. Faça login no console do ApsaraVideo Live.

2. No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay.

3. Na página Pulled-stream Relay, localize a tarefa que deseja excluir e clique em Delete na coluna Actions.

4. Na caixa de diálogo exibida, clique em Delete para excluir a tarefa.

Iniciar uma tarefa

1. Faça login no console do ApsaraVideo Live.

2. No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay.

3. Na página Pulled-stream Relay, localize a tarefa que deseja iniciar e clique em Enable na coluna Actions.

4. Na caixa de diálogo exibida, clique em Enable para iniciar a tarefa.

Reiniciar uma tarefa

1. Faça login no console do ApsaraVideo Live.

2. No painel de navegação à esquerda, escolha Feature Management > Pulled-stream Relay.

3. Na página Pulled-stream Relay, localize a tarefa que deseja reiniciar e clique em Restart na coluna Actions.

4. Na caixa de diálogo exibida, clique em Restart para reiniciar a tarefa.

Parar uma tarefa

1. Faça login no console do ApsaraVideo Live.

2. No painel de navegação à esquerda, escolha Feature Management> Pulled-stream Relay.

3. Na página Pulled-stream Relay, localize uma tarefa que deseja parar e clique em Stop na coluna Actions.

4. Na caixa de diálogo exibida, clique em Stop para parar a tarefa.

Como gero uma URL de streaming após criar uma tarefa?

A URL de streaming para uma tarefa de retransmissão de stream por pull deve ser gerada com base no domínio de streaming associado, AppName e StreamName correspondentes à URL de ingestão de destino. Gere essa URL usando o gerador de URLs no console ou por concatenação personalizada.

Uma tarefa de retransmissão de stream por pull retoma automaticamente se o stream de origem de terceiros for desconectado?

Quando um stream de origem de terceiros é desconectado, o status da tarefa muda para Recovering (anormal). Por padrão, o sistema tenta fazer o pull do stream novamente a cada minuto, até três vezes.

• Se o stream de origem se recuperar e o pull for bem-sucedido dentro de 3 minutos, o status da tarefa muda automaticamente para Running (Normal).

• Caso todas as três tentativas falhem, o status da tarefa muda para Offline e o sistema não tenta mais fazer o pull do stream automaticamente. Para reiniciar a tarefa, clique no botão Restart no console ou chame a API RestartLivePullToPush.