Capture audio et enregistrement du son système en C# .NET¶

Introduction¶

Le VisioForge Video Capture SDK offre des fonctionnalités de capture audio aux développeurs .NET, couvrant l'enregistrement du microphone, la capture de l'audio système (loopback/haut-parleur) et l'enregistrement audio combiné. Que vous construisiez un enregistreur de podcast, un outil d'enregistrement d'écran avec audio ou une application de capture vocale, le SDK gère l'énumération des périphériques, la négociation des formats et l'encodage.

Ce guide fournit des exemples de code complets et exécutables pour les scénarios de capture audio les plus courants en utilisant les API Video Capture SDK X et Media Blocks SDK.

Sources audio prises en charge¶

Microphones physiques — microphones de bureau, USB et Bluetooth
Ports d'entrée ligne — mélangeurs externes ou instruments
Audio système (loopback) — enregistrer ce qui est lu par vos haut-parleurs ou écouteurs
Périphériques audio virtuels — capturer l'audio d'autres applications
Flux réseau — audio depuis RTSP, HTTP et autres sources de streaming

Pour la configuration détaillée des sources, consultez Sources audio.

Prise en charge des formats audio¶

Formats avec perte¶

MP3 — standard de l'industrie, débits ajustables de 8 kbps à 320 kbps
M4A (AAC) — excellent rapport qualité/taille
Windows Media Audio — bonne compression avec intégration Windows
Ogg Vorbis — open source, excellente qualité à des débits plus faibles
Speex — optimisé pour la parole

Formats sans perte¶

WAV — non compressé, qualité parfaite
FLAC — compression sans perte sans dégradation de qualité

Enregistrer l'audio du microphone en MP3¶

Cette application console enregistre l'audio depuis le microphone par défaut et le sauvegarde sous forme de fichier MP3.

Paquets NuGet requis¶

dotnet add package VisioForge.DotNet.Core.TRIAL
dotnet add package VisioForge.DotNet.VideoCapture.TRIAL

Ajoutez le paquet redist pour votre plateforme (par ex. VisioForge.DotNet.Redist.Base.Windows.x64).

Exemple complet¶

using System;
using System.IO;
using System.Threading.Tasks;
using VisioForge.Core;
using VisioForge.Core.Types.X.Output;
using VisioForge.Core.Types.X.Sources;
using VisioForge.Core.VideoCaptureX;

class Program
{
    static async Task Main(string[] args)
    {
        // Initialiser le SDK
        await VisioForgeX.InitSDKAsync();

        var videoCapture = new VideoCaptureCoreX();

        try
        {
            // Énumérer les périphériques de capture audio
            var audioDevices = await DeviceEnumerator.Shared.AudioSourcesAsync(
                AudioCaptureDeviceAPI.DirectSound);

            if (audioDevices.Length == 0)
            {
                Console.WriteLine("No audio capture device found.");
                return;
            }

            // Afficher les périphériques disponibles
            Console.WriteLine("Available audio devices:");
            for (int i = 0; i < audioDevices.Length; i++)
            {
                Console.WriteLine($"  {i + 1}. {audioDevices[i].DisplayName}");
            }

            // Sélectionner le premier périphérique (microphone par défaut)
            var selectedDevice = audioDevices[0];
            var audioFormat = selectedDevice.GetDefaultFormat();
            var audioSource = selectedDevice.CreateSourceSettingsVC(audioFormat);

            // Configurer la capture audio uniquement
            videoCapture.Audio_Source = audioSource;
            videoCapture.Video_Source = null;
            videoCapture.Video_Play = false;
            videoCapture.Audio_Play = false;
            videoCapture.Audio_Record = true;

            // Configurer la sortie MP3
            string outputPath = Path.Combine(
                Environment.GetFolderPath(Environment.SpecialFolder.MyMusic),
                $"mic_recording_{DateTime.Now:yyyyMMdd_HHmmss}.mp3");

            var mp3Output = new MP3Output(outputPath);
            videoCapture.Outputs_Add(mp3Output, autostart: true);

            // Démarrer l'enregistrement
            await videoCapture.StartAsync();
            Console.WriteLine($"Recording to: {outputPath}");
            Console.WriteLine("Press ENTER to stop...");
            Console.ReadLine();

            // Arrêter et sauvegarder
            await videoCapture.StopAsync();
            Console.WriteLine("Recording saved.");
        }
        finally
        {
            await videoCapture.DisposeAsync();
            VisioForgeX.DestroySDK();
        }
    }
}

