Implementar Fuentes de Video NDI en Aplicaciones .NET¶

Video Capture SDK .Net VideoCaptureCoreX VideoCaptureCore

Introducción a la Tecnología NDI¶

Network Device Interface (NDI) es un estándar de alto rendimiento para flujos de trabajo de producción basados en IP, desarrollado por NewTek. Permite que productos compatibles con video se comuniquen, entreguen y reciban video de calidad broadcast sobre una conexión de red estándar con baja latencia.

Nuestro SDK proporciona soporte robusto para fuentes NDI, permitiendo que tus aplicaciones .NET se integren perfectamente con cámaras NDI y software habilitado para NDI. Esto lo hace ideal para entornos de producción en vivo, aplicaciones de streaming, soluciones de videoconferencia y cualquier sistema que requiera integración de video de red de alta calidad.

Prerrequisitos para Integración NDI¶

Antes de implementar funcionalidad NDI en tu aplicación, necesitarás instalar uno de los siguientes:

• NDI SDK - Recomendado para desarrolladores construyendo aplicaciones profesionales
• NDI Tools - Suficiente para pruebas básicas y desarrollo

Estas herramientas proporcionan los componentes de tiempo de ejecución necesarios para la comunicación NDI. Después de la instalación, tu sistema podrá descubrir y conectarse a fuentes NDI en tu red.

Para reproducción en Android, instale el NDI Advanced SDK for Android y empaquete los archivos libndi.so específicos por ABI con su APK. Las muestras Android y MAUI NDI Player buscan el directorio Lib del SDK usando primero la propiedad MSBuild NdiAndroidSdkLib, después la variable de entorno NDI_ANDROID_SDK_LIB y finalmente C:\Program Files\NDI\NDI 6 SDK (Android)\Lib.

Las aplicaciones Android que descubren fuentes NDI deben solicitar estos permisos:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />

Descubrir Fuentes NDI en Tu Red¶

El primer paso para trabajar con NDI es enumerar las fuentes disponibles. Nuestro SDK hace este proceso sencillo con métodos dedicados para escanear tu red en busca de dispositivos y aplicaciones habilitados para NDI.

Enumerar Fuentes NDI Disponibles¶

var lst = await VideoCapture1.IP_Camera_NDI_ListSourcesAsync();
foreach (var uri in lst)
{
    cbIPCameraURL.Items.Add(uri);
}

var lst = await DeviceEnumerator.Shared.NDISourcesAsync();
foreach (var uri in lst)
{
    cbIPCameraURL.Items.Add(uri.URL);
}

Los métodos de enumeración asíncronos escanean tu red y devuelven una lista de fuentes NDI disponibles. Cada fuente tiene un identificador único que usarás para establecer una conexión. El proceso de enumeración típicamente toma unos segundos, dependiendo de las condiciones de red y el número de fuentes disponibles.

Para interfaces de reproducción, suscríbase a NDISourcesChanged e inicie el watcher para que la lista de fuentes refleje transmisores que aparecen o desaparecen después del escaneo inicial:

DeviceEnumerator.Shared.NDISourcesChanged += OnNDISourcesChanged;
DeviceEnumerator.Shared.StartNDISourceWatch();

Detenga el watcher y cancele la suscripción durante el cierre de la aplicación.

Conectar a Fuentes NDI¶

Una vez que has identificado las fuentes NDI en tu red, el siguiente paso es establecer una conexión. Esto implica crear el objeto de configuración apropiado y configurarlo para tus requisitos específicos.

Configurar Ajustes de Fuente NDI¶

// Crear un objeto de configuración de fuente de cámara IP
settings = new IPCameraSourceSettings
{
    URL = new Uri("URL de fuente NDI")
};

// Establecer el tipo de fuente a NDI
settings.Type = IPSourceEngine.NDI;

// Habilitar o deshabilitar captura de audio
settings.AudioCapture = false;

// Establecer información de inicio de sesión si es necesario
settings.Login = "usuario";
settings.Password = "contraseña";

// Establecer la fuente de cámara IP
VideoCapture1.IP_Camera_Source = settings;

// Selecciona el modo operativo antes de StartAsync:
//   IPPreview — solo vista previa en vivo (sin salida a archivo).
//   IPCapture — vista previa + grabación al destino Output_Format configurado.
VideoCapture1.Mode = VideoCaptureMode.IPPreview;   // o VideoCaptureMode.IPCapture

await VideoCapture1.StartAsync();

