Trabajando con Fuentes de Audio en .NET¶

Video Capture SDK .Net VideoCaptureCoreX VideoCaptureCore

Fuentes de Audio Disponibles¶

Al construir aplicaciones multimedia, necesitará capturar audio de varias fuentes. Esta guía cubre cómo implementar la captura de audio desde múltiples tipos de entrada utilizando nuestro SDK:

Dispositivos de captura de audio (micrófonos, entrada de línea)
Audio del sistema (altavoces/auriculares a través de bucle invertido)
Flujos de red (cámaras IP)
Dispositivos profesionales Decklink

Cada tipo de fuente requiere diferentes métodos de inicialización y tiene capacidades únicas. Exploremos cómo trabajar con cada uno.

Implementación de Dispositivos de Captura de Audio¶

Los dispositivos de captura de audio incluyen micrófonos, cámaras web con micrófonos incorporados y otro hardware de entrada conectado a su sistema. Trabajar con estos dispositivos implica tres pasos clave:

Enumerar los dispositivos disponibles
Seleccionar los formatos de audio apropiados
Configurar el dispositivo seleccionado como su fuente de audio

Enumeración de Dispositivos de Audio Disponibles¶

Primero, necesita detectar todos los dispositivos de entrada de audio conectados al sistema:

VideoCaptureCoreXVideoCaptureCore

var audioSources = await core.Audio_SourcesAsync();
foreach (var source in audioSources)
{
    // add to some combobox
    cbAudioInputDevice.Items.Add(source.DisplayName);
}

foreach (var device in core.Audio_CaptureDevices())
{
    // add to some combobox
    cbAudioInputDevice.Items.Add(device.Name);
}

Este código recupera todos los dispositivos de entrada de audio y puede mostrarlos en un menú desplegable para la selección del usuario. El enfoque asíncrono en VideoCaptureCoreX proporciona un mejor rendimiento para sistemas con muchos dispositivos conectados.

Descubriendo Formatos de Audio Soportados¶

Una vez que haya identificado los dispositivos disponibles, necesitará determinar qué formatos de audio soporta cada dispositivo:

VideoCaptureCoreXVideoCaptureCore

// find the device by name
var deviceItem = (await VideoCapture1.Audio_SourcesAsync()).FirstOrDefault(device => device.DisplayName == "Some device name");
if (deviceItem == null)
{
    return;
}

// enumerate formats
foreach (var format in deviceItem.Formats)
{
    cbAudioInputFormat.Items.Add(format.Name);
}

// find the device by name
var deviceItem = VideoCapture1.Audio_CaptureDevices().FirstOrDefault(device => device.Name == "Some device name");

// enumerate formats
foreach (var format in deviceItem.Formats)
{
    cbAudioInputFormat.Items.Add(format);
}

Diferentes dispositivos de audio soportan varios formatos con diferentes profundidades de bits, tasas de muestreo y configuraciones de canales. Enumerar estas opciones le permite seleccionar el formato más apropiado para las necesidades de su aplicación.

Configuración del Dispositivo de Captura de Audio¶

Después de seleccionar un dispositivo y formato, configúrelo como su fuente de audio:

VideoCaptureCoreXVideoCaptureCore

// find the device by name
var deviceItem = (await VideoCapture1.Audio_CaptureDevices()).FirstOrDefault(device => device.DisplayName == "Device name");
if (deviceItem == null)
{
    return;
}

// set the first format
AudioCaptureDeviceFormat format = formats[0].ToFormat();    

// create audio source settings
IVideoCaptureBaseAudioSourceSettings audioSource = deviceItem.CreateSourceSettingsVC(format);    

// set audio source
VideoCapture1.Audio_Source = audioSource;

// find the device by name
var deviceItem = VideoCapture1.Audio_CaptureDevices().FirstOrDefault(device => device.Name == "Some device name");
VideoCapture1.Audio_CaptureDevice = new AudioCaptureSource(deviceItem.Name);
VideoCapture1.Audio_CaptureDevice.Format = deviceItem.Formats[0].ToString(); // set the first format

Este código configura su aplicación para capturar audio del dispositivo seleccionado utilizando el formato especificado. La API de VideoCaptureCoreX proporciona un control más granular sobre la selección de formato y la configuración del dispositivo.

Captura de Audio del Sistema a través de Bucle Invertido (Loopback)¶

El bucle invertido de audio le permite grabar cualquier sonido que se reproduzca a través de los altavoces o auriculares de su sistema. Esto es particularmente útil para:

