NAudio自定义SampleProvider Read时缓冲区未按预期更新无声音问题

问题根因汇总 #

• 音频样本预处理错误，将正常[-1,1]区间的样本非法缩放至接近0的极小值
• 输入声道缓冲区引用错误，左右声道写入同一块内存导致样本被覆盖
• SampleProvider的Read方法逻辑不符合NAudio规范，提前返回0触发播放终止
• 冗余的全数组校验逻辑误将复用缓冲区的脏数据判断为异常值

具体修复步骤 #

1. 修正音频样本赋值逻辑 #

AudioFileReader读取返回的float数组本身就是[-1,1]区间的标准IEEE浮点音频样本，无需除以int.MaxValue，同时修正右声道缓冲区引用错误：

// 左声道取第一个输入缓冲区，右声道取第二个输入缓冲区
var leftSpan = inputBuffers[0].AsSpan();
var rightSpan = inputBuffers[1].AsSpan();
for (int i = 0; i < blockSize; i++)
{
    leftSpan[i] = nAudiobuffer[i*2]; // 移除除以int.MaxValue的冗余操作
    rightSpan[i] = nAudiobuffer[i*2 + 1];
}

2. 修正VstSampleProvider的Read方法逻辑 #

NAudio的ISampleProvider.Read约定：

• 不足请求样本数时返回实际可提供的样本数，而非直接返回0
• 仅当流完全结束、无任何后续样本时才返回0
• 无需校验整个缓冲区，仅保证你写入的范围内样本正常即可

修复后的Read方法：

public int Read(float[] buffer, int offset, int count)
{
    int samplesRead = 0;
    // 能读取多少样本就返回多少，不要直接返回0终止流
    while(samplesRead < count && _buffer.Count > 0)
    {
        buffer[offset + samplesRead] = _buffer.Dequeue();
        samplesRead++;
    }
    return samplesRead;
}

3. 匹配采样率避免异常 #

不要固定写死44100采样率，直接使用输入音频的采样率初始化SampleProvider：

var vstSampleProvider = new VstSampleProvider(audioFile.WaveFormat.SampleRate, audioFile.WaveFormat.Channels);

4. 调整播放触发时机 #

如果是预处理全量音频再播放的模式，不需要修改顺序，只要保证Read方法不会提前返回0即可；如果要降低内存占用，可改为边读取边处理边播放的模式。 #

关于断点看到异常值的说明 #

你观察到的buffer中存在大于1的整数或0，是因为NAudio传入的buffer数组是复用的，你只写入了前N个有效样本，后续位置是之前使用留下的脏数据，属于正常现象，无需处理。你自己写入的样本范围值是正确的，不影响播放。

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