Reprodução por NDI¶

O Agora anuncia cada stream como uma fonte NDI independente na rede local. O receptor descobre a fonte e se conecta a ela. A reprodução exige Listener NDI no streamer e Publicar este stream em NDI no próprio stream.

O NDI não tem autenticação. Ative-o somente em uma rede confiável: qualquer pessoa com acesso à rede pode se conectar a uma fonte anunciada sem um token de reprodução do Agora.

Fixe o stream em um servidor¶

Atualmente, a configuração de NDI em um cluster começa por fixar o stream em um servidor específico usando labels com o requisito required_…. Ative o listener NDI nesse mesmo servidor.

Abra Cluster → Streamers, selecione um servidor na rede dos receptores NDI e adicione ndi-studio-a em Etiquetas, na aba Cluster. Salve os ajustes.
Confirme que somente o servidor escolhido tem essa etiqueta. Se vários servidores a tiverem, o requisito permite atribuir o stream a qualquer um deles.
Abra o stream em Streams. Na aba Layout, adicione required_ndi-studio-a e salve o stream.
Ative o listener como descrito abaixo e confira a atribuição em Layout: o stream deve estar ativo no servidor escolhido.

required_ é uma condição obrigatória de atribuição; preferred_ apenas expressa uma preferência e não fixa o stream. As restrições de namespace e as demais etiquetas também devem corresponder. Se o único servidor apto estiver indisponível, o stream não será atribuído a outro servidor sem essa etiqueta.

Etiqueta do streamer escolhido

Etiqueta obrigatória do stream

Ative o listener NDI¶

Abra a aba Servidor do streamer escolhido, encontre os ajustes de listeners e ative Listener NDI. Salve os ajustes.

Listener NDI ativado no servidor escolhido

Campo	Padrão	Finalidade
IP da interface	Não definido	Todas as interfaces IPv4. É possível indicar o IP da interface de rede para NDI.
Porta do catálogo NDI	`5960`	Catálogo TCP compartilhado das fontes deste servidor.
Faixa de portas de mídia	`5961`–`6060`	Uma porta TCP alocada automaticamente por stream anunciado.
Fila	`4`	Limite da fila de cada receptor em imagens completas; um par de campos conta como uma imagem.

O IP de vinculação deve pertencer ao servidor. A porta do catálogo deve ficar fora da faixa de mídia. Permita que os receptores acessem por TCP o catálogo e a faixa de mídia; a descoberta mDNS também precisa da porta UDP 5353 na rede local. Alterar a porta do catálogo de 5960 pode impedir a descoberta somente por IP no NDI Access Manager.

Deixe IP da interface vazio para usar todas as interfaces IPv4.

Prepare o sinal e habilite a saída¶

A saída NDI codifica um sinal sem compressão já preparado. Ela seleciona a primeira faixa de vídeo raw adequada e a primeira faixa de áudio raw adequada do stream, ignorando as faixas comprimidas.

Vídeo: v210 ou uyvy422.
Áudio:
- PCM de 16 bits
- S32P
- FLTP
Sem áudio: a saída somente de vídeo é permitida.

Se a fonte já fornece faixas adequadas, não é necessária decodificação adicional. Para uma fonte comprimida, abra Transcodificador e prepare uma saída raw, por exemplo com RAW para SDI (v210) + PCM. Apesar do nome, as faixas desse preset também servem para NDI. O listener NDI não decodifica H.264/HEVC nem converte AAC em PCM. Ao alterar o transcodificador de um stream existente, mantenha também as faixas comprimidas necessárias aos demais receptores.

Em Saída, ative Publicar este stream em NDI. A Qualidade SpeedHQ padrão é 90; os valores permitidos são 52–99. Salve o stream e aguarde sua execução no servidor fixado. O primeiro receptor NDI inicia apenas o codificador NDI; sua conexão não inicia um stream parado.

Publicação do stream em NDI

Sem receptores NDI conectados, «Codificador parado» e «Sem sinal» são estados esperados: o processamento NDI começa quando o primeiro espectador se conecta.

Conecte um receptor¶

Na lista de fontes do receptor NDI, selecione nome-servidor (nome-stream), por exemplo studio-a (conference). Cada stream habilitado aparece como uma fonte independente; vários receptores podem se conectar à mesma fonte.

A saída usa NDI High Bandwidth com SpeedHQ, em vez de NDI HX. Deixe o transporte do receptor em Auto: a saída atual usa TCP. Não se configura um endereço de destino de push no Agora para essa saída; o receptor abre a conexão.

Estado e desligamento¶

Os ajustes da saída NDI mostram o endereço da porta de mídia e o número de espectadores, além do estado do codificador e do sinal. Erros de preparação ou publicação aparecem no mesmo local.

Primeiro espectador: inicia o codificador NDI; os receptores seguintes usam a mesma fonte.
Sem espectadores por 20 segundos: o codificador para, mas o anúncio e a porta de mídia são mantidos.
Saída do stream ou listener desativado: as conexões são fechadas imediatamente e os anúncios são removidos.

A conexão é mantida durante uma ausência temporária de quadros. A saída NDI não gera vídeo preto nem silêncio: configure uma fonte reserva se precisar de uma vinheta. Se a conexão com o central for perdida, o servidor continua servindo a configuração que já aplicou.

Se o receptor não mostrar vídeo¶

Sintoma	O que verificar
A fonte não aparece	A atribuição ao servidor fixado, os dois interruptores NDI, o acesso ao catálogo e a descoberta mDNS.
Não há portas disponíveis	A faixa de mídia e as portas ocupadas por outros processos. Cada fonte anunciada precisa de uma porta, mesmo sem espectadores.
A fonte aparece, mas não há sinal	O stream está ativo, contém vídeo raw adequado e a saída NDI não mostra erro.
Não há áudio	O stream contém uma faixa de áudio sem compressão compatível. AAC sozinho não serve.
Um receptor lento é desconectado	A capacidade da rede e a carga do receptor. Quando a fila limitada enche, o servidor descarta imagens completas; após 5 segundos de descartes contínuos, desconecta esse cliente.