VST3插件重采样技术疑问：如何设置输出采样率？

问题背景 #

我正在开发一款对标WaveLab「重采样插件」的VST3插件，可将音频数据重采样至指定采样率，目前遇到以下技术疑问：

1. VST3插件如何修改输出采样率？
2. 重采样时输入输出样本数会不一致，但目前仅能获取data.numSamples这一个样本计数，VST3插件是否允许输入输出样本数不同？
3. WaveLab重采样插件是如何实现该功能的？

另外，我曾尝试在setupProcessing方法中修改输出采样率，但并未生效，代码如下：

tresult PLUGIN_API MyPlugin::setupProcessing(ProcessSetup& newSetup)
{   
    newSetup.sampleRate = 48000.0;  
    processSetup.sampleRate = 48000.0;  
    return AudioEffect::setupProcessing(newSetup);
}

解答 #

1. VST3插件修改输出采样率的正确方式 #

你在setupProcessing里修改采样率无效是因为这个方法是宿主通知插件当前处理环境的入口，插件只能被动接收参数，无法反向修改宿主的采样率配置。

VST3插件的采样率逻辑分两种场景：

• 实时处理场景：插件必须和宿主的采样率保持一致，不能主动修改。所有音频处理都要在宿主指定的采样率下完成，重采样只能作为内部逻辑，最终输出的音频采样率仍需匹配宿主。
• 离线处理场景：如果是针对WaveLab这类支持离线处理的宿主，插件可以通过实现IProcessContextRequirements接口，或者在ProcessData的上下文参数中传递离线处理请求，告知宿主需要调整输出采样率，宿主会根据插件的要求分配对应采样率的输出缓冲区。

2. VST3插件是否允许输入输出样本数不同？ #

同样分两种场景：

• 实时处理场景：输入输出样本数必须严格等于data.numSamples，宿主按固定缓冲区大小调度插件，不允许输出样本数和输入不一致。这种情况下实现重采样，需要在插件内部维护一个环形缓存区：缓存输入的样本，根据采样率比例计算可生成的输出样本数，当缓存足够生成data.numSamples个输出样本时，输出对应数据，剩余的缓存留到下一次处理循环使用，以此保证每次输出的样本数符合宿主要求。
• 离线处理场景：完全允许输入输出样本数不同。插件可以根据目标采样率/输入采样率的比例，直接计算出输出的总样本数，宿主会根据这个数值分配足够的输出缓冲区，插件只需按重采样逻辑处理数据即可。

3. WaveLab重采样插件的实现思路 #

WaveLab的重采样插件主要面向离线音频处理，核心逻辑大致如下：

1. 读取输入音频的元数据（采样率、通道数、总样本数等），结合用户设置的目标采样率，计算输出的总样本数和采样率比例。
2. 向宿主申请对应采样率和样本数的输出缓冲区，确认离线处理的环境配置。
3. 使用专业的重采样算法进行处理：通常会选择音质和效率平衡的算法，比如带抗混叠滤波的sinc插值，或者直接调用成熟的重采样库来保证音质。
4. 逐段处理音频数据，维护输入输出的样本位置映射，避免出现时间偏移或音质损失。
5. 若支持实时重采样场景，则会采用带缓存的流式处理逻辑，通过缓存区平衡输入输出的样本数差异，同时控制处理延迟。

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