Saltar a contenido

Salida MXF en los SDK .NET de VisioForge

Video Capture SDK .NET Video Edit SDK .NET Media Blocks SDK .NET

VideoCaptureCoreX VideoEditCoreX MediaBlocksPipeline

Material Exchange Format (MXF) es un formato contenedor estándar de la industria diseñado para aplicaciones profesionales de video. Es ampliamente adoptado en entornos de broadcast, flujos de trabajo de post-producción y sistemas de archivo. Los SDK de VisioForge proporcionan capacidades robustas y multiplataforma de salida MXF que permiten a los desarrolladores integrar este formato profesional en sus aplicaciones.

Entender el formato MXF

MXF sirve como un envoltorio que puede contener varios tipos de datos de video y audio junto con metadatos. El formato fue diseñado para abordar problemas de interoperabilidad en flujos de trabajo profesionales de video:

  • Estándar de la industria: Adoptado por las principales emisoras del mundo
  • Metadatos profesionales: Admite amplios metadatos técnicos y descriptivos
  • Contenedor versátil: Compatible con numerosos códecs de audio y video
  • Multiplataforma: Compatible con Windows, macOS y Linux

Comenzar con la salida MXF

Dos rutas de código cubren el 99% de los casos:

  • MXFOutput (clase en VisioForge.Core.Types.X.Output) es un objeto de configuración consumido por VideoCaptureCoreX.Outputs_Add(...) o establecido como VideoEditCoreX.Output_Format.
  • MXFSinkBlock + MXFSinkSettings es la ruta de Media Blocks cuando maneja el pipeline a mano.

Implementación básica

Aquí está el código básico para crear una salida MXF:

var mxfOutput = new MXFOutput(
    filename: "output.mxf",
    videoStreamType: MXFVideoStreamType.H264,
    audioStreamType: MXFAudioStreamType.MPEG
);

Esto crea una salida MXF válida con configuraciones de codificación predeterminadas. Para aplicaciones profesionales, normalmente querrá personalizar los parámetros de codificación.

Opciones de codificación de video para MXF

La calidad y compatibilidad de su salida MXF depende en gran medida de su elección del codificador de video. MXFOutput admite codificadores H.264, por hardware o por software, para equilibrar rendimiento, calidad y compatibilidad. Para opciones detalladas de configuración, consulte la documentación del codificador H.264.

Las propiedades Bitrate de los codificadores de video del espacio X están en Kbps (así 8000 = 8 Mbps). No pases bits por segundo directos.

Codificadores acelerados por hardware

Para un rendimiento óptimo en aplicaciones en tiempo real, se recomiendan los codificadores acelerados por hardware:

Codificadores NVIDIA NVENC

// Verificar la disponibilidad primero
if (NVENCH264EncoderSettings.IsAvailable())
{
    var nvencSettings = new NVENCH264EncoderSettings
    {
        Bitrate = 8000, // 8 Mbps (Kbps)
    };

    mxfOutput.Video = nvencSettings;
}

Codificadores Intel Quick Sync Video (QSV)

if (QSVH264EncoderSettings.IsAvailable())
{
    var qsvSettings = new QSVH264EncoderSettings
    {
        Bitrate = 8000,
    };

    mxfOutput.Video = qsvSettings;
}

Codificadores AMD Advanced Media Framework (AMF)

if (AMFH264EncoderSettings.IsAvailable())
{
    var amfSettings = new AMFH264EncoderSettings
    {
        Bitrate = 8000,
    };

    mxfOutput.Video = amfSettings;
}

Codificadores por software

Cuando la aceleración por hardware no está disponible, los codificadores por software proporcionan alternativas confiables:

Codificador OpenH264

var openH264Settings = new OpenH264EncoderSettings
{
    Bitrate = 8000,
};

mxfOutput.Video = openH264Settings;

HEVC/H.265

El multiplexor MXF no tiene entrada HEVC, por lo que MXFOutput solo admite codificadores H.264. Use MP4 o MKV cuando necesite HEVC.

Codificación de audio para archivos MXF

Mientras que el video a menudo recibe la mayor atención, la codificación adecuada de audio es crucial para salidas MXF profesionales. El multiplexor MXF acepta audio MPEG-1/2, no AAC, por lo que MXFOutput codifica el audio con MP3EncoderSettings, su codificador predeterminado. Para opciones detalladas de configuración, consulte la documentación del codificador MP3.

El Bitrate de codificadores de audio del espacio X también está en Kbps (así 192 = 192 kbps). MP3EncoderSettings carece de setter de tasa de muestreo y sigue el formato de audio de la fuente upstream; la disposición de canales sigue el audio upstream salvo que se reconfigure antes (p. ej., con AudioResamplerBlock).

Codificador MP3

Para máxima compatibilidad:

var mp3Settings = new MP3EncoderSettings
{
    Bitrate = 320,         // Kbps — debe ser uno de 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320
    ForceMono = false      // Por defecto; establecer true para mezclar a mono
};

mxfOutput.Audio = mp3Settings;

Configuración avanzada de MXF

Pipelines de procesamiento personalizados

Una de las características poderosas de los SDK de VisioForge es la capacidad de agregar procesamiento personalizado a su cadena de salida MXF:

// Agregar procesamiento de video personalizado
mxfOutput.CustomVideoProcessor = yourVideoProcessingBlock;