var ndiSettings = await NDISourceSettings.CreateAsync(VideoCapture1.GetContext(), null, "URL NDI");

var ndiSettings = await NDISourceSettings.CreateAsync(VideoCapture1.GetContext(), cbIPURL.Text, null);

VideoCapture1.Video_Source = ndiSettings;

Patrón de Reproductor NDI en Android y MAUI¶

Las demos Video Capture SDK X Android y MAUI NDI Player usan VideoCaptureCoreX como receptor/reproductor NDI simple. El mismo flujo sirve para reproductores de pantalla completa, herramientas de monitorización y paneles de previsualización:

1. Inicialice el SDK.
2. Enumere fuentes NDI con DeviceEnumerator.Shared.NDISourcesAsync().
3. Mantenga la lista actualizada con NDISourcesChanged y StartNDISourceWatch().
4. Cree NDISourceSettings desde la NDISourceInfo seleccionada.
5. Asigne la configuración a VideoCaptureCoreX.Video_Source.
6. Habilite reproducción de audio solo cuando la fuente seleccionada exponga streams de audio.
7. Detenga y libere el core cuando se detenga la reproducción o se cierre la vista.

var sources = await DeviceEnumerator.Shared.NDISourcesAsync();
var info = sources[0];

var settings = await NDISourceSettings.CreateAsync(null, info);
if (settings == null || !settings.IsValid())
{
    throw new InvalidOperationException("No se pudo crear la configuración de fuente NDI.");
}

var core = new VideoCaptureCoreX(videoView);
core.Video_Source = settings;
core.Audio_Play = settings.GetInfo()?.AudioStreams?.Count > 0;

await core.StartAsync();

UI Android Nativa¶

La muestra Android usa VisioForge.Core.UI.Android.VideoViewGL como superficie de renderizado:

var core = new VideoCaptureCoreX(videoView);

En Android, solicite los permisos de red y multicast antes del descubrimiento. Si la aplicación se compila sin libndi.so para el ABI actual, la reproducción fallará en tiempo de ejecución con DllNotFoundException; verifique la ruta Lib del NDI Advanced SDK antes de empaquetar.

UI .NET MAUI¶

La muestra MAUI registra los handlers de VisioForge en MauiProgram:

builder
    .UseMauiApp<App>()
    .ConfigureMauiHandlers(handlers => handlers.AddVisioForgeHandlers());

Cree VideoCaptureCoreX con la vista de plataforma obtenida desde el VideoView de MAUI:

var core = new VideoCaptureCoreX(videoView.GetVideoView());

Durante el cierre, cancele enumeraciones pendientes, cancele la suscripción a NDISourcesChanged, llame a StopNDISourceWatch(), detenga y libere VideoCaptureCoreX, y destruya el SDK si su aplicación controla el ciclo de vida del SDK.

Opciones avanzadas de configuración NDI¶

Optimización del rendimiento¶

Al trabajar con fuentes NDI, las consideraciones de rendimiento son importantes, especialmente en entornos profesionales. Aquí algunos consejos para optimizar tu implementación NDI:

1. Ancho de banda de red: asegúrate de que tu red disponga de ancho de banda suficiente para los flujos NDI. Un flujo NDI HD típico requiere aproximadamente 100-150 Mbps.

2. Aceleración por hardware: habilita la aceleración por hardware cuando esté disponible para reducir el uso de CPU y mejorar el rendimiento.

3. Control de tasa de fotogramas: considera limitar la tasa de fotogramas si no necesitas la máxima calidad, lo que puede reducir la carga de red.

4. Configuración de resolución: elige ajustes de resolución apropiados según las necesidades de tu aplicación y el ancho de banda disponible.

Gestión de múltiples fuentes NDI¶

Para aplicaciones que necesitan manejar múltiples fuentes NDI simultáneamente:

1. Crea instancias de captura separadas para cada fuente NDI
2. Implementa un pool de recursos para gestionar eficientemente los recursos del sistema
3. Considera usar un patrón productor/consumidor para procesar múltiples flujos
4. Supervisa el rendimiento del sistema y ajusta la configuración según sea necesario

Manejo de errores y solución de problemas¶

Al implementar la funcionalidad NDI, es importante manejar los posibles problemas con elegancia:

Problemas comunes de conexión NDI¶

1. Fuente no encontrada: verifica que la fuente NDI esté activa y en la misma red
2. Timeout de conexión: revisa la configuración de red y los ajustes del firewall
3. Fallo de autenticación: asegúrate de que las credenciales sean correctas si se requiere autenticación
4. Problemas de rendimiento: supervisa el uso de CPU y red durante la captura

