NDI¶

media.ingest.ndi

Descrição¶

O Sapsan recebe vídeo e áudio de fontes NDI na rede local. Conecte-se à porta de mídia ou selecione o nome exato no catálogo do emissor. Com decode: false, o servidor pula a descompressão SpeedHQ e encaminha o vídeo comprimido.

Configuração¶

Configure o stream pela API do central. Trecho de configuração:

streams:
- name: source1
  inputs:
  - ndi:
      url: ndi://192.0.2.10:5961
      transport: tcp
      decode: false

Parâmetros¶

Campo	Descrição
`url`	`ndi://host[:port]`, sem caminho nem credenciais.
`source`	nome exato do catálogo; omita para conexão direta.
`transport`	transporte escolhido.
`multicast_interface`	endereço IPv4 local para multicast.
`decode`	descomprimir SpeedHQ (`true` por padrão); `false` preserva quadros comprimidos.
`peer_timeout_ms`	tempo limite sem dados.

Opções de transporte¶

TCP — tcp, padrão.
UDP unicast — udp_unicast.
UDP multicast — udp_multicast.
RUDP/QUIC — rudp.

Os metadados de controle usam TCP. Selecionar UDP não ativa a troca automática para mídia TCP.

Codecs compatíveis¶

SpeedHQ SHQ0
SpeedHQ SHQ2
SpeedHQ SHQ4
SpeedHQ SHQ7
SpeedHQ SHQ9
PCM s16
Float32 audio

SpeedHQ é vídeo NDI comprimido. Com decode: false, a entrada passa esses frames sem descompressão; com decode: true, ela os decodifica em planos YUV de 8 bits sem compressão. PCM s16 e Float32 são formatos de amostras de áudio sem compressão. O suporte a NDI não implica suporte a H.264/HEVC de NDI HX.

Comportamento em caso de erro¶

O estado da entrada e a causa da falha estão nas estatísticas do stream. Desconexão ou ausência de quadros usa os mecanismos de repetição e comutação para reserva.

Aplicação de alterações¶

Aplique as alterações pela API do central. Alterar o endereço ou o formato reabre a captura e pode interrompê-la durante a conexão. Verifique depois o estado e a chegada de quadros.

Contadores¶

bytes conta bytes recebidos; video_frames e audio_frames, quadros recebidos. frames_dropped conta perdas na montagem ou fila. packets_lost conta datagramas UDP perdidos; packets_repeated, repetidos; fec_packets_recovered, recuperados por FEC. quic_stream_retransmits e quic_stream_retransmit_bytes descrevem retransmissão QUIC local de saída, não perda de vídeo recebido.

As tabelas mostram os nomes exatos dos campos de estatísticas do protocolo, incluindo contadores de eventos e indicadores do valor atual. Campos zerados podem ser omitidos. API e Prometheus expõem projeções diferentes; uma única resposta da Admin API não contém necessariamente toda a lista. O detalhe depende da licença de contadores.

Totais comuns da entrada: bytes, frames, errors, warnings. Eles agregam dados do protocolo; não devem ser somados novamente aos contadores do protocolo.

Ndi¶

Campo	Tipo
`memory_bytes`	`gauge`
`bytes`	`counter`
`video_frames`	`counter`
`audio_frames`	`counter`
`metadata_frames`	`counter`
`errors_video_decoder`	`counter`
`errors_audio_decoder`	`counter`
`frames_dropped`	`counter`
`datagrams`	`counter`
`packets_lost`	`counter`
`packets_repeated`	`counter`
`repeated_bytes`	`counter`
`fec_packets_recovered`	`counter`
`fec_bytes`	`counter`
`quic_packets_lost`	`counter`
`quic_stream_retransmits`	`counter`
`quic_stream_retransmit_bytes`	`counter`
`quic_receive_queue_bytes`	`gauge`

Outros detalhes¶

Com decode: false, o próximo consumidor deve aceitar SpeedHQ comprimido. Adicione transcodificação para saída HLS. decode: true expande o vídeo em quadros sem compressão e aumenta a carga de CPU e memória.