// Agregar procesamiento de audio personalizado
mxfOutput.CustomAudioProcessor = yourAudioProcessingBlock;

Configuración del sink

Afine su salida MXF con configuraciones de sink:

// Acceder a las configuraciones del sink (MXFSinkSettings)
mxfOutput.Sink.Filename = "new_output.mxf";

Consideraciones multiplataforma

Construir aplicaciones que funcionen en diferentes plataformas requiere planificación cuidadosa:

// Selección de codificador específico de plataforma
var mxfOutput = new MXFOutput(
    filename: "output.mxf",
    videoStreamType: MXFVideoStreamType.H264,
    audioStreamType: MXFAudioStreamType.MPEG
);

#if NET_WINDOWS
    if (QSVH264EncoderSettings.IsAvailable())
    {
        mxfOutput.Video = new QSVH264EncoderSettings { Bitrate = 8000 };
    }
#else
    mxfOutput.Video = new OpenH264EncoderSettings { Bitrate = 8000 };
#endif

// MXF usa audio MP3 en todas las plataformas
mxfOutput.Audio = new MP3EncoderSettings { Bitrate = 320 };

Manejo de errores y validación

Las implementaciones robustas de MXF requieren manejo adecuado de errores:

try
{
    // Crear salida MXF
    var mxfOutput = new MXFOutput(
        filename: Path.Combine(outputDirectory, "output.mxf"),
        videoStreamType: MXFVideoStreamType.H264,
        audioStreamType: MXFAudioStreamType.MPEG
    );

    // Validar disponibilidad del codificador
    if (!OpenH264EncoderSettings.IsAvailable())
    {
        throw new ApplicationException("No se encontró un codificador H.264 compatible");
    }

    // Validar el directorio de salida
    var directoryInfo = new DirectoryInfo(Path.GetDirectoryName(mxfOutput.Sink.Filename));
    if (!directoryInfo.Exists)
    {
        Directory.CreateDirectory(directoryInfo.FullName);
    }

    // Adjuntar MXFOutput como salida de VideoCaptureCoreX
    videoCapture.Outputs_Add(mxfOutput, autostart: true);
    await videoCapture.StartAsync();
}
catch (Exception ex)
{
    logger.LogError($"Error de salida MXF: {ex.Message}");
    // Implementar estrategia de fallback
}

Optimización de rendimiento

Para un rendimiento óptimo de salida MXF:

  1. Priorice la aceleración por hardware: Siempre verifique y use codificadores de hardware primero
  2. Gestión de búfer: Ajuste tamaños de búfer basado en las capacidades del sistema
  3. Procesamiento paralelo: Utilice multi-threading donde sea apropiado
  4. Selección de preset: Elija presets de codificador basados en requisitos de calidad vs. velocidad

Ejemplo completo de implementación — VideoCaptureCoreX

Aquí tiene un ejemplo completo que demuestra la implementación MXF con opciones de fallback:

// Crear salida MXF con tipos de stream específicos
var mxfOutput = new MXFOutput(
    filename: "output.mxf",
    videoStreamType: MXFVideoStreamType.H264,
    audioStreamType: MXFAudioStreamType.MPEG
);

// Configurar codificador de video con cadena de fallback priorizada (bitrate en Kbps)
if (NVENCH264EncoderSettings.IsAvailable())
{
    mxfOutput.Video = new NVENCH264EncoderSettings { Bitrate = 8000 };
}
else if (QSVH264EncoderSettings.IsAvailable())
{
    mxfOutput.Video = new QSVH264EncoderSettings { Bitrate = 8000 };
}
else if (AMFH264EncoderSettings.IsAvailable())
{
    mxfOutput.Video = new AMFH264EncoderSettings { Bitrate = 8000 };
}
else
{
    mxfOutput.Video = new OpenH264EncoderSettings { Bitrate = 8000 };
}

// Configurar el audio (Kbps); el multiplexor MXF admite MP3, no AAC
mxfOutput.Audio = new MP3EncoderSettings { Bitrate = 192 };

// Adjuntar a VideoCaptureCoreX (o VideoEditCoreX: videoEdit.Output_Format = mxfOutput;)
videoCapture.Outputs_Add(mxfOutput, autostart: true);

await videoCapture.StartAsync();

Ejemplo completo de implementación — MediaBlocksPipeline

Cuando maneje el pipeline a mano, use MXFSinkBlock + MXFSinkSettings en lugar de MXFOutput:

var pipeline = new MediaBlocksPipeline();

var mxfSettings = new MXFSinkSettings("output.mxf",
    videoStreamType: MXFVideoStreamType.H264,
    audioStreamType: MXFAudioStreamType.MPEG);

var mxfSink = new MXFSinkBlock(mxfSettings);

// videoEncoder es una instancia existente de H264EncoderBlock; audioEncoder es new MP3EncoderBlock(new MP3EncoderSettings(), addParser: true), porque mxfmux requiere MP3 analizado
pipeline.Connect(videoEncoder.Output, mxfSink.CreateNewInput(MediaBlockPadMediaType.Video));
pipeline.Connect(audioEncoder.Output, mxfSink.CreateNewInput(MediaBlockPadMediaType.Audio));

await pipeline.StartAsync();

Siguiendo esta guía, puede implementar salida MXF de calidad profesional en sus aplicaciones usando los SDK .NET de VisioForge, garantizando compatibilidad con flujos de trabajo de broadcast y sistemas de post-producción.