Implementación de manejo de errores robusto¶

// El SDK no expone tipos de excepción específicos de NDI — los elementos GStreamer subyacentes
// reportan fallos como Exception genérica. Bifurca según el resultado del descubrimiento
// (null / vacío) para "fuente no encontrada", y en el fallo de CreateAsync para problemas de conexión.
try
{
    var discovered = await DeviceEnumerator.Shared.NDISourcesAsync();
    var match = discovered.FirstOrDefault(s => s.URL == ndiUrl);
    if (match == null)
    {
        Log.Error($"NDI source not found on the network: {ndiUrl}");
        return;
    }

    var ndiSettings = await NDISourceSettings.CreateAsync(VideoCapture1.GetContext(), match);
    VideoCapture1.Video_Source = ndiSettings;
}
catch (Exception ex)
{
    // Todos los fallos (descubrimiento, creación de configuración, inicialización de elementos GStreamer, etc.)
    Log.Error($"Failed to connect to NDI source: {ex.Message}");
}

Integración con flujos de procesamiento de video¶

Las fuentes NDI pueden integrarse de forma transparente con otros componentes de tu pipeline de procesamiento de video:

1. Grabación: captura flujos NDI a diversos formatos de archivo
2. Streaming en vivo: reenvía contenido NDI a servicios de streaming
3. Procesamiento de video: aplica filtros y efectos a fuentes NDI en tiempo real
4. Composición multi-vista: combina múltiples fuentes NDI en una única salida

Aplicaciones de ejemplo y referencias de código¶

Para ayudarte a empezar con la implementación NDI, proporcionamos varias aplicaciones de ejemplo que demuestran distintos aspectos de la funcionalidad NDI.

Mejores prácticas para la implementación NDI¶

Para garantizar un rendimiento y fiabilidad óptimos al trabajar con fuentes NDI:

1. Realiza enumeración regular de fuentes: las condiciones de red y las fuentes disponibles pueden cambiar; vuelve a enumerar las fuentes periódicamente.

2. Implementa lógica de reintento de conexión: pueden ocurrir interrupciones de red; implementa intentos de reconexión automática.

3. Supervisa la salud del flujo: rastrea la tasa de fotogramas, latencia y estabilidad de conexión para detectar problemas potenciales.

4. Maneja desconexiones de fuente con elegancia: implementa controladores de eventos para desconexiones inesperadas.

5. Prueba con diversas fuentes NDI: diferentes implementaciones de NDI pueden tener ligeras variaciones; prueba con varias fuentes.

6. Empaqueta bibliotecas nativas Android por ABI: para receptores Android, incluye libndi.so para cada ABI que distribuyas. Las bibliotecas ABI faltantes producen fallos en tiempo de ejecución aunque el APK se compile.

7. Respeta el ciclo de vida móvil: detén la reproducción cuando se detengan actividades Android o se cierren páginas/ventanas MAUI, libera el core, cancela la enumeración de fuentes y quita los controladores de eventos del watcher.

Conclusión¶

La tecnología NDI ofrece capacidades potentes para la integración de video por red en aplicaciones .NET. Con nuestro SDK, puedes incorporar fácilmente video de alta calidad y baja latencia desde fuentes NDI en tus proyectos de software. Ya sea que estés construyendo un sistema de producción en vivo, una aplicación de videoconferencia o cualquier solución que requiera video por red, nuestra implementación NDI proporciona las herramientas que necesitas para tener éxito.

Los ejemplos de código proporcionados demuestran los patrones esenciales para trabajar con fuentes NDI, desde la enumeración y conexión hasta la captura y procesamiento. Siguiendo estos patrones y mejores prácticas, puedes crear aplicaciones habilitadas para NDI robustas que ofrecen rendimiento y fiabilidad excepcionales.

Documentación relacionada¶

• Visión general de cámaras IP — tipos de fuentes RTSP, ONVIF y NDI de un vistazo
• Configuración de fuente de cámara RTSP — protocolo de cámara IP más común
• Integración de cámara IP ONVIF — descubrimiento y control PTZ estándar
• Tutorial de vista previa en vivo de cámara IP — ejemplo mínimo de vista previa
• Inmersión profunda en el protocolo RTSP — internos del protocolo de streaming
• Guía de salida streaming NDI — enviar cámaras, dispositivos de captura y archivos a NDI

Visita nuestra página de GitHub para acceder a muestras de código adicionales y recursos de implementación.