Mezclar Múltiples Flujos de Video en Aplicaciones .NET¶

Video Capture SDK .Net

Introducción a la Mezcla de Flujos de Video¶

El SDK proporciona capacidades poderosas para mezclar varios flujos de video con diferentes resoluciones y tasas de fotogramas. Esta funcionalidad es esencial para crear aplicaciones de video profesionales que requieren efectos Picture-in-Picture, vistas multi-cámara o salidas de visualización combinadas.

Características Clave de la Mezcla de Video¶

• Combinar múltiples fuentes de video en una sola salida
• Soporte para diferentes resoluciones de video y tasas de fotogramas
• Múltiples opciones de layout (horizontal, vertical, cuadrícula, personalizado)
• Ajustes de posición y parámetros en tiempo real
• Controles de transparencia y volteo
• Soporte para diversas fuentes de entrada (cámaras, pantallas, cámaras IP)

Motor VideoCaptureCore¶

El proceso de implementación implica tres pasos principales:

1. Configurar el modo de mezcla de video
2. Añadir múltiples fuentes de video
3. Configurar y ajustar parámetros de fuentes

Exploremos cada paso en detalle con ejemplos de código.

Configurar Modo de Mezcla de Video¶

El SDK soporta varios layouts predefinidos así como configuraciones personalizadas.

Layout de Pila Horizontal¶

Este modo organiza todas las fuentes de video horizontalmente en una fila:

VideoCapture1.PIP_Mode = PIPMode.Horizontal;

Layout de Pila Vertical¶

Este modo organiza todas las fuentes de video verticalmente en una columna:

VideoCapture1.PIP_Mode = PIPMode.Vertical;

Layout de Cuadrícula (2×2)¶

Este modo organiza hasta cuatro fuentes de video en una cuadrícula cuadrada:

VideoCapture1.PIP_Mode = PIPMode.Mode2x2;

Layout Personalizado con Resolución Específica¶

Para escenarios avanzados, puedes definir un layout personalizado con dimensiones de salida precisas:

VideoCapture1.PIP_Mode = PIPMode.Custom;
VideoCapture1.PIP_CustomOutputSize_Set(1920, 1080);

Añadir Fuentes de Video¶

La primera fuente configurada sirve como entrada principal, mientras que fuentes adicionales pueden añadirse usando la API PIP.

Añadir un Dispositivo de Captura de Video¶

Para incorporar una cámara u otro dispositivo de captura de video:

// Firma: (string deviceName, string format, bool useBestFormat, VideoFrameRate frameRate,
//         string crossbarInput, int left, int top, int width, int height) → bool
VideoCapture1.PIP_Sources_Add_VideoCaptureDevice(
    deviceName:     "USB Camera",                     // nombre obtenido de Video_CaptureDevices()
    format:         "1280x720 30fps",                 // string de formato, o vacío + useBestFormat=true
    useBestFormat:  false,
    frameRate:      new VideoFrameRate(30),
    input:          null,                             // nombre del crossbar input, o null
    left: 100, top: 100, width: 320, height: 240);

Añadir una Fuente de Cámara IP¶

Para cámaras basadas en red:

var fuenteCamaraIP = new IPCameraSourceSettings
{
    URL = new Uri("rtsp://192.168.1.1:554/live") // URL es Uri, no string
};

// Establecer parámetros adicionales de cámara IP según sea necesario
// Autenticación, protocolo, buffering, etc.

VideoCapture1.PIP_Sources_Add_IPCamera(
    fuenteCamaraIP,
    izquierda,
    arriba,
    ancho,
    alto);

Añadir una Fuente de Captura de Pantalla¶

Para incluir escritorio o ventanas de aplicación:

ScreenCaptureSourceSettings fuentePantalla = new ScreenCaptureSourceSettings();
fuentePantalla.Mode = ScreenCaptureMode.Screen;
fuentePantalla.FullScreen = true;
VideoCapture1.PIP_Sources_Add_ScreenSource(
    fuentePantalla,
    izquierda,
    arriba,
    ancho,
    alto);

Ajustes Dinámicos de Fuentes¶

Una ventaja principal del SDK es la capacidad de ajustar parámetros de fuentes en tiempo real durante la operación.

Reposicionar Fuentes¶

Puedes modificar la posición y dimensiones de cualquier fuente:

// SetSourcePositionAsync recibe (int index, Rectangle rect).
await VideoCapture1.PIP_Sources_SetSourcePositionAsync(
    indice,                                            // 0 es fuente principal, 1+ son fuentes adicionales
    new System.Drawing.Rectangle(izquierda, arriba, ancho, alto));

Ajustar Propiedades Visuales¶

Ajusta finamente la apariencia con controles de transparencia y orientación:

int transparencia = 127; // Rango: 0-255
bool voltearX = false;
bool voltearY = false;

