Skip to content

NDI

media.play.ndi

Serve um stream ativo a receptores NDI. A tabela de tarifas contabiliza essa capacidade por stream: uma fonte anunciada pode servir a vários receptores. A saída exige o listener do streamer e a permissão de saída NDI no stream.

Transporte

NDI High Bandwidth com SpeedHQ, servido por TCP. Use Auto no receptor. O catálogo compartilhado do servidor usa TCP 5960; as portas de mídia são alocadas automaticamente em TCP 5961–6060. Cada fonte anunciada precisa de uma porta de mídia. A descoberta local usa mDNS por UDP 5353.

A saída NDI não tem autenticação. Restrinja o acesso à rede a receptores confiáveis; não é solicitado um token de reprodução. Essa capacidade não fornece NDI HX nem um push para um endereço de destino pré-configurado.

Preparação das faixas

O codificador NDI usa faixas raw preparadas de um stream ativo:

  • Vídeo: a primeira faixa v210 ou uyvy422 adequada na ordem de MediaInfo.

  • Áudio: a primeira faixa adequada em um destes formatos:

    • PCM de 16 bits
    • S32P
    • FLTP

  • Sem áudio: a saída somente de vídeo é permitida.

As faixas comprimidas são ignoradas. Configure separadamente a decodificação da entrada comprimida e o formato de pixel necessário, como na saída SDI. As faixas raw não são combinadas e a saída NDI não oferece seleção pelo número da faixa. Um stream existente pode manter faixas comprimidas para outros receptores e adicionar faixas raw adequadas.

Configuração

Configure os ajustes pelo central. Na configuração atual do cluster, fixe o stream em um servidor específico: atribua ao streamer o valor exclusivo de labels, ndi-studio-a, e ao stream required_ndi-studio-a. Ative o listener nesse mesmo servidor. Se vários servidores tiverem a etiqueta, a atribuição será permitida em qualquer um deles. O procedimento está no guia do Agora.

Trecho da configuração aplicada ao streamer com entrada SDI raw:

listeners:
  ndi:
    bind: 192.168.10.20
    port: 5960
    ports: {from: 5961, to: 6060}
    queue: 4
streams:
  - name: conference
    inputs:
      - sdi:
          device: /dev/video0
          pixel_format: v210
    ndi_output:
      quality: 90

Substitua o endereço e o dispositivo pelos seus. Para uma entrada comprimida, prepare as faixas raw com o transcodificador. A conexão de um receptor NDI não inicia um stream parado.

Campo Valor e restrições
listeners.ndi Omitir a seção desativa o listener.
bind IP opcional da interface; quando omitido, são usadas todas as interfaces IPv4.
port Porta do catálogo, padrão 5960; deve ficar fora da faixa de mídia.
ports.from, ports.to Limites inclusivos das portas de mídia, padrão 5961 e 6060.
queue Limite positivo da fila de cada cliente em imagens completas, padrão 4; um par de campos conta como uma imagem.
ndi_output Omitir a seção desativa a reprodução NDI desse stream.
quality Qualidade SpeedHQ fixa de 52 a 99, padrão 90, sem ajuste adaptativo.

Permita que os receptores acessem o catálogo e as portas de mídia. Uma porta de catálogo diferente da padrão pode impedir a descoberta somente por IP no NDI Access Manager.

Reprodução e estado

Selecione nome-servidor (nome-stream) no receptor NDI. O receptor abre a conexão; vários receptores compartilham um codificador NDI. O primeiro espectador inicia o codificador, que para após 20 segundos sem espectadores. O anúncio e a porta alocada são mantidos até a saída ser desativada.

O estado aparece em ndi_output nas estatísticas do stream. address e viewers indicam o endereço da porta de mídia e o número de espectadores admitidos; encoder_running e signal indicam o estado do codificador e se uma imagem completa foi preparada no último segundo. error descreve falhas de preparação ou publicação.

As conexões são mantidas quando os quadros deixam de chegar; a saída NDI não gera vídeo preto nem silêncio. Prepare uma vinheta pela fonte reserva do stream. A fila limitada de um cliente lento primeiro descarta imagens completas; após 5 segundos de descartes contínuos, esse cliente é desconectado. Desativar ndi_output ou o listener fecha imediatamente as conexões e remove os anúncios.