Reproducción por NDI¶
Agora anuncia cada stream como una fuente NDI independiente en la red local. El receptor descubre la fuente y se conecta a ella. La reproducción requiere Listener NDI en el streamer y Publicar este stream en NDI en el propio stream.
NDI no tiene autenticación. Actívelo solo en una red de confianza: cualquier usuario con acceso de red puede conectarse a una fuente anunciada sin un token de reproducción de Agora.
Fije el stream a un servidor¶
Actualmente, la configuración de NDI en un clúster empieza por fijar el stream a un servidor concreto mediante labels con el requisito required_…. Active el listener NDI en ese mismo servidor.
- Abra Clúster → Streamers, seleccione un servidor en la red de los receptores NDI y añada
ndi-studio-aen Etiquetas, en la pestaña Clúster. Guarde los ajustes. - Compruebe que solo el servidor elegido tiene esta etiqueta. Si la tienen varios servidores, el requisito permite asignar el stream a cualquiera de ellos.
- Abra el stream en Streams. En la pestaña Layout, añada
required_ndi-studio-ay guarde el stream. - Active el listener como se indica a continuación y compruebe la asignación en Layout: el stream debe estar activo en el servidor elegido.
required_ es una condición obligatoria de asignación; preferred_ solo expresa una preferencia y no fija el stream. También deben coincidir el namespace y las demás etiquetas. Si el único servidor apto no está disponible, el stream no se asignará a otro servidor sin esta etiqueta.


Active el listener NDI¶
Abra la pestaña Servidor del streamer elegido, busque los ajustes de listeners y active Listener NDI. Guarde los ajustes.

| Campo | Valor predeterminado | Función |
|---|---|---|
| IP de la interfaz | Sin definir | Todas las interfaces IPv4. Puede indicar la IP de la interfaz de red para NDI. |
| Puerto del catálogo NDI | 5960 |
Catálogo TCP compartido de las fuentes de este servidor. |
| Rango de puertos de medios | 5961–6060 |
Un puerto TCP asignado automáticamente por cada stream anunciado. |
| Cola | 4 |
Límite de cola de cada receptor en imágenes completas; un par de campos cuenta como una imagen. |
La IP de la interfaz debe pertenecer al servidor. El puerto del catálogo debe quedar fuera del rango de medios. Permita a los receptores acceder por TCP al catálogo y al rango de medios; el descubrimiento mDNS también necesita el puerto UDP 5353 en la red local. Si cambia el puerto del catálogo 5960, la búsqueda solo por IP en NDI Access Manager puede dejar de funcionar.
Deje IP de la interfaz vacío para usar todas las interfaces IPv4.
Prepare la señal y habilite la salida¶
La salida NDI codifica una señal sin comprimir ya preparada. Selecciona la primera pista de vídeo raw apta y la primera pista de audio raw apta del stream, omitiendo las pistas comprimidas.
- Vídeo:
v210ouyvy422. -
Audio:
- PCM de 16 bits
- S32P
- FLTP
-
Sin audio: se admite la salida solo de vídeo.
Si la fuente ya proporciona pistas aptas, no hace falta decodificación adicional. Para una fuente comprimida, abra Transcodificador y prepare una salida raw, por ejemplo con RAW para SDI (v210) + PCM. Aunque su nombre mencione SDI, sus pistas también sirven para NDI. El listener NDI no decodifica H.264/HEVC ni convierte AAC a PCM. Al modificar el transcodificador de un stream existente, conserve también las pistas comprimidas que necesiten sus demás receptores.
En Egreso, active Publicar este stream en NDI. La Calidad SpeedHQ predeterminada es 90; el rango permitido es 52–99. Guarde el stream y espere a que esté activo en el servidor fijado. El primer receptor NDI solo inicia el codificador NDI; su conexión no inicia un stream detenido.

Sin receptores NDI conectados, «Codificador detenido» y «Sin señal» son estados esperados: el procesamiento NDI empieza al conectarse el primer espectador.
Conecte un receptor¶
En la lista de fuentes del receptor NDI, seleccione nombre-servidor (nombre-stream), por ejemplo studio-a (conference). Cada stream habilitado aparece como una fuente independiente; varios receptores pueden conectarse a la misma fuente.
La salida utiliza NDI High Bandwidth con SpeedHQ, en lugar de NDI HX. Deje el transporte del receptor en Auto: la salida actual utiliza TCP. No se configura una dirección de destino de push en Agora para esta salida; el receptor abre la conexión.
Estado y desconexión¶
Los ajustes de salida NDI muestran la dirección del puerto de medios y el número de espectadores, junto con el estado del codificador y de la señal. Los errores de preparación o publicación se muestran en el mismo lugar.
- Primer espectador: inicia el codificador NDI; los receptores siguientes usan la misma fuente.
- Sin espectadores durante 20 segundos: el codificador se detiene, pero se mantienen el anuncio y el puerto de medios.
- Salida del stream o listener desactivado: las conexiones se cierran inmediatamente y se retiran los anuncios.
La conexión se mantiene si faltan fotogramas temporalmente. La salida NDI no genera vídeo negro ni silencio: configure una fuente de reserva si necesita una cortinilla. Si se pierde la conexión con central, el servidor sigue sirviendo la configuración que ya ha aplicado.
Si el receptor no muestra vídeo¶
| Síntoma | Qué comprobar |
|---|---|
| La fuente no aparece | La asignación al servidor fijado, ambos interruptores NDI, el acceso al catálogo y el descubrimiento mDNS. |
| No quedan puertos | El rango de medios y los puertos ocupados por otros procesos. Cada fuente anunciada necesita un puerto, incluso sin espectadores. |
| La fuente aparece, pero no hay señal | El stream está activo, tiene vídeo raw apto y la salida NDI no muestra errores. |
| No hay audio | El stream contiene una pista de audio sin comprimir compatible. AAC por sí solo no sirve. |
| Se desconecta un receptor lento | La capacidad de la red y la carga del receptor. Al llenarse la cola limitada, el servidor descarta imágenes completas; después de 5 segundos de descartes continuos desconecta a ese cliente. |