title: Procesamiento de Audio en C# .NET - Mezclador, EQ, Efectos description: Pipelines de audio en C# con VisioForge Media Blocks SDK: mezclador, ecualizador, reverberación, reducción de ruido y más de 30 bloques. sidebar_label: Procesamiento y Efectos de Audio

Bloques de Procesamiento y Efectos de Audio para .NET¶

Media Blocks SDK .Net

VisioForge Media Blocks SDK proporciona un enfoque basado en pipelines para el procesamiento de audio en C# y .NET. Conecte bloques de audio — conversores, remuestreadores, mezcladores, ecualizadores, efectos y analizadores — para construir cadenas de procesamiento de audio en tiempo real para sus aplicaciones. Cada bloque tiene pines de entrada/salida tipados que se conectan entre sí usando pipeline.Connect().

Para obtener información detallada sobre los parámetros y propiedades de los efectos de audio, consulte la Referencia de Efectos de Audio.

Todos los bloques son multiplataforma y funcionan en Windows, macOS, Linux, iOS y Android.

Procesamiento Básico de Audio¶

Audio Converter¶

El bloque Audio Converter convierte audio de un formato a otro.

Información del bloque¶

Nombre: AudioConverterBlock.

Configuración¶

Sin parámetros configurables. Negocia y convierte automáticamente los formatos de audio entre los elementos conectados.

Elemento GStreamer: audioconvert

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->AudioConverterBlock;
    AudioConverterBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var audioConverter = new AudioConverterBlock();
