.NET 音频采集

本文介绍Windows下声音数据的采集，用于本地录音、视讯会议、投屏等场景

声音录制有麦克风、扬声器以及混合录制三类方式，麦克风和扬声器单独录制的场景更多点，混合录制更多的是用于本地录音

我们基于NAudio实现，开源组件NAudio已经很稳定的实现了各类播放、录制、转码等功能，WaveIn,WaveInEvent,WasapiCapture,WasapiLoopbackCapture, WaveOut, WaveStream, WaveFileWriter, WaveFileReader, AudioFileReader都是比较常见的类，下面详细介绍下录制模块的实现

麦克风录制

1.WaveInEvent

通过WaveInEvent类，我们可以捕获麦克风输入：

    private WaveInEvent _waveIn;
    private WaveFileWriter _writer;
    private void MainWindow_Loaded(object sender, RoutedEventArgs e)
    {
        _waveIn = new WaveInEvent();
        //441采样率，单通道
        _waveIn.WaveFormat = new WaveFormat(44100, 1);
        _writer = new WaveFileWriter("recordedAudio.wav", _waveIn.WaveFormat);
        _waveIn.DataAvailable += (s, a) =>
        {
            _writer.Write(a.Buffer, 0, a.BytesRecorded);
        };
        // 列出所有可用的录音设备
        for (int i = 0; i < WaveIn.DeviceCount; i++)
        {
            var deviceInfo = WaveIn.GetCapabilities(i);
            OutputTextBlock.Text += $"Device {i}: {deviceInfo.ProductName}\r\n";
        }
    }
    private void StartRecordButton_OnClick(object sender, RoutedEventArgs e)
    {
        _waveIn.StartRecording();
    }
    private void StopRecordButton_OnClick(object sender, RoutedEventArgs e)
    {
        _waveIn.StopRecording();
        _waveIn.Dispose();
        _writer.Close();
    }

在每次录制到数据时，将数据写入文件。上面是实现保存录音的DEMO

2.WaveIn

还有WaveIn，和WaveInEvent是一样接口IWaveIn。如果是Windows窗口应用，可以直接使用WaveIn，但需要传入窗口句柄。控制台应用是无法支持WaveIn的

WaveIn构造参数需要传入窗口句柄，默认不传的话NAudio会创建一个窗口：

    internal void Connect(WaveInterop.WaveCallback callback)
    {
      if (this.Strategy == WaveCallbackStrategy.NewWindow)
      {
        this.waveOutWindow = new WaveWindow(callback);
        this.waveOutWindow.CreateControl();
        this.Handle = this.waveOutWindow.Handle;
      }
      else
      {
         .........
      }
    }

另外这里的WaveWindow是winform窗口，internal class WaveWindow : Form

WaveIn 使用回调函数（Callback）来处理音频数据，这种回调函数会在 Windows 收到音频数据时通过消息机制调度。这通常意味着你需要管理并处理这些回调函数，以确保音频数据的正确捕捉和处理。然而这也意味着需要更多的底层工作和线程安全控制。

而在控制台这类非GUI应用，就建议使用WaveInEvent了，它未使用窗口消息，而是通过while循环监听buffers数据，通过判断buffer.Done是否完成来触发输出buffer数据事件DataAvailable。

所以性能来说WaveIn从线程处理上会占优很多，未做过对比测试（待补充）

3.WasapiCapture

除了WaveIn API，还可以使用WasapiCapture, 它与WaveIn的使用方式是一致的, 可以用来录制麦克风WaveInAPI虽然没有独占、共享功能，但也需要处理并发问题，即多个录音实例访问同一个麦克风设备的话会存在并发访问问题。

WasapiCapture是WASAPI About WASAPI - Win32 apps | Microsoft Learn，全称Windows Audio Session Application Programming Interface (Windows音频会话应用编程接口) ，它在Windows Vista引入 、提供了一些关键的改进

比如，提供更低的音频延迟和高性能音频处理，可以提供共享模式和独占模式

在共享模式下，可以与多个应用程序共享一个音频设备；WasapiCapture.ShareMode = AudioClientShareMode.Shared;

在独占模式下，应用程序可以完全控制音频设备，降低延迟 AudioClientShareMode.Exclusive

