Media Blocks SDK para C# .NET — API de Pipeline Multimedia Modular¶
Introducción¶
Media Blocks SDK para .NET es un framework multimedia basado en pipelines que te permite construir flujos de trabajo personalizados de procesamiento de video y audio en C#. En lugar de usar una API fija con comportamiento predefinido, creas un pipeline conectando bloques tipados — fuentes, codificadores, efectos, renderizadores y sinks — para construir exactamente la cadena de procesamiento que tu aplicación necesita.
El SDK se ejecuta en Windows, macOS, Linux, Android e iOS. Cubre casos de uso que los SDKs de nivel superior Video Capture SDK y Media Player SDK no pueden cubrir: composición multi-fuente, pipelines de transcodificación personalizados, codificación simultánea a múltiples formatos, cadenas de efectos de video en tiempo real e integración con hardware como Blackmagic Decklink o cámaras industriales.
Cuándo Usar Media Blocks¶
Media Blocks SDK es la elección correcta cuando necesitas control total sobre el pipeline multimedia. Úsalo en lugar de (o junto con) los otros SDKs de VisioForge cuando:
| Escenario | SDK Recomendado |
|---|---|
| Grabación simple de webcam a MP4 | Video Capture SDK |
| Reproducir un archivo de video con controles estándar | Media Player SDK |
| Pipeline personalizado: fuente → efectos → codificar → múltiples salidas | Media Blocks SDK |
| Composición de video en vivo desde múltiples fuentes | Media Blocks SDK |
| Transcodificación / conversión de formato con procesamiento personalizado | Media Blocks SDK |
| Grabación RTSP con post-procesamiento (overlay, redimensionar, recodificar) | Media Blocks SDK |
| App de medios multiplataforma Avalonia o MAUI | Media Blocks SDK |
| Integración con Decklink, GenICam o hardware NVIDIA | Media Blocks SDK |
Casos de Uso Comunes¶
Transcodificación y Conversión de Formato de Video¶
Convierte archivos de video entre formatos (por ejemplo, AVI a MP4, MKV a WebM) con control total sobre codecs, resolución, bitrate y procesamiento. Encadena bloques de redimensionado, desentrelazado o corrección de color entre la fuente y el codificador.
Captura de Cámara Personalizada con Pipeline de Procesamiento¶
Construye flujos de trabajo de captura de cámara que van más allá de la grabación simple. Inserta efectos en tiempo real, superposiciones de texto o bloques de visión por computadora entre la fuente de cámara y el sink de archivo. Envía a múltiples destinos simultáneamente — ventana de previsualización, archivo y stream de red.
Ver: Tutorial de Aplicación de Visor de Cámara
Composición y Mezcla de Video en Vivo¶
Combina múltiples fuentes de video en una sola salida con el Compositor de Video en Vivo. Posiciona, escala y superpone feeds de video para producción multi-cámara, picture-in-picture o layouts de cuadrícula de vigilancia.
Grabación de Stream RTSP con Post-Procesamiento¶
Captura streams RTSP de cámaras IP y aplica procesamiento antes de guardar — redimensiona a menor resolución, agrega superposiciones de marca de tiempo, recodifica con diferentes configuraciones de calidad o divide en segmentos.
Ver: Guía de Guardado de Stream RTSP | Captura ONVIF con Post-Procesamiento
Superposición de Texto e Imagen / Marca de Agua¶
Agrega superposiciones de texto, imágenes o SVG a video en vivo o archivos grabados usando el Bloque de Gestión de Overlay. Útil para marcas de agua, inserción de marca de tiempo, branding y visualización en pantalla.
Lectura de Códigos de Barras y QR desde Video¶
Procesa feeds de cámara en vivo o archivos de video para detectar y decodificar códigos de barras y códigos QR en tiempo real.
Ver: Guía de Lector de Códigos de Barras y QR
Grabación Pre-Evento¶
Implementa grabación con buffer circular que captura video continuamente y escribe clips de eventos (incluyendo metraje anterior al disparador) en disco.
Ver: Guía de Grabación Pre-Evento
Soporte de Plataformas¶
| Plataforma | Frameworks de UI | Notas |
|---|---|---|
| Windows x64 | WinForms, WPF, MAUI, Avalonia, Consola | Conjunto completo de características incluyendo puentes DirectShow |
| macOS | MAUI, Avalonia, Consola | Acceso a cámara AVFoundation |
| Linux x64 | Avalonia, Consola | Cámara V4L2, procesamiento basado en GStreamer |
| Android | MAUI | Via integración MAUI |
| iOS | MAUI | Via integración MAUI |
Componentes Principales del SDK¶
Fuentes¶
Los Bloques de Fuente ingestan medios desde cámaras, archivos, streams de red, generadores virtuales y hardware de captura.
Procesamiento de Video¶
- Codificadores de Video — H.264, H.265/HEVC, VP8, VP9, AV1 con aceleración GPU (NVENC, AMF, Quick Sync)
- Decodificadores de Video — Decodificación por hardware y software para todos los codecs principales
- Procesamiento de Video — Redimensionar, recortar, rotar, corrección de color, desentrelazar, efectos
- Renderizado de Video — Mostrar video en controles WinForms, WPF, MAUI y Avalonia
- Compositor de Video en Vivo — Mezcla y composición multi-fuente
Procesamiento de Audio¶
- Codificadores de Audio — Codificación AAC, MP3, Vorbis, Opus, FLAC
- Procesamiento de Audio — Filtros, efectos, conversión de frecuencia de muestreo, mezcla de canales
- Renderizado de Audio — Reproducción en dispositivos de audio del sistema
- Visualizadores de Audio — Bloques de visualización de forma de onda y espectro
Salida y Conectividad¶
- Sinks — Escribe a archivos MP4, WebM, AVI, MKV, TS y streams de red
- Bloques de Salida — Configuraciones de salida de alto nivel
- Puentes — Conecta segmentos de pipeline y sincroniza bloques
- Demuxers y Parsers — Demultiplexión y análisis de streams
Hardware y Plataformas Específicas¶
- NVIDIA — Bloques de aceleración por hardware NVENC/NVDEC
- Blackmagic Decklink — Hardware profesional de captura y reproducción
- OpenCV — Integración de visión por computadora
- OpenGL — Procesamiento de video basado en GPU
- AWS — Bloques de integración con la nube
- Servidor RTSP — Sirve video como stream RTSP
Comenzar¶
Listo para construir tu primer pipeline? La Guía de Inicio Rápido para Desarrolladores cubre la instalación, conceptos principales, arquitectura de pipeline y ejemplos de código paso a paso:
Guía de Inicio Rápido para Desarrolladores
Tutoriales adicionales de inicio:
- Implementación Completa de Pipeline
- Desarrollo de Reproductor de Medios
- Aplicación de Visor de Cámara
- Enumeración de Dispositivos
Guías¶
- Guardar Stream RTSP en Archivo
- Visor de Stream RTSP y Reproductor de Cámaras IP
- Captura ONVIF con Post-Procesamiento
- Lector de Códigos de Barras y QR
- Grabación Pre-Evento
- Etiquetas de Metadatos de Audio
- Efectos de Video Personalizados y Shaders OpenGL