Media Blocks SDK .Net - Guía de inicio rápido para desarrolladores¶

Try it Download free trial dotnet add package VisioForge.DotNet.MediaBlocks Pricing →

Introducción¶

Esta guía proporciona un recorrido completo para integrar el Media Blocks SDK .Net en sus aplicaciones. El SDK está construido alrededor de una arquitectura de pipeline modular, permitiéndole crear, conectar y gestionar bloques de procesamiento multimedia para video, audio y más. Ya sea que esté construyendo herramientas de procesamiento de video, soluciones de streaming o aplicaciones multimedia, esta guía le ayudará a comenzar rápida y correctamente.

Proceso de instalación del SDK¶

El SDK se distribuye como un paquete NuGet para fácil integración en sus proyectos .Net. Instálelo usando:

dotnet add package VisioForge.DotNet.MediaBlocks

Para requisitos específicos de plataforma y detalles adicionales de instalación, consulte la guía de instalación detallada.

Conceptos principales y arquitectura¶

MediaBlocksPipeline¶

La clase central para gestionar el flujo de datos de medios entre bloques de procesamiento.
Maneja la adición de bloques, conexión, gestión de estado y manejo de eventos.
Implementa IMediaBlocksPipeline y expone eventos como OnError, OnStart, OnPause, OnResume, OnStop y OnLoop.

MediaBlock e interfaces¶

Cada unidad de procesamiento es un MediaBlock (o una clase derivada), implementando la interfaz IMediaBlock.
Interfaces clave:
IMediaBlock: Interfaz base para todos los bloques. Define propiedades para Name, Type, Input, Inputs, Output, Outputs y métodos para contexto de pipeline y exportación YAML.
IMediaBlockDynamicInputs: Para bloques que soportan creación dinámica de entradas (ej. mezcladores).
IMediaBlockInternals/IMediaBlockInternals2: Para gestión interna del pipeline, construcción y lógica post-conexión.
IMediaBlockRenderer: Para bloques que renderizan medios (ej. renderizadores de video/audio), con propiedad para controlar sincronización de stream.
IMediaBlockSink/IMediaBlockSource: Para bloques que actúan como sinks (salidas) o fuentes (entradas).
IMediaBlockSettings: Para objetos de configuración que pueden crear bloques.

Pads y tipos de medios¶

Los bloques se conectan vía objetos MediaBlockPad, que tienen una dirección (In/Out) y un tipo de medio (Video, Audio, Subtitle, Metadata, Auto).
Los pads pueden conectarse/desconectarse, y su estado puede consultarse.

Tipos de bloques¶

El SDK proporciona una amplia gama de tipos de bloques incorporados (ver enum MediaBlockType en el código fuente) para fuentes, sinks, renderizadores, efectos y más.

Crear y gestionar un pipeline¶

1. Inicializar el SDK (si es requerido)¶

using VisioForge.Core;

// Inicializar el SDK al inicio de la aplicación
VisioForgeX.InitSDK();

2. Crear un pipeline y bloques¶

using VisioForge.Core.MediaBlocks;

// Crear una nueva instancia de pipeline
var pipeline = new MediaBlocksPipeline();

// Ejemplo: Crear una fuente de video virtual y un renderizador de video
var virtualSource = new VirtualVideoSourceBlock(new VirtualVideoSourceSettings());
var videoRenderer = new VideoRendererBlock(pipeline, VideoView1); // VideoView1 es su control de UI

// Agregar bloques al pipeline
pipeline.AddBlock(virtualSource);
pipeline.AddBlock(videoRenderer);

3. Conectar Bloques¶

// Conectar la salida de la fuente a la entrada del renderizador
pipeline.Connect(virtualSource.Output, videoRenderer.Input);

También puede usar pipeline.Connect(sourceBlock, targetBlock) para conectar pads predeterminados, o conectar múltiples pads para grafos complejos.
Para bloques que soportan entradas dinámicas, use la interfaz IMediaBlockDynamicInputs.

4. Iniciar y detener el pipeline¶

// Iniciar el pipeline asíncronamente
await pipeline.StartAsync();

// ... después, detener el procesamiento
await pipeline.StopAsync();

5. Limpieza de recursos¶

// Eliminar el pipeline cuando termines
pipeline.Dispose();

6. Limpieza del SDK (si es requerido)¶

// Liberar todos los recursos del SDK al cerrar la aplicación
VisioForgeX.DestroySDK();

Manejo de errores y eventos¶

Suscríbase a eventos del pipeline para manejo robusto de errores y estado:

pipeline.OnError += (sender, args) =>
{
    Console.WriteLine($"Error del pipeline: {args.Message}");
    // Implementar su lógica de manejo de errores aquí
};

pipeline.OnStart += (sender, args) =>
{
    Console.WriteLine("Pipeline iniciado");
};

pipeline.OnStop += (sender, args) =>
{
    Console.WriteLine("Pipeline detenido");
};

Características avanzadas¶

Adición/Eliminación Dinámica de Bloques: Puede agregar o eliminar bloques en tiempo de ejecución según sea necesario.
Gestión de Pads: Use métodos de MediaBlockPad para consultar y gestionar conexiones de pads.
Selección de Decodificador Hardware/Software: Use métodos auxiliares en MediaBlocksPipeline para aceleración de hardware.
Reproducción de Segmentos: Establezca propiedades StartPosition y StopPosition para reproducción parcial.
Depuración: Exporta grafos del pipeline para depuración usando los métodos proporcionados.

Ejemplo: configuración mínima de pipeline¶

using VisioForge.Core.MediaBlocks;

var pipeline = new MediaBlocksPipeline();
var source = new VirtualVideoSourceBlock(new VirtualVideoSourceSettings());
var renderer = new VideoRendererBlock(pipeline, videoViewControl);

pipeline.AddBlock(source);
pipeline.AddBlock(renderer);
pipeline.Connect(source.Output, renderer.Input);
await pipeline.StartAsync();
// ...
await pipeline.StopAsync();
pipeline.Dispose();

Referencia: interfaces clave¶

IMediaBlock: Interfaz base para todos los bloques.
IMediaBlockDynamicInputs: Para bloques con soporte de entrada dinámica.
IMediaBlockInternals, IMediaBlockInternals2: Para lógica interna del pipeline.
IMediaBlockRenderer: Para bloques renderizadores.
IMediaBlockSink, IMediaBlockSource: Para bloques sink/fuente.
IMediaBlockSettings: Para objetos de configuración de bloques.
IMediaBlocksPipeline: Interfaz principal del pipeline.
MediaBlockPad, MediaBlockPadDirection, MediaBlockPadMediaType: Para gestión de pads.

Lecturas adicionales y ejemplos¶

Para una lista completa de tipos de bloques y uso avanzado, consulte la referencia de API del SDK y el código fuente.