看看WasapiCapture DEMO，都是基于IWaveIn接口实现，所以代码无差别：

    private WaveFileWriter _writer;
    private WasapiCapture _capture;
    private void MainWindow_Loaded(object sender, RoutedEventArgs e)
    {
        _capture = new WasapiCapture();
        _writer = new WaveFileWriter("recordedAudio.wav", _capture.WaveFormat);
        _capture.DataAvailable += (s, a) =>
        {
            _writer.Write(a.Buffer, 0, a.BytesRecorded);
        };
        // 列出所有可用的录音设备
        for (int i = 0; i < WaveIn.DeviceCount; i++)
        {
            var deviceInfo = WaveIn.GetCapabilities(i);
            OutputTextBlock.Text += $"Device {i}: {deviceInfo.ProductName}\r\n";
        }
    }

录制麦克风音频，WasapiCapture 是最佳选择，专为低延迟、高性能设计

另外，如果音频采集时需要重采样，可以使用BufferedWaveProvider缓存DataAvailable事件过来的原始音频数据，

    //创建BufferedWaveProvider，缓存原始音频数据
    var bufferedProvider = new BufferedWaveProvider(provider.NAudioWaveFormat)
    {
        DiscardOnBufferOverflow = true,
        ReadFully = false
    };
    provider.WaveIn.DataAvailable += (s, e) =>
    {
        //将音频数据写入 BufferedWaveProvider
        bufferedProvider.AddSamples(e.Buffer, 0, e.BytesRecorded);
    };
    //获取采样接口
    var sampleProvider = bufferedProvider.ToSampleProvider();
    sampleProvider = new WdlResamplingSampleProvider(sampleProvider, TargetFormat.SampleRate);
    //重采样后的音频数据
    _waveProvider = sampleProvider.ToWaveProvider16();

BufferedWaveProvider、SampleToWaveProvider16均是实现IWaveProvider通用接口，可提供音频格式以及获取数据接口

  public interface IWaveProvider
  {
    /// <summary>Gets the WaveFormat of this WaveProvider.</summary>
    /// <value>The wave format.</value>
    WaveFormat WaveFormat { get; }

    /// <summary>Fill the specified buffer with wave data.</summary>
    /// <param name="buffer">The buffer to fill of wave data.</param>
    /// <param name="offset">Offset into buffer</param>
    /// <param name="count">The number of bytes to read</param>
    /// <returns>the number of bytes written to the buffer.</returns>
    int Read(byte[] buffer, int offset, int count);
  }

将重采样的数据写入本地文件保存：

    /// <summary>
    /// 目标音频格式
    /// </summary>
    public WaveFormat TargetFormat { get; }
    public void Save()
    {
        using var writer = new WaveFileWriter("recordedAudio.wav", TargetFormat);
        // 将重采样后的数据写入文件
        byte[] buffer = new byte[TargetFormat.AverageBytesPerSecond];
        int bytesRead;
        while ((bytesRead = _waveProvider.Read(buffer, 0, buffer.Length)) > 0)
        {
            writer.Write(buffer, 0, bytesRead);
        }
    }

这样，我们使用 WasapiCapture 捕获音频数据，并将这些数据实时重采样到指定采样率如44.1kHz（常见的采样率有441和480），单声道格式。录音结束后，重采样后的音频数据再被保存到一个WAV文件中。

另外如果是单通道声音，可以转换成多通道即立体声：

    // Mono to Stereo
    if (simpleFormat.Channels == 1)
    {
        sampleProvider = sampleProvider.ToStereo();
    }

ToStereo返回的MonoToStereoSampleProvider，会将单通道声音数据，转换为双通道的音频格式。但实际上，采样器MonoToStereoSampleProvider内部只有一份source数据，在Read时外部参数Samples直接除以2即变成了1，左右声道均输出此音频数据。

麦克风录制，推荐首选WasapiCapture。

扬声器录制

