NDI¶

media.ingest.ndi

Descripción¶

Sapsan recibe vídeo y audio de fuentes NDI en la red local. Conéctese al puerto de medios o seleccione el nombre exacto del catálogo del emisor. Con decode: false, omite la descompresión SpeedHQ y transmite el vídeo comprimido por el sistema.

Configuración¶

Configure el stream mediante la API de central. Fragmento de configuración:

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

Parámetros¶

Campo	Descripción
`url`	`ndi://host[:port]`, sin ruta ni credenciales.
`source`	nombre exacto del catálogo; omítalo para conexión directa.
`transport`	transporte elegido.
`multicast_interface`	dirección IPv4 local para multicast.
`decode`	descomprimir SpeedHQ (`true` por defecto); `false` conserva fotogramas comprimidos.
`peer_timeout_ms`	tiempo de espera sin datos.

Opciones de transporte¶

TCP — tcp, predeterminado.
UDP unicast — udp_unicast.
UDP multicast — udp_multicast.
RUDP/QUIC — rudp.

Los metadatos de control usan TCP. Seleccionar UDP no activa la vuelta automática a medios TCP.

Códecs admitidos¶

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

SpeedHQ es vídeo NDI comprimido. Con decode: false, la entrada pasa esos frames sin descomprimirlos; con decode: true, los decodifica en planos YUV de 8 bits sin comprimir. PCM s16 y Float32 son formatos de muestras de audio sin comprimir. Admitir NDI no implica admitir H.264/HEVC de NDI HX.

Comportamiento ante errores¶

El estado de la entrada y la causa del fallo están en las estadísticas del stream. Ante desconexión o ausencia de fotogramas se aplican los mecanismos de reintento y conmutación a reserva.

Aplicación de cambios¶

Aplique los cambios mediante la API de central. Cambiar la dirección o el formato vuelve a abrir la captura y puede interrumpirla durante la conexión. Compruebe después el estado y la llegada de fotogramas.

Contadores¶

bytes cuenta bytes entrantes; video_frames y audio_frames, fotogramas recibidos. frames_dropped cuenta pérdidas de ensamblado o cola. packets_lost cuenta datagramas UDP perdidos; packets_repeated, repetidos; fec_packets_recovered, recuperados por FEC. quic_stream_retransmits y quic_stream_retransmit_bytes describen retransmisión QUIC local saliente, no pérdida de vídeo entrante.

Las tablas indican los nombres exactos de los campos de estadísticas del protocolo, incluidos contadores de eventos e indicadores del valor actual. Los campos nulos pueden omitirse. API y Prometheus exponen proyecciones distintas; un único resultado de Admin API no incluye necesariamente toda la lista. El detalle depende de la licencia de contadores.

Totales comunes de entrada: bytes, frames, errors, warnings. Agregan datos del protocolo; no deben sumarse otra vez a los contadores del 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`

Otros detalles¶

Con decode: false, el siguiente consumidor debe aceptar SpeedHQ comprimido. Añada transcodificación para salida HLS. decode: true convierte el vídeo en fotogramas sin comprimir y aumenta carga de CPU y memoria.