Grabación de pantalla con audio
Captura de sonidos de aplicaciones
Grabación de audio de conferencias web o servicios de transmisión

Aquí se explica cómo implementarlo:

VideoCaptureCoreXVideoCaptureCore

Primero, enumere los dispositivos de bucle invertido disponibles:

// Enumerate audio loopback devices
var audioSinks = await DeviceEnumerator.Shared.AudioOutputsAsync();
foreach (var sink in audioSinks)
{   
    // Filter by WASAPI2 API
    if (sink.API == AudioOutputDeviceAPI.WASAPI2)
    {
        // Add to some combobox
        cbAudioLoopbackDevice.Items.Add(sink.Name);
    }
}

A continuación, cree la configuración de fuente para su dispositivo de salida seleccionado:

// audio input
var deviceItem = (await DeviceEnumerator.Shared.AudioOutputsAsync(AudioOutputDeviceAPI.WASAPI2)).FirstOrDefault(device => device.Name == "Output device name");
if (deviceItem == null)
{
    return;
}

IVideoCaptureBaseAudioSourceSettings audioSource = new LoopbackAudioCaptureDeviceSourceSettings(deviceItem);

VideoCapture1.Audio_Source = audioSource;

La API WASAPI2 proporciona la funcionalidad de bucle invertido más confiable en sistemas Windows, con menor latencia y mejor rendimiento en comparación con otras opciones.

En VideoCaptureCore, la funcionalidad de bucle invertido se simplifica con un dispositivo virtual dedicado:

VideoCapture1.Audio_CaptureDevice = new AudioCaptureSource("VisioForge What You Hear Source");
VideoCapture1.Audio_CaptureDevice.Format_UseBest = true;

Este enfoque selecciona automáticamente el mejor formato disponible para la fuente de bucle invertido, haciendo que la implementación sea sencilla.

Trabajando con Fuentes de Audio de Red¶

Para cámaras IP y otros flujos de red, la captura de audio generalmente se maneja como parte de la conexión general del flujo. La implementación exacta depende del protocolo de red que se utilice (RTSP, HLS, etc.) y las capacidades específicas del dispositivo.

Al conectarse a fuentes de red, generalmente:

Establecerá una conexión a la dirección IP y puerto
Se autenticará si es necesario
Configurará los parámetros de audio según lo soporte el dispositivo

El audio de fuentes de red puede venir en varios formatos, incluyendo AAC, MP3 o datos PCM sin procesar, dependiendo del dispositivo. Nuestro SDK maneja la conversión de formato necesaria y la sincronización con flujos de video automáticamente.

Implementación de Captura de Audio Decklink¶

Los dispositivos Decklink proporcionan capacidades de captura de audio de grado profesional con características como:

Altas tasas de muestreo (hasta 192kHz)
Múltiples configuraciones de canales
Captura sincronizada de audio/video
Audio embebido en señales SDI

Al trabajar con hardware Decklink, la configuración de audio generalmente se configura como parte de la configuración general del dispositivo. El SDK proporciona clases y métodos especializados para trabajar con estos dispositivos profesionales.

Mejores Prácticas para la Captura de Audio¶

Para garantizar una captura de audio de alta calidad en sus aplicaciones:

Selección de tasa de muestreo: Elija tasas de muestreo apropiadas basadas en su salida objetivo. Para la mayoría de las aplicaciones, 44.1kHz o 48kHz es suficiente.
Gestión de búfer: Configure tamaños de búfer apropiados para equilibrar entre latencia y estabilidad. Los búferes más pequeños reducen la latencia pero pueden causar interrupciones de audio.
Manejo de formatos: Soporte múltiples formatos para acomodar varios dispositivos. Siempre tenga opciones de respaldo cuando formatos específicos no estén disponibles.
Monitoreo de nivel: Implemente monitoreo de nivel de audio para detectar silencio o saturación, permitiendo que su aplicación responda apropiadamente.
Manejo de errores: Implemente un manejo de errores robusto para desconexiones de dispositivos o fallas en la negociación de formatos.

Conclusión¶

La implementación de capacidades de captura de audio en su aplicación .NET implica seleccionar la fuente adecuada, configurar formatos y gestionar el flujo de audio. Ya sea que esté capturando desde micrófonos, audio del sistema o fuentes de red, nuestro SDK proporciona las herramientas necesarias para construir aplicaciones de audio sofisticadas.

Siguiendo los ejemplos de código y los patrones de implementación descritos en esta guía, podrá integrar una potente funcionalidad de captura de audio en sus proyectos de manera eficiente.

Visite nuestra página de GitHub para obtener más ejemplos de código.