录制扬声器声音即声卡输出，借助WasapiLoopbackCapture可简单实现，使用方式与WasapiCapture没区别。部分代码：

    var capture = new WasapiLoopbackCapture();
    var writer = new WaveFileWriter("recordedAudio.wav", capture.WaveFormat);
    capture.DataAvailable += (s, a) =>
    {
        writer.Write(a.Buffer, 0, a.BytesRecorded);
    };
    capture.StartRecording();
    // 列出所有可用的扬声器设备
    for (int i = 0; i < WaveOut.DeviceCount; i++)
    {
        var deviceInfo = WaveOut.GetCapabilities(i);
        OutputTextBlock.Text += $"Device {i}: {deviceInfo.ProductName}\r\n";
    }

1. 音频可视化

值得另外说的，扬声器录制有一类厂测场景，上位机工厂测试软件测试扬声器，需要显示声道的音频曲线

音频波形图或者频谱图，可以通过DataAvailable拿到的字节数组，根据可视化图X坐标需要显示的点列数量，在数组中获取数据然后映射到可视化图表坐标Y值上。详细的可参考这篇 [C#] 使用 NAudio 实现音频可视化_c#声音频谱-CSDN博客，它实现的是曲线，也可以另外换成柱状图。

录制扬声器，有些场景需要关闭本地扬声器外放。投屏软件有这个场景，会将当前设备A的声卡音频数据传输到其它设备B上播放，但设备A不想重复播放声音。因为设备A播放声音的话，会议室会有混音，并且投屏设备A一般是笔记本、设备B是会议大屏，扬声器质量和功率是不如专业的交互大屏的，大屏扬声器价格会贵点。

    var volume = playbackDevice.AudioEndpointVolume;
    // 记录原音量，用于结束录制时恢复音量
    float originalVolume = volume.MasterVolumeLevelScalar;
    // 静音播放设备
    volume.MasterVolumeLevelScalar = 0;

2.保持扬声器活跃

同时，录制扬声器是一个持续活动，为避免因无音频信号导致设备自动关闭或进入低功耗状态，在不想关闭音频设备而又没有实际音频播放任务时，会用沉默音频保持设备活跃。可以按如下操作

1).创建一个WasapiOut实例，指定使用共享模式：var wasapiOut = new WasapiOut(device, AudioClientShareMode.Shared, true, 50);

2).获取音频设备MMDevice的AudioClient对象

using var audioClient = device.AudioClient;
wasapiOut.Init(new SilenceProvider(audioClient.MixFormat));

3).在启动WasapiLoopbackCapture录制时，将此静音波形播放对象启动，持续生成静音信号

混音录制

也有必要介绍下混音录制，虽然场景较少。

初始化多个麦克风、扬声器录制器，然后同上面重采样操作，创建一个 BufferedWaveProvider (bufferedProvider)，用于存储输入的音频数据。

订阅订阅 IWaveIn 的 DataAvailable 事件，将数据都塞进缓存音频缓存器

最后返回16位浮点波形数据存储器，IWaveProvider数据获取方式同上面重采样操作。

    public MixAudioCapture(params IWaveIn[] audioWaveCaptures)
    {
        _audioWaveCaptures = audioWaveCaptures;
        var sampleProviders = new List<ISampleProvider>();
        foreach (var waveIn in audioWaveCaptures)
        {
            var bufferedProvider = new BufferedWaveProvider(waveIn.WaveFormat)
            {
                DiscardOnBufferOverflow = true,
                ReadFully = false
            };
            waveIn.DataAvailable += (s, e) =>
            {
                bufferedProvider.AddSamples(e.Buffer, 0, e.BytesRecorded);
            };
            var sampleProvider = bufferedProvider.ToSampleProvider();
            sampleProviders.Add(sampleProvider);
        }
        var waveProviders = sampleProviders.Select(m => m.ToWaveProvider());
        // 混音后的音频数据
        _waveProvider = new MixingWaveProvider32(waveProviders).ToSampleProvider().ToWaveProvider16();
    }

一般混音的同时，也会重采样。看具体场景操作吧。

上方示例代码详见Demo kybs00/AudioCaptureDemo: 音频采集DEMO (github.com)

 

参考：

简要介绍WASAPI播放音频的方法 - PeacoorZomboss - 博客园 (cnblogs.com)

[C#] 使用 NAudio 实现音频可视化_c#声音频谱-CSDN博客

naudio/NAudio: Audio and MIDI library for .NET (github.com)

关键字：音频采集、麦克风/扬声器/混音采集