Capturer l'audio système (haut-parleur / loopback)¶

La capture audio système (également appelée loopback ou capture haut-parleur) enregistre tout son lu par le périphérique de sortie de votre ordinateur. Cela est couramment utilisé pour l'enregistrement d'écran avec audio, la capture d'appels en conférence ou l'enregistrement audio en streaming.

Sous Windows, la capture loopback utilise l'API WASAPI2 pour accéder aux périphériques de sortie.

Exemple complet — Video Capture SDK X¶

using System;
using System.IO;
using System.Linq;
using System.Threading.Tasks;
using VisioForge.Core;
using VisioForge.Core.Types.X.Output;
using VisioForge.Core.Types.X.Sources;
using VisioForge.Core.VideoCaptureX;

class Program
{
    static async Task Main(string[] args)
    {
        // Initialiser le SDK
        await VisioForgeX.InitSDKAsync();

        var videoCapture = new VideoCaptureCoreX();

        try
        {
            // Énumérer les périphériques de sortie audio WASAPI2 (haut-parleurs/écouteurs)
            var audioOutputs = await DeviceEnumerator.Shared.AudioOutputsAsync(
                AudioOutputDeviceAPI.WASAPI2);

            if (audioOutputs.Length == 0)
            {
                Console.WriteLine("No WASAPI2 audio output device found.");
                return;
            }

            // Afficher les sources loopback disponibles
            Console.WriteLine("Available loopback devices:");
            for (int i = 0; i < audioOutputs.Length; i++)
            {
                Console.WriteLine($"  {i + 1}. {audioOutputs[i].Name}");
            }

            // Sélectionner le premier périphérique
            var outputDevice = audioOutputs[0];

            // Créer les paramètres de source loopback
            var audioSource = new LoopbackAudioCaptureDeviceSourceSettings(outputDevice);
            videoCapture.Audio_Source = audioSource;

            // Configurer pour une capture audio uniquement
            videoCapture.Audio_Play = false;
            videoCapture.Audio_Record = true;
            videoCapture.Video_Play = false;

            // Configurer la sortie M4A (AAC)
            string outputPath = Path.Combine(
                Environment.GetFolderPath(Environment.SpecialFolder.MyMusic),
                $"system_audio_{DateTime.Now:yyyyMMdd_HHmmss}.m4a");

            var m4aOutput = new M4AOutput(outputPath);
            videoCapture.Outputs_Add(m4aOutput, autostart: true);

            // Démarrer la capture de l'audio système
            await videoCapture.StartAsync();
            Console.WriteLine($"Capturing system audio to: {outputPath}");
            Console.WriteLine("Play some audio on your computer, then press ENTER to stop...");
            Console.ReadLine();

            // Arrêter et sauvegarder
            await videoCapture.StopAsync();
            Console.WriteLine("Recording saved.");
        }
        finally
        {
            await videoCapture.DisposeAsync();
            VisioForgeX.DestroySDK();
        }
    }
}

Exemple complet — Media Blocks SDK¶

Le Media Blocks SDK utilise une approche par pipeline où vous connectez des blocs de source, de traitement et de sortie. Cet exemple capture l'audio système à l'aide de SystemAudioSourceBlock et le sauvegarde dans un fichier M4A.

using System;
using System.IO;
using System.Linq;
using System.Threading.Tasks;
using VisioForge.Core;
using VisioForge.Core.MediaBlocks;
using VisioForge.Core.MediaBlocks.Sources;
using VisioForge.Core.MediaBlocks.Sinks;
using VisioForge.Core.Types.X.Sources;