// SetSourceSettingsAsync recibe (int index, int transparency, bool flipX, bool flipY, bool disabled = false).
await VideoCapture1.PIP_Sources_SetSourceSettingsAsync(
    indice,
    transparencia,
    voltearX,
    voltearY);

Dependencias Requeridas¶

Para usar la funcionalidad de mezcla de video, asegúrate de incluir los paquetes redistribuibles apropiados:

• Video capture redistributables:
• Paquete x86
• Paquete x64

Motor VideoCaptureCoreX¶

El motor VideoCaptureCoreX es una versión más nueva del motor VideoCaptureCore que proporciona características adicionales y mejoras.

Mezcla de Video con VideoCaptureCoreX¶

El motor VideoCaptureCoreX ofrece un enfoque más flexible y poderoso para la mezcla de video a través de la clase VideoMixerSourceSettings.

Configuración Básica¶

using System;
using System.Threading.Tasks;
using VisioForge.Core.Types.MediaInfo;
using VisioForge.Core.Types.X.Sources;
using VisioForge.Core.Types.X.VideoCapture;

// Crear un mezclador de video con resolución 1080p a 30fps
var mezcladorVideo = new VideoMixerSourceSettings(1920, 1080, VideoFrameRate.FPS_30);

// Inicializar el motor VideoCaptureCoreX
var captureX = new VideoCaptureCoreX();
captureX.Video_Source = mezcladorVideo;

Añadir Múltiples Fuentes¶

Puedes añadir varias fuentes de video al mezclador, posicionando cada una exactamente donde se necesite:

// Rect usa (left, top, right, bottom) — NO (left, top, width, height). Width y
// Height se calculan como Right-Left / Bottom-Top, así que pasar width/height aquí
// da dimensiones negativas en cualquier rectángulo que no comience en el origen.

// Añadir una cámara como primera fuente (fondo de pantalla completa, canvas 1920×1080).
var fuenteCamara = new VideoCaptureDeviceSourceSettings();

// Configurar ajustes de cámara
// ...

mezcladorVideo.Add(fuenteCamara, new Rect(0, 0, 1920, 1080));

// Añadir una fuente de captura de pantalla en la esquina superior derecha, región 640×480.
var fuentePantalla = new ScreenCaptureDX9SourceSettings();
fuentePantalla.CaptureCursor = true;
fuentePantalla.FrameRate = VideoFrameRate.FPS_30;

// left = 1280, top = 0, right = 1280+640 = 1920, bottom = 0+480 = 480.
mezcladorVideo.Add(fuentePantalla, new Rect(1280, 0, 1920, 480));

Reconfigurar fuentes antes de Start¶

VideoMixerSourceSettings es configuración — sus fuentes quedan fijadas en StartAsync. Para cambiar el layout mutas la lista de settings (vía Get/RemoveAt/Add) antes de iniciar el pipeline:

// Inspecciona una fuente en el índice 1 (devuelve Tuple<IVideoMixerSource, Rect, ChromaKeySettingsX>).
var (source, currentRect, chromaKey) = mezcladorVideo.Get(1);

// Intercambia su rectángulo removiendo y re-añadiendo en su lugar.
mezcladorVideo.RemoveAt(1);
mezcladorVideo.Add(source, new Rect(0, 0, 1280, 720), chromaKey);

Para cambios de layout en runtime (actualizar posición mientras el pipeline corre), baja a Media Blocks: construye tu pipeline con un VideoMixerBlock y usa sus métodos Input_Get(Guid) / Input_Update(VideoMixerStream) para mutar posición, tamaño, alpha o z-order sin reiniciar. Ver referencia video-processing de Media Blocks para la API de VideoMixerBlock.

Configuración de salida¶

Configura el destino de salida para tu video mezclado:

// Configurar grabación MP4
captureX.Outputs_Add(new MP4Output("output.mp4"));

// Iniciar captura
await captureX.StartAsync();

// Detener después de un tiempo
await Task.Delay(TimeSpan.FromMinutes(5));
await captureX.StopAsync();

Comparación con Motor VideoCaptureCore¶

Dependencias Requeridas¶

Consulta la página principal de Despliegue para las dependencias más recientes.

Escenarios de Uso Avanzado¶

Las capacidades de mezcla de video habilitan numerosos escenarios de aplicación:

• Monitoreo de seguridad multi-cámara
• Videoconferencia con compartir pantalla
• Broadcasting con superposición de comentarista
• Presentaciones educativas con múltiples entradas
• Streams de gaming con cámara de jugador

Consejos de Solución de Problemas¶

• Asegura que los recursos de hardware sean suficientes para el número de flujos
• Monitorea uso de CPU y memoria durante la operación
• Considera resoluciones más bajas para rendimiento más fluido con muchas fuentes
• Prueba diferentes configuraciones de layout para resultados visuales óptimos

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