NAudio实现左右声道独立音量时PanningSampleProvider提示源采样器须为单声道

NAudio 内置的PanningSampleProvider存在明确的设计约束：输入的采样提供器必须为单声道格式。
它的实现逻辑是将单声道音频流，按照pan参数的取值（范围-1到1）动态分配左右声道的输出增益，本质是为单声道信号做声像空间定位设计，完全不支持双声道输入。你的输入源本身是44100Hz、16bit、双声道的音频格式，触发了内部的格式校验，直接抛出Source sample provider must be mono异常，这是组件本身的实现限制，并非业务逻辑错误。

针对你需要基于双声道音频独立控制左右声道音量、实现声像调节的核心诉求，完全不需要将双声道音频强制转码为单声道后再使用内置PanningSampleProvider（这种转码会直接丢失一半声道的原始信息，平白损耗音质）。按照StackOverflow评论提到的实现思路，我们可以直接编写一个兼容双声道输入的极简左右独立音量控制提供器，替代原有组件链路。

自定义双声道音量SampleProvider实现 #

/// <summary>
/// 兼容双声道输入的独立音量控制提供器，可直接替代PanningSampleProvider
/// </summary>
public class DualChannelVolumeSampleProvider : ISampleProvider
{
    private readonly ISampleProvider _sourceProvider;
    /// <summary>
    /// 左声道输出增益，取值范围0.0~1.0
    /// </summary>
    public float LeftVolume { get; set; } = 1.0f;
    /// <summary>
    /// 右声道输出增益，取值范围0.0~1.0
    /// </summary>
    public float RightVolume { get; set; } = 1.0f;
    /// <summary>
    /// 声像参数，取值范围-1~1（-1为全左输出，0为居中，1为全右输出）
    /// </summary>
    public float Pan
    {
        set
        {
            LeftVolume = value <= 0 ? 1.0f : 1.0f - value;
            RightVolume = value >= 0 ? 1.0f : 1.0f + value;
        }
    }

    public DualChannelVolumeSampleProvider(ISampleProvider sourceProvider)
    {
        // 校验输入源为双声道格式，匹配你的音频规格
        if (sourceProvider.WaveFormat.Channels != 2)
            throw new ArgumentException("该提供器仅支持双声道输入源");
        _sourceProvider = sourceProvider;
    }

    public WaveFormat WaveFormat => _sourceProvider.WaveFormat;

    public int Read(float[] buffer, int offset, int count)
    {
        // 从源端读取原始采样数据
        int samplesRead = _sourceProvider.Read(buffer, offset, count);
        // 双声道采样的排列顺序为：左、右、左、右... 逐采样调整对应声道的增益
        for (int i = 0; i < samplesRead; i += 2)
        {
            buffer[offset + i] *= LeftVolume;
            buffer[offset + i + 1] *= RightVolume;
        }
        return samplesRead;
    }
}

现有代码适配修改 #

替换原代码中VolumeSampleProvider + PanningSampleProvider的组件链路，同时修正原逻辑中UDP接收续接的隐患：

private void ReceiveUdpMessage(IAsyncResult ar)
{
    try
    {
        byte[] bytesRead = UDPc.EndReceive(ar, ref ep);
        var waveProvider = new BufferedWaveProvider(new WaveFormat(44100, 16, 2));
        waveProvider.DiscardOnBufferOverflow = true;
        waveProvider.AddSamples(bytesRead, 0, bytesRead.Length);
        var rawSampleProvider = waveProvider.ToSampleProvider();
        
        // 用自定义双声道音量提供器替代原有Pan组件
        var dualVolumeProvider = new DualChannelVolumeSampleProvider(rawSampleProvider)
        {
            // 可直接设置声像值，也可独立指定左右声道音量
            Pan = 0f,
            // LeftVolume = 0.7f,
            // RightVolume = 1.0f
        };
        
        mixer.AddMixerInput(dualVolumeProvider);
    }
    catch (Exception ex)
    {
        // 补充异常日志逻辑，避免空捕获掩盖问题
    }
    finally
    {
        // 将续接UDP接收的逻辑放入finally块，避免原代码两次调用BeginReceive导致的重复回调、内存泄漏问题
        if (UDPc != null && UDPc.Client != null && UDPc.Client.IsBound)
        {
            UDPc.BeginReceive(new AsyncCallback(ReceiveUdpMessage), null);
        }
    }
}

• 如果需要同时保留全局总音量控制，可以将NAudio内置的VolumeSampleProvider放在自定义双声道提供器的上游，组件链路为：BufferedWaveProvider -> 全局VolumeSampleProvider -> DualChannelVolumeSampleProvider -> Mixer
• 该自定义提供器的运算逻辑仅为逐采样浮点乘法，性能损耗极低，完全适配聊天类应用的低延迟播放需求
• 不建议为了适配内置PanningSampleProvider，将双声道音频强制转为单声道，这种操作会破坏原始双声道音频的空间信息，造成不必要的音质损耗

内容的提问来源于stack exchange，提问作者Ratatat1212