c++ vst3音频插件开发 c++如何编写一个vst3效果器-C++-PHP中文网

VST3效果器不能只靠main()，因其是需实现IComponent等接口的动态库，由宿主按协议加载；必须继承AudioEffect、重写process()等虚函数，提供GetFactory()，并用引用计数管理生命周期。

c++ vst3音频插件开发 c++如何编写一个vst3效果器

为什么直接写 VST3 效果器不能只靠 `main()`？

因为 VST3 插件不是独立程序，而是遵循 Steinberg 官方 IComponent、IEditController、IAudioProcessor 等接口的动态库（Windows 上是 .dll，macOS 是 .vst3 bundle）。你写的 C++ 代码必须被宿主（如 Cubase、Reaper）按 VST3 协议加载和调用，不实现这些接口，宿主根本识别不了你的插件。

常见错误现象：Plugin not found 或宿主报 Invalid module，往往是因为导出符号不对、缺少 GetFactory() 入口、或未链接 VST3 SDK 的 public.sdk 和 pluginterfaces。

必须用 Steinberg::Vst::AudioEffect 基类继承并重写关键虚函数，比如 process()、setBusArrangements()
必须提供全局 GetFactory() 函数，返回一个实现了 IPluginFactory 的对象
所有接口指针传递都通过 void** + QUERYINTERFACE 宏完成，不能裸传 this
不要手动管理插件生命周期（比如 new/delete 插件实例），全部交给 SDK 的 FUnknown 引用计数机制

`process()` 里怎么安全读写音频缓冲区？

VST3 使用非连续、可变通道数的缓冲区结构：Vst::ProcessData 中的 inputs 和 outputs 是 Vst::AudioBusBuffers* 数组，每个 bus 又含 channelBuffers32 或 channelBuffers64（取决于宿主请求的精度）。直接索引 buffer[0] 很容易越界或错用浮点类型。

典型踩坑：process() 被调用时，processData->numSamples 可能为 0（静音段）、或与前次不同（block size 可变）；若没检查就 memcpy 或 for-loop，会触发 ASan 报错或爆音。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

始终先检查 processData->numSamples > 0，否则直接 return
用 processData->inputParameterChanges 读自动化参数，别在 process() 外部缓存 IParamValueQueue 指针
对每个 input/output bus，遍历 bus->getChannelCount()，再对每通道调用 bus->getChannelBuffer(channel) 获取真实指针
若宿主启用了双精度处理（processData->processMode == Vst::kRealtime 但 sampleRate 高且插件声明支持），需分支处理 float* 和 double*

process()

每个参数需注册唯一 ParamID（如 static const ParamID kGainId = 0;），并在 getParams() 返回的 IParameter 列表中定义
performEdit() 中仅做合法性检查，然后调用 fireParamChanged(paramID, normalizedValue)
在 process() 开头，遍历 data.inputParameterChanges 的每个 IParamValueQueue，用 getPoint() 提取时间戳和归一化值，再插值更新本地变量（如 mGainSmoothed）
避免在 performEdit() 中做任何耗时操作（如文件 IO、malloc），它运行在 UI 线程

为什么插件加载后没声音或 CPU 占用飙高？

最常被忽略的是总线配置和采样率适配。VST3 默认只声明 1 个输入/输出 bus，且默认是 mono。如果宿主以 stereo 发送音频，但插件没声明 stereo bus，宿主可能静音转发或 fallback 到错误通道映射。

另一个隐蔽问题是采样率变更未响应：setSampleRate() 被调用后，如果你的滤波器系数还用旧的 sampleRate 计算，就会失真甚至振荡；而如果没重置延迟线长度等状态，还会产生点击声。

在 MyEffect::setBusArrangements() 中显式接受 stereo 输入/输出：inputs[0].setChannelCount(2)，并 return kResultTrue（否则宿主认为不支持该布局）
重写 setSampleRate()，更新所有依赖采样率的计算（如 1.0 / sampleRate、biquad 系数），并清空 IIR 滤波器状态数组
在 setupProcessing() 中根据 processSetup.processMode 决定是否启用多线程优化（如 OpenMP），但注意 VST3 已保证 process() 不会被并发调用，通常无需额外锁
调试时打开 Steinberg::Vst::IComponent::canProcessSampleSize()，确保返回 kResultTrue 对应的 SampleSize（kSample32 或 kSample64）