class Program
{
    static async Task Main(string[] args)
    {
        // Initialiser le SDK
        await VisioForgeX.InitSDKAsync();

        MediaBlocksPipeline pipeline = null;

        try
        {
            // Obtenir le premier périphérique de sortie WASAPI2 pour la capture loopback
            var audioOutputs = await DeviceEnumerator.Shared.AudioOutputsAsync(
                AudioOutputDeviceAPI.WASAPI2);

            if (audioOutputs.Length == 0)
            {
                Console.WriteLine("No WASAPI2 audio output device found.");
                return;
            }

            var outputDevice = audioOutputs[0];
            Console.WriteLine($"Using loopback device: {outputDevice.Name}");

            // Créer le pipeline
            pipeline = new MediaBlocksPipeline();

            // Créer la source audio loopback
            var sourceSettings = new LoopbackAudioCaptureDeviceSourceSettings(outputDevice);
            var audioSource = new SystemAudioSourceBlock(sourceSettings);

            // Créer la sortie M4A
            string outputPath = Path.Combine(
                Environment.GetFolderPath(Environment.SpecialFolder.MyMusic),
                $"system_audio_{DateTime.Now:yyyyMMdd_HHmmss}.m4a");

            var output = new M4AOutputBlock(outputPath);

            // Connecter la source à la sortie
            pipeline.Connect(audioSource, output);

            // Démarrer le pipeline
            await pipeline.StartAsync();
            Console.WriteLine($"Capturing system audio to: {outputPath}");
            Console.WriteLine("Press ENTER to stop...");
            Console.ReadLine();

            // Arrêter le pipeline
            await pipeline.StopAsync();
            Console.WriteLine("Recording saved.");
        }
        finally
        {
            if (pipeline != null)
            {
                await pipeline.DisposeAsync();
            }

            VisioForgeX.DestroySDK();
        }
    }
}

Fonctionnalités clés¶

Contrôle des périphériques¶

Énumérer tous les périphériques d'entrée et de sortie audio disponibles
Sélectionner par programme des périphériques d'entrée spécifiques
Définir le volume d'entrée et l'état muet
Surveiller les niveaux audio en temps réel avec des VU-mètres
Auto-sélectionner les périphériques système par défaut

Traitement avancé¶

Visualisation audio en temps réel avec analyse de spectre et de forme d'onde
Réduction du bruit et annulation d'écho
Contrôle de gain et normalisation
Détection d'activité vocale (VAD)
Gestion des canaux stéréo/mono
Conversion de fréquence d'échantillonnage

Contrôles d'enregistrement¶

Démarrer, mettre en pause, reprendre et arrêter l'enregistrement
Gestion du tampon pour un fonctionnement à faible latence
Enregistrements minutés avec arrêt automatique
Division de fichiers pour les enregistrements volumineux
Nommage automatique des fichiers avec horodatage

Notes multiplateformes¶

Plateforme	Microphone	Audio système (loopback)
Windows	DirectSound, WASAPI2	loopback WASAPI2
macOS	CoreAudio	Non disponible via le SDK
Linux	PulseAudio, ALSA	moniteur PulseAudio

La capture loopback de l'audio système est principalement une fonctionnalité Windows utilisant l'API WASAPI2. Sous Linux, les périphériques moniteur PulseAudio peuvent offrir une fonctionnalité similaire.

Bonnes pratiques¶

Vérifiez la disponibilité du périphérique avant de démarrer la capture — les périphériques peuvent être déconnectés à tout moment
Surveillez les niveaux audio pendant l'enregistrement pour détecter le silence ou la saturation
Choisissez le bon format — MP3/M4A pour une sortie compressée, WAV pour une qualité maximale, FLAC pour une compression sans perte
Utilisez WASAPI2 pour la capture loopback sous Windows — il offre la latence la plus faible et la capture audio système la plus fiable
Gérez les erreurs avec soin — implémentez la gestion des erreurs pour les événements de déconnexion de périphérique
Testez sur le matériel cible — le comportement des périphériques audio varie selon les systèmes

Exemples d'applications¶

Des exemples complets et fonctionnels sont disponibles sur GitHub :