Publicação RTMP com chave do stream¶

Prepare uma transmissão no Agora, atribua uma chave de publicação e entregue a chave ao operador do codificador. O codificador envia vídeo para essa transmissão existente; o endereço do servidor e a chave são informados separadamente.

Porta de recepção¶

Abra Cluster → Streamers, selecione o streamer receptor e abra Servidor. Na seção de portas, rtmp deve conter uma porta de recepção, por exemplo 1935. Se estiver vazia, adicione a porta e salve. Permita que o codificador se conecte a essa porta TCP.

Em uma instalação de processo único, use o endereço da máquina Agora. Em um cluster, conecte o codificador ao streamer atribuído para receber a transmissão; a atribuição aparece na aba Layout do stream.

Transmissão e chave¶

1. Em Streams, crie townhall-rtmp ou abra uma transmissão existente.
2. Abra Fontes e selecione Publish como protocolo da fonte. Para adicionar publicação junto de fontes existentes, clique em + Adicionar fonte.
3. Em Publicação RTMP, clique em Gerar nova chave. Você também pode informar uma chave: pelo menos 5 letras latinas, dígitos ou caracteres ._-. Não há limite superior de comprimento. A geração cria uma chave aleatória de 10 caracteres.
4. Clique em Salvar e depois no botão de cópia à direita de Chave do stream.

A chave fica oculta por padrão. À direita do campo estão os botões:

• Olho — mostrar ou ocultar a chave; ao sair do campo, ela fica oculta novamente.
• Gerar nova chave — criar uma nova chave aleatória. Salve as configurações para aplicá-la.
• Copiar valor — copiar a chave real sem mostrá-la na tela.
• Excluir chave — limpar a chave mantendo a entrada Publish. Salve as configurações para desativar a publicação RTMP.

A chave deve ser única em toda a instalação, incluindo streams desativados. Uma chave duplicada impede salvar e mostra um erro no campo. Cada transmissão admite uma única entrada Publish; Publish dentro de MBR não é permitido. townhall-rtmp identifica a transmissão no painel; o codificador recebe a chave.

Configuração do codificador¶

OBS¶

No OBS, selecione um servidor RTMP personalizado. Informe separadamente o endereço do servidor e a chave:

Substitua agora.example.org pelo endereço do streamer receptor e 1935 pela porta configurada. O endereço do servidor não exige um caminho de aplicação. O codificador não usa as credenciais do administrador do Agora: a chave autoriza a publicação.

Para este procedimento, selecione vídeo H.264 e áudio AAC; depois inicie a transmissão no codificador.

FFmpeg¶

Com FFmpeg, você pode publicar um padrão de teste e um tom sem um arquivo de entrada. O exemplo exige uma compilação com libx264. Substitua Abc012._-Z pela chave salva no Agora e use o endereço do streamer receptor:

RTMP_STREAM_KEY='Abc012._-Z'
ffmpeg -hide_banner \
  -re -f lavfi -i 'testsrc2=size=1280x720:rate=25' \
  -f lavfi -i 'sine=frequency=440:sample_rate=48000' \
  -c:v libx264 -preset ultrafast -pix_fmt yuv420p -b:v 1800k -g 50 \
  -c:a aac -b:a 128k \
  -f flv -rtmp_app '' -rtmp_playpath "$RTMP_STREAM_KEY" \
  'rtmp://agora.example.org:1935'

A chave é enviada separadamente com -rtmp_playpath; -rtmp_app '' define um nome de aplicação vazio. O caminho /live não é necessário. Pressione Ctrl+C para parar a publicação.

Verificar a recepção¶

Volte a Fontes. A entrada Publish mostra um estado operacional e os parâmetros das trilhas recebidas. Esta configuração recebe vídeo H.264 e áudio AAC.

Se uma fonte principal operacional vier antes de Publish, o codificador permanece conectado como reserva. Quando a fonte principal desaparece, o vídeo começa no próximo quadro-chave. O retorno da fonte principal após a janela limpa mantém aberta a conexão de reserva.

Trocar ou desativar a chave¶

Para trocar de codificador, pare a publicação anterior e conecte o novo com a mesma chave. O servidor rejeita um segundo publicador simultâneo, mesmo quando o primeiro está em reserva.

Para revogar a chave anterior, gere outra ou limpe o campo e salve. Quando o streamer receptor aplicar a alteração, a publicação RTMP atual será desconectada. A entrada Publish permanece; trocar a chave RTMP não desconecta uma publicação SRT. Outras configurações mantêm a conexão RTMP aberta se a chave não mudar.