O pull de stream de origem consiste no processo de puxar streams ao vivo de fontes de terceiros para o centro de transmissão ao vivo da Alibaba Cloud para processamento e entrega acelerada. Você pode configurar o pull de stream em dois modos: pull agendado e pull acionado.
Introdução ao recurso
O ApsaraVideo Live oferece suporte a dois tipos de pull de origem:
Pull agendado: O sistema puxa o stream durante um período especificado, independentemente da atividade de reprodução dos usuários.
-
Pull acionado: O sistema puxa o stream apenas ao detectar uma solicitação de reprodução (pull inicial) para um stream específico no domínio. Durante o processo, o sistema decide se deve interromper a conexão com base no status de reprodução dos espectadores e no estado das tarefas de backend:
Se houver tarefas de backend em execução, como gravação, time shifting, snapshots ou moderação de conteúdo, o sistema mantém a conexão do stream ativa mesmo sem espectadores.
-
Caso não existam tarefas de backend ativas e o sistema não detecte espectadores por cinco minutos, a tarefa de pull é desconectada automaticamente.
NotaPara que o sistema desconecte a tarefa de pull imediatamente quando não houver espectadores, independentemente do status das tarefas de backend, envie um ticket solicitando a configuração no backend.
Limitações
-
Pull agendado
Oferece suporte ao pull de streams ao vivo de terceiros a partir de URLs nos formatos RTMP, HTTP-FLV, HLS ou SRT.
É permitido adicionar até 300 configurações de pull agendado. Para aumentar esse limite, solicite uma elevação da cota de streams originais. Para mais informações, consulte Gerenciamento de cotas. O limite máximo de configurações de pull agendado corresponde ao limite de streams originais.
O intervalo entre a hora de início e a hora de término de uma tarefa de pull não pode exceder 7 dias.
-
Pull acionado
Compatível com o pull de streams ao vivo de terceiros via URLs nos formatos RTMP, HTTP-FLV ou HLS.
Permite adicionar até 200 configurações de pull acionado.
Não há suporte para pull de origem a partir de endereços IPv6.
Para utilizar streams ao vivo de terceiros codificados em H.265, entre em contato conosco.
Configure pull acionado
Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, escolha Domain Names.
Localize o domínio de streaming que deseja gerenciar e clique em Domain Settings. Na árvore de navegação à esquerda, escolha Origin Stream Pulling.
Na aba Trigger Stream Pulling, clique em Add.
-
Configure o pull acionado.
Parâmetro
Descrição
AppName in Streaming URL
Este AppName gera a URL de streaming e não precisa corresponder ao AppName do stream de origem. No entanto, caso você não especifique um AppName in Source URL, este AppName deverá ser idêntico ao AppName do stream de origem.
Para configurar o pull de stream no nível do domínio, defina este parâmetro como ali_all_app.
AppName in Source URL
O AppName utilizado para puxar streams do servidor de origem. Deve corresponder ao AppName do stream de origem.
Se deixado em branco, o sistema utiliza o AppName in Streaming URL. Nesse caso, seu valor deve ser idêntico ao AppName do stream de origem.
Source URL
A URL do stream ao vivo de terceiros. É possível adicionar até quatro URLs. Se o stream ativo for interrompido, o sistema alternará automaticamente para a próxima URL de backup e iniciará o pull a partir dela.
Origin Stream Pulling Protocol
Oferece suporte aos protocolos RTMP, HTTP-FLV e HLS. Não há suporte para o protocolo SRT.
Transcoding-Triggered Stream Pulling
Enabled: Solicitar a URL do stream transcodificado ou a URL do stream original aciona automaticamente o ApsaraVideo Live para puxar o stream do servidor de origem.
Disabled: Apenas a solicitação da URL do stream original aciona o pull de origem. Solicitar uma URL de stream transcodificado não aciona o pull de origem.
Clique em OK.
URLs de streaming
Após o pull do stream, combine o AppName com o nome do stream de origem (StreamName) para gerar URLs de streaming. O StreamName na URL de streaming deve ser idêntico ao StreamName de origem. As regras de correspondência do AppName são as seguintes:
Padrão: Utilize o AppName in Streaming URL configurado.
-
Correspondência global (quando o AppName in Streaming URL está definido como
ali_all_app):Se o AppName in Source URL não estiver configurado: Use o AppName original do stream de origem.
Se o AppName in Source URL estiver configurado: É possível personalizar o AppName.
Configure pull agendado
Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, escolha Domain Names.
Localize o domínio de streaming que deseja gerenciar e clique em Domain Settings. Na árvore de navegação à esquerda, escolha Origin Stream Pulling.
Na aba Fixed Stream Pulling, clique em Add.
-
Configure o pull agendado.
Parâmetro
Descrição
Application Name
Este AppName gera a URL de streaming. Não é necessário que corresponda ao AppName do stream de origem.
StreamName
Nome do stream ao vivo. O nome do stream deve ser único entre todos os modelos de pull de stream.
Source URL
URL do stream ao vivo de terceiros. Compatível com os formatos RTMP, HTTP-FLV, HLS e SRT. Permite adicionar até quatro URLs. Caso o stream ativo seja interrompido, o sistema alterna automaticamente para a próxima URL de backup e realiza o pull.
Start and End Time
Horário de início e término para o pull agendado. O intervalo entre eles não pode ultrapassar 7 dias.
Clique em OK.
Para iniciar a reprodução, gere uma URL de streaming utilizando o AppName e o StreamName configurados. Para mais detalhes, consulte Gerar URLs de transmissão ao vivo.
Modifique configurações de pull
Altere sua configuração de pull para lidar com cenários urgentes em que o servidor de origem fique indisponível.
Na página Origin Stream Pulling, clique na aba Trigger Stream Pulling ou Fixed Stream Pulling para visualizar as configurações existentes.
Encontre a configuração que deseja alterar e clique em Modify na coluna Actions.
Modifique a configuração de pull de stream conforme necessário.
Clique em OK.
-
Pull agendado
Após a modificação da configuração, o sistema reinicia a tarefa de pull com base nas novas definições. Certifique-se de que essa operação não afete os serviços online ativos.
-
Pull acionado
Depois da alteração, as sessões de reprodução existentes continuam usando a configuração antiga, enquanto novas solicitações de reprodução aplicam a nova configuração.
Caso tenha especificado um AppName na URL de origem ao adicionar a configuração, não será possível deixar esse parâmetro vazio ao modificá-la.
Lógica de callback
Para ingestão de stream RTMP, se o cliente não desconectar ativamente dentro de 2 segundos após o ApsaraVideo Live receber a mensagem On Publish, o ApsaraVideo Live envia um callback de sucesso de ingestão de stream.
A lógica de callback para pull de stream de origem é idêntica. Suponha que você tenha um domínio de ingestão A e um domínio de streaming B. Se o domínio B utilizar pull de stream (agendado ou acionado) e exigir callbacks, configure o callback de ingestão de stream no domínio de ingestão A. Uma vez configurado, eventos de pull no domínio B podem acionar callbacks. Após o estabelecimento da conexão, se não houver desconexão ativa por 2 segundos, a tarefa de pull é considerada bem-sucedida.
Se nenhum dado de stream chegar ao centro de transmissão ao vivo por 10 segundos consecutivos, o ApsaraVideo Live desconecta automaticamente a tarefa de pull atual.
Recomendamos não depender exclusivamente de notificações de callback para determinar se a ingestão ou o pull de stream está funcionando normalmente. Chame a API DescribeLiveStreamsPublishList para verificar se o stream existe ativamente antes de distribuir a URL de streaming aos usuários.