pipeline.Connect(fileSource.AudioOutput, audioConverter.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(audioConverter.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Audio Resampler¶

El bloque Audio Resampler cambia la tasa de muestreo de un flujo de audio.

Información del bloque¶

Nombre: AudioResamplerBlock.

Configuración¶

Configure mediante AudioResamplerSettings:

Elemento GStreamer: audioresample

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->AudioResamplerBlock;
    AudioResamplerBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Resample to 48000 Hz, stereo
var settings = new AudioResamplerSettings(AudioFormatX.S16LE, 48000, 2);
var audioResampler = new AudioResamplerBlock(settings);
pipeline.Connect(fileSource.AudioOutput, audioResampler.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(audioResampler.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Audio Timestamp Corrector¶

El bloque Audio Timestamp Corrector puede agregar o eliminar cuadros para corregir el flujo de entrada de fuentes inestables.

Información del bloque¶

Nombre: AudioTimestampCorrectorBlock.

Configuración¶

Configure mediante AudioTimestampCorrectorSettings:

Elemento GStreamer: audiorate

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->AudioTimestampCorrectorBlock;
    AudioTimestampCorrectorBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new AudioTimestampCorrectorSettings();
var corrector = new AudioTimestampCorrectorBlock(settings);
pipeline.Connect(fileSource.AudioOutput, corrector.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(corrector.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Volume¶

El bloque Volume le permite controlar el volumen del flujo de audio.

Información del bloque¶

Nombre: VolumeBlock.

Configuración¶

Elemento GStreamer: volume

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->VolumeBlock;
    VolumeBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Volume: 0.0 (silence) to 1.0 (normal) or higher (amplification)
var volume = new VolumeBlock(0.8);
pipeline.Connect(fileSource.AudioOutput, volume.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(volume.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Mezclador de audio¶

El bloque mezclador de audio mezcla múltiples flujos de audio en uno solo. El bloque mezcla los flujos independientemente de su formato, convirtiendo si es necesario.

Todos los flujos de entrada serán sincronizados. El bloque mezclador maneja la conversión de diferentes formatos de audio de entrada a un formato común para la mezcla. Por defecto, intentará coincidir con el formato de la primera entrada conectada, pero esto puede configurarse explícitamente.

Use la clase AudioMixerSettings para establecer el formato de salida personalizado. Esto es útil si necesita una tasa de muestreo, disposición de canales o formato de audio específico (como S16LE, Float32LE, etc.) para la salida mezclada.

Información del bloque¶

Nombre: AudioMixerBlock.

Configuración¶

Configure mediante AudioMixerSettings:

Métodos en tiempo de ejecución:

Elemento GStreamer: audiomixer

Pipeline de ejemplo¶

graph LR;
    VirtualAudioSourceBlock#1-->AudioMixerBlock;
    VirtualAudioSourceBlock#2-->AudioMixerBlock;
    AudioMixerBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var audioSource1Block = new VirtualAudioSourceBlock(new VirtualAudioSourceSettings());
var audioSource2Block = new VirtualAudioSourceBlock(new VirtualAudioSourceSettings());

// Configure the mixer with specific output settings if needed
// For example, to output 48kHz, 2-channel, S16LE audio:
// var mixerSettings = new AudioMixerSettings() { Format = new AudioInfoX(AudioFormatX.S16LE, 48000, 2) };
// var audioMixerBlock = new AudioMixerBlock(mixerSettings);
var audioMixerBlock = new AudioMixerBlock(new AudioMixerSettings());

// Each call to CreateNewInput() adds a new input to the mixer
var inputPad1 = audioMixerBlock.CreateNewInput();
pipeline.Connect(audioSource1Block.Output, inputPad1);

var inputPad2 = audioMixerBlock.CreateNewInput();
pipeline.Connect(audioSource2Block.Output, inputPad2);

// Output the mixed audio to the default audio renderer
var audioRenderer = new AudioRendererBlock();
pipeline.Connect(audioMixerBlock.Output, audioRenderer.Input);

await pipeline.StartAsync();

Control de flujos de entrada individuales¶

Puede controlar el volumen y el estado de silencio de los flujos de entrada individuales conectados al AudioMixerBlock. El streamIndex para estos métodos corresponde al orden en que se agregaron las entradas mediante CreateNewInput() o CreateNewInputLive() (comenzando desde 0).

• Establecer volumen: Use el método SetVolume(int streamIndex, double value). El value varía de 0.0 (silencio) a 1.0 (volumen normal), y puede ser mayor para amplificación (por ejemplo, hasta 10.0, aunque los detalles pueden depender de los límites de la implementación subyacente).
• Establecer silencio: Use el método SetMute(int streamIndex, bool value). Establezca value en true para silenciar el flujo y false para activarlo.

// Assuming audioMixerBlock is already created and inputs are connected

// Set volume of the first input stream (index 0) to 50%
audioMixerBlock.SetVolume(0, 0.5);

// Mute the second input stream (index 1)
audioMixerBlock.SetMute(1, true);

Gestión dinámica de entradas (pipeline en vivo)¶

El AudioMixerBlock soporta agregar y eliminar entradas dinámicamente mientras el pipeline está en ejecución:

• Agregar entradas: Use el método CreateNewInputLive() para obtener un nuevo pad de entrada que puede conectarse a una fuente. Los elementos GStreamer subyacentes se configurarán para manejar la nueva entrada.
• Eliminar entradas: Use el método RemoveInputLive(MediaBlockPad blockPad). Esto desconectará el pad de entrada especificado y limpiará los recursos asociados.

Esto es particularmente útil para aplicaciones donde el número de fuentes de audio puede cambiar durante la operación, como una consola de mezcla en vivo o una aplicación de conferencias.

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Capturador de muestras de audio¶

El bloque capturador de muestras de audio le permite acceder a las muestras de audio sin procesar del flujo de audio.

Información del bloque¶

Nombre: AudioSampleGrabberBlock.

Configuración¶

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->AudioSampleGrabberBlock;
    AudioSampleGrabberBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var audioSampleGrabber = new AudioSampleGrabberBlock();
audioSampleGrabber.SampleGrabbed += (sender, args) =>
{
    // Process audio samples
    // args.AudioData - audio samples
    // args.AudioFormat - audio format
};
pipeline.Connect(fileSource.AudioOutput, audioSampleGrabber.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(audioSampleGrabber.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Efectos de Audio¶

Amplify¶

El bloque amplifica un flujo de audio por un factor de amplificación. Hay varios modos de recorte disponibles.

Use los valores de método y nivel para configurar.

Información del bloque¶

Nombre: AmplifyBlock.

Configuración¶

Valores de AmplifyClippingMethod:

Elemento GStreamer: audioamplify

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->AmplifyBlock;
    AmplifyBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var amplify = new AmplifyBlock(AmplifyClippingMethod.Normal, 2.0);
pipeline.Connect(fileSource.AudioOutput, amplify.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(amplify.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Echo¶

El bloque Echo agrega efecto de eco al flujo de audio.

Información del bloque¶

Nombre: EchoBlock.

Configuración¶

Elemento GStreamer: audioecho

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->EchoBlock;
    EchoBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Delay in ms, strength 0.0 - 1.0
var echo = new EchoBlock(500, 0.5);
pipeline.Connect(fileSource.AudioOutput, echo.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(echo.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Karaoke¶

El bloque Karaoke aplica un efecto de karaoke al flujo de audio, eliminando las voces con panorámica central.

Información del bloque¶

Nombre: KaraokeBlock.

Configuración¶

Configure mediante KaraokeAudioEffect:

Elemento GStreamer: audiokaraoke

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->KaraokeBlock;
    KaraokeBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new KaraokeAudioEffect();
var karaoke = new KaraokeBlock(settings);
pipeline.Connect(fileSource.AudioOutput, karaoke.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(karaoke.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Reverberación¶

El bloque de reverberación agrega efectos de reverberación al flujo de audio.

Información del bloque¶

Nombre: ReverberationBlock.

Configuración¶

Configure mediante ReverberationAudioEffect:

Elemento GStreamer: freeverb

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->ReverberationBlock;
    ReverberationBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new ReverberationAudioEffect();
var reverb = new ReverberationBlock(settings);
pipeline.Connect(fileSource.AudioOutput, reverb.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(reverb.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Wide Stereo¶

El bloque Wide Stereo mejora la imagen estéreo del audio.

Información del bloque¶

Nombre: WideStereoBlock.

Configuración¶

Configure mediante WideStereoAudioEffect:

Elemento GStreamer: stereo

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->WideStereoBlock;
    WideStereoBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new WideStereoAudioEffect();
var wideStereo = new WideStereoBlock(settings);
pipeline.Connect(fileSource.AudioOutput, wideStereo.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(wideStereo.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Ecualización y Filtrado¶

Balance¶

El bloque le permite controlar el balance entre los canales izquierdo y derecho.

Información del bloque¶

Nombre: AudioBalanceBlock.

Configuración¶

Elemento GStreamer: audiopanorama

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->AudioBalanceBlock;
    AudioBalanceBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Balance: -1.0 (full left) to 1.0 (full right), 0.0 - center
var balance = new AudioBalanceBlock(0.5);
pipeline.Connect(fileSource.AudioOutput, balance.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(balance.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Ecualizador (10 bandas)¶

El bloque de ecualizador de 10 bandas proporciona un ecualizador de 10 bandas para el procesamiento de audio.

Información del bloque¶

Nombre: Equalizer10Block.

Configuración¶

El ecualizador proporciona 10 bandas de frecuencia fija. Use SetBand(int index, double gain) para ajustar bandas individuales. Rango de ganancia: -24 dB a +12 dB.

El constructor acepta 10 valores double para las ganancias iniciales de las bandas (en dB), o use SetBand(int index, double gain) en tiempo de ejecución.

Elemento GStreamer: equalizer-10bands

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->Equalizer10Block;
    Equalizer10Block-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Create 10-band equalizer with all bands set to 0 dB
var equalizer = new Equalizer10Block(0, 0, 0, 0, 0, 0, 0, 0, 0, 0);

// Or set bands individually
equalizer.SetBand(0, 3); // Band 0 (31 Hz) to +3 dB
equalizer.SetBand(1, 2); // Band 1 (62 Hz) to +2 dB
equalizer.SetBand(9, -3); // Band 9 (16 kHz) to -3 dB

pipeline.Connect(fileSource.AudioOutput, equalizer.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(equalizer.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Ecualizador (Paramétrico)¶

El bloque de ecualizador paramétrico proporciona un ecualizador paramétrico para el procesamiento de audio.

Información del bloque¶

Nombre: EqualizerParametricBlock.

Configuración¶

Use SetNumBands(int count) para establecer el número de bandas (1–64, predeterminado 3), luego configure cada banda con SetState(int index, ParametricEqualizerBand band).

Propiedades de ParametricEqualizerBand:

Bandas predeterminadas (cuando se configuran 3 bandas):

Elemento GStreamer: equalizer-nbands

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->EqualizerParametricBlock;
    EqualizerParametricBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Create parametric equalizer
var equalizer = new EqualizerParametricBlock();

// Set up to 4 bands
equalizer.SetBand(0, 100, 1.0, 3); // Band 0: 100 Hz frequency, 1.0 Q, +3 dB gain
equalizer.SetBand(1, 1000, 1.5, -2); // Band 1: 1000 Hz frequency, 1.5 Q, -2 dB gain

pipeline.Connect(fileSource.AudioOutput, equalizer.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(equalizer.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Chebyshev Band Pass/Reject¶

El bloque Chebyshev Band Pass/Reject aplica un filtro pasa banda o rechaza banda al flujo de audio usando filtros de Chebyshev.

Información del bloque¶

Nombre: ChebyshevBandPassRejectBlock.

Configuración¶

Configure mediante ChebyshevBandPassRejectAudioEffect:

Elemento GStreamer: audiochebband

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->ChebyshevBandPassRejectBlock;
    ChebyshevBandPassRejectBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new ChebyshevBandPassRejectAudioEffect();
var filter = new ChebyshevBandPassRejectBlock(settings);
pipeline.Connect(fileSource.AudioOutput, filter.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(filter.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Chebyshev Limit¶

El bloque Chebyshev Limit aplica filtrado de paso bajo o paso alto al audio usando filtros de Chebyshev.

Información del bloque¶

Nombre: ChebyshevLimitBlock.

Configuración¶

Configure mediante ChebyshevLimitAudioEffect:

Elemento GStreamer: audiocheblimit

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->ChebyshevLimitBlock;
    ChebyshevLimitBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new ChebyshevLimitAudioEffect();
var filter = new ChebyshevLimitBlock(settings);
pipeline.Connect(fileSource.AudioOutput, filter.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(filter.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Procesamiento Dinámico¶

Compresor/Expansor¶

El bloque compresor/expansor proporciona compresión o expansión del rango dinámico.

Información del bloque¶

Nombre: CompressorExpanderBlock.

Configuración¶

Configure mediante CompressorExpanderAudioEffect:

El constructor acepta 4 parámetros: CompressorExpanderBlock(ratio, threshold, mode, characteristics).

Elemento GStreamer: audiodynamic

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->CompressorExpanderBlock;
    CompressorExpanderBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var compressor = new CompressorExpanderBlock(0.5, 0.9, 0.1, 0.5);
pipeline.Connect(fileSource.AudioOutput, compressor.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(compressor.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Scale/Tempo¶

El bloque Scale/Tempo le permite cambiar el tempo y el tono del flujo de audio.

Información del bloque¶

Nombre: ScaleTempoBlock.

Configuración¶

El constructor acepta un parámetro double rate para la velocidad de reproducción inicial. Use SetRate(double rate) para cambiar en tiempo de ejecución.

Elemento GStreamer: scaletempo

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->ScaleTempoBlock;
    ScaleTempoBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Scale tempo by factor (1.0 is normal, 0.5 is half-speed, 2.0 is double-speed)
var scaleTempo = new ScaleTempoBlock(1.5);
pipeline.Connect(fileSource.AudioOutput, scaleTempo.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(scaleTempo.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Análisis y Medición¶

VU Meter¶

El bloque VU Meter le permite medir el nivel de volumen del flujo de audio.

Información del bloque¶

Nombre: VUMeterBlock.

Configuración¶

Bloque basado en eventos. Suscríbase al evento VolumeUpdated para recibir datos de nivel.

Propiedades del evento VUMeterXData:

Elemento GStreamer: level

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->VUMeterBlock;
    VUMeterBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var vuMeter = new VUMeterBlock();
vuMeter.VolumeUpdated += (sender, args) =>
{
    // Left channel volume in dB
    var leftVolume = args.LeftVolume;

    // Right channel volume in dB
    var rightVolume = args.RightVolume;

    Console.WriteLine($"Left: {leftVolume:F2} dB, Right: {rightVolume:F2} dB");
};
pipeline.Connect(fileSource.AudioOutput, vuMeter.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(vuMeter.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Efectos de Audio¶

Audio Effects¶

El bloque AudioEffects proporciona una colección completa de efectos de procesamiento de audio que pueden aplicarse a flujos de audio. Para obtener información detallada sobre los parámetros y propiedades de los efectos, consulte la Referencia de Efectos de Audio.

Información del bloque¶

Nombre: AudioEffectsBlock.

Configuración¶

Gestión de efectos basada en colección. Use los siguientes métodos:

Los tipos de efectos soportados incluyen todos los efectos del espacio de nombres VisioForge.Core.Types.X.AudioEffects. Consulte la Referencia de Efectos de Audio para parámetros detallados.

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->AudioEffectsBlock;
    AudioEffectsBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var audioEffects = new AudioEffectsBlock();
pipeline.Connect(fileSource.AudioOutput, audioEffects.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(audioEffects.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Normalización de Sonoridad de Audio¶

El bloque AudioLoudNorm normaliza la sonoridad del audio según los estándares EBU R128, asegurando una sonoridad percibida consistente entre diferentes contenidos de audio.

Información del bloque¶

Nombre: AudioLoudNormBlock.

Configuración¶

Configure mediante AudioLoudNormAudioEffect:

Elemento GStreamer: audioloudnorm

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->AudioLoudNormBlock;
    AudioLoudNormBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var loudNorm = new AudioLoudNormBlock();
pipeline.Connect(fileSource.AudioOutput, loudNorm.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(loudNorm.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Reducción de Ruido RNN¶

El bloque AudioRNNoise utiliza reducción de ruido basada en redes neuronales recurrentes (RNN) para eliminar el ruido de fondo de los flujos de audio mientras preserva la calidad del habla.

Información del bloque¶

Nombre: AudioRNNoiseBlock.

Configuración¶

Elemento GStreamer: audiornnoise

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->AudioRNNoiseBlock;
    AudioRNNoiseBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "noisy_audio.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var rnnoise = new AudioRNNoiseBlock();
pipeline.Connect(fileSource.AudioOutput, rnnoise.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(rnnoise.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Eliminar Silencio¶

El bloque RemoveSilence detecta y elimina automáticamente las porciones silenciosas de los flujos de audio, útil para podcasts, grabaciones de voz y edición de audio.

Información del bloque¶

Nombre: RemoveSilenceBlock.

Configuración¶

Configure mediante RemoveSilenceAudioEffect:

Elemento GStreamer: removesilence

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->RemoveSilenceBlock;
    RemoveSilenceBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "podcast.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var removeSilence = new RemoveSilenceBlock();
pipeline.Connect(fileSource.AudioOutput, removeSilence.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(removeSilence.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Filtro Csound¶

El bloque CsoundFilter proporciona síntesis y procesamiento de audio avanzado utilizando el lenguaje de programación de audio Csound.

Información del bloque¶

Nombre: CsoundFilterBlock.

Configuración¶

Configure mediante CsoundAudioEffect:

Elemento GStreamer: csoundfilter

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->CsoundFilterBlock;
    CsoundFilterBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var csoundSettings = new CsoundFilterSettings
{
    CsdPath = "filter.csd" // Csound script file
};
var csound = new CsoundFilterBlock(csoundSettings);
pipeline.Connect(fileSource.AudioOutput, csound.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(csound.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux (requiere Csound).

Nivel EBU R128¶

El bloque EbuR128Level mide la sonoridad del audio según el estándar EBU R128, proporcionando mediciones precisas de sonoridad para cumplimiento de transmisión.

Información del bloque¶

Nombre: EbuR128LevelBlock.

Configuración¶

Suscríbase al evento LoudnessUpdated para recibir datos de medición.

Elemento GStreamer: ebur128level

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->EbuR128LevelBlock;
    EbuR128LevelBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var ebuR128 = new EbuR128LevelBlock();
ebuR128.LoudnessUpdated += (sender, args) =>
{
    Console.WriteLine($"Momentary: {args.MomentaryLoudness:F2} LUFS");
    Console.WriteLine($"Short-term: {args.ShortTermLoudness:F2} LUFS");
};
pipeline.Connect(fileSource.AudioOutput, ebuR128.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(ebuR128.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

HRTF Render¶

El bloque HRTFRender aplica procesamiento de Función de Transferencia Relacionada con la Cabeza (HRTF) para crear efectos de audio espacial 3D a partir de audio estéreo o multicanal.

Información del bloque¶

Nombre: HRTFRenderBlock.

Configuración¶

Todas las propiedades soportan actualizaciones en tiempo real durante la reproducción.

Elemento GStreamer: hrtfrender

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->HRTFRenderBlock;
    HRTFRenderBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var hrtfSettings = new HRTFRenderSettings
{
    Azimuth = 45.0,  // Direction in degrees
    Elevation = 0.0
};
var hrtf = new HRTFRenderBlock(hrtfSettings);
pipeline.Connect(fileSource.AudioOutput, hrtf.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(hrtf.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

RS Audio Echo¶

El bloque RSAudioEcho proporciona efectos de eco de alta calidad utilizando el plugin GStreamer rsaudiofx.

Información del bloque¶

Nombre: RSAudioEchoBlock.

Configuración¶

Todas las propiedades soportan actualizaciones en tiempo real durante la reproducción.

Elemento GStreamer: rsaudioecho

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->RSAudioEchoBlock;
    RSAudioEchoBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var echoSettings = new RSAudioEchoSettings
{
    Delay = 500,      // Delay in milliseconds
    Intensity = 0.5,  // Echo intensity (0-1)
    Feedback = 0.3    // Feedback amount (0-1)
};
var rsEcho = new RSAudioEchoBlock(echoSettings);
pipeline.Connect(fileSource.AudioOutput, rsEcho.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(rsEcho.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux (requiere el plugin rsaudiofx).

Pitch Shifter¶

El PitchBlock cambia el tono de un flujo de audio sin afectar la velocidad de reproducción. Utiliza la biblioteca SoundTouch a través del elemento GStreamer pitch, soportando cambios de -12 a +12 semitonos (una octava abajo a una octava arriba).

Información del bloque¶

Nombre: PitchBlock.

Configuración¶

Disponibilidad¶

PitchBlock.IsAvailable() retorna true si el elemento GStreamer pitch (plugin SoundTouch) está presente.

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->PitchBlock;
    PitchBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var pitchBlock = new PitchBlock(semitones: 5);
pipeline.Connect(fileSource.AudioOutput, pitchBlock.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(pitchBlock.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux.

Detector de Silencio¶

El SilenceDetectorBlock analiza los niveles de audio en tiempo real para detectar períodos de silencio basándose en un umbral configurable en dBFS. Es un bloque de paso -- el audio se reenvía sin cambios mientras los eventos OnSilenceStarted y OnSilenceEnded se disparan en las transiciones de estado. Los períodos detectados pueden recuperarse como lista o exportarse como JSON.

Información del bloque¶

Nombre: SilenceDetectorBlock.

Configuración¶

Métodos clave:

• GetSilencePeriods() -- retorna todos los objetos SilencePeriod detectados.
• FinalizeSilencePeriods(TimeSpan endTime) -- cierra cualquier período en curso y retorna la lista completa.
• ExportSilencePeriodsJson() -- retorna una cadena JSON con las marcas de tiempo de inicio/fin de cada período detectado.

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->SilenceDetectorBlock;
    SilenceDetectorBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var silenceDetector = new SilenceDetectorBlock(thresholdDb: -35.0);
silenceDetector.OnSilenceStarted += (s, e) => Console.WriteLine($"Silence started at {e.Timestamp}");
silenceDetector.OnSilenceEnded += (s, e) => Console.WriteLine($"Silence ended at {e.Timestamp}");
pipeline.Connect(fileSource.AudioOutput, silenceDetector.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(silenceDetector.Output, audioRenderer.Input);

await pipeline.StartAsync();

// After pipeline stops, export detected silence periods
var json = silenceDetector.ExportSilencePeriodsJson();
Console.WriteLine(json);

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Mezcla de Canales Ponderada¶

El WeightedChannelMixBlock mezcla los canales estéreo izquierdo y derecho con pesos ajustables de forma independiente, produciendo una salida mono o estéreo. Se utiliza principalmente para fuentes de doble mono, como audio de karaoke donde un canal lleva una pista instrumental y el otro una mezcla completa.

Los pesos pueden cambiarse en tiempo de ejecución sin reconstruir el pipeline. Valores superiores a 1.0 amplifican el canal pero pueden causar recorte.

Información del bloque¶

Nombre: WeightedChannelMixBlock.

Configuración¶

Pipeline de ejemplo¶

graph LR;
    UniversalSourceBlock-->WeightedChannelMixBlock;
    WeightedChannelMixBlock-->AudioRendererBlock;

Código de ejemplo¶

var pipeline = new MediaBlocksPipeline();

var filename = "karaoke.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Use only the instrumental (left) channel
var mixer = new WeightedChannelMixBlock(leftWeight: 1.0f, rightWeight: 0.0f);
pipeline.Connect(fileSource.AudioOutput, mixer.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(mixer.Output, audioRenderer.Input);

await pipeline.StartAsync();

Plataformas¶

Windows, macOS, Linux, iOS, Android.

Preguntas Frecuentes¶

Ver También¶

• Descripción General de Efectos de Audio
• Referencia de Efectos de Audio
• Codificadores de Audio
• Descripción General del SDK Media Blocks