VST3 SDK 3.6.14：目录分层、AGain样例与出声链路-北京尧图网络

简介VST SDK 3.6.14 Build-24 是 Steinberg 面向音频插件开发者发布的官方开发包定位于帮助具备 C 基础的音乐软件开发者构建与数字音频工作站兼容的 VST3 插件覆盖音频处理、合成器、均衡器、压缩器等方向。包内提供 IAudioProcessor、IEditController 等接口定义配合示例工程、API 参考文档、跨平台构建脚本与 VSTPluginExample 测试宿主可用于理解参数自动化、多通道处理、64 位精度、插件延迟补偿及音频处理与界面分离的模块化架构也保留与 VST2 插件兼容的参考路径。压缩包约 86.17MB文件总数与类型明细在页面暂未列出实际以压缩包内容为准。该资源已有 202 人学习适合想系统进入音乐软件开发、对照官方接口与示例完成插件原型验证的开发者查阅。1. 2019 年的 VST3 SDK 3.6.14为什么现在还有人翻出来VST、VST SDK、VST3 三个词经常被混着搜其实指向同一套东西的不同层面VST 是插件格式VST3 是第三代规范VST SDK 是官方放出来的实现包。手上这份vst-sdk_3.6.14_build-24_2019-11-29.zip是 2019 年底的一个完整快照从纯虚接口定义、参考基类、样例工程到三个平台的编译入口全都塞在一个压缩包里。上个月帮人看一个编译能过、宿主里死活不出现的插件最后发现对方照着网上的新教程改了目录结构而那套目录是更晚的版本才有的。这类问题在这份老包上特别常见接口本身很稳稳到 2019 年编出来的二进制现在还能被主流宿主正常加载但外围的工程组织、样例命名、编译脚本跟现在的教程差了一代照抄就会出问题。它适合两种人一是要维护存量插件、不想整体升级的二是想把 VST3 从「被扫到」到「出声音」这条链路一次看透的看完再去看新版本能省很多事。2. 解包先看这三层pluginterfaces、public.sdk、base 的分工与依赖顺序拿到一个 SDK 压缩包很多人的第一反应是找样例工程双击打开然后被一堆找不到的头文件拦住。这套 SDK 的目录划分是有明确依赖方向的搞清楚谁依赖谁编译报错基本能自己定位。这一章先把三层结构摊开再说样例工程该怎么挑。2.1 插件与宿主之间的唯一契约在 pluginterfacespluginterfaces是整套东西里最独立的一层只依赖自己内部的pluginterfaces/base不引用public.sdk的任何东西。里面全是纯虚类和 FUID 常量没有一行实现代码。宿主加载你的插件之后能调用的每一个方法都在这几个头文件里。解包之后先瞄一眼结构unzip -q vst-sdk_3.6.14_build-24_2019-11-29.zip -d sdk cd sdk/VST_SDK/VST3_SDK ls pluginterfaces/base ls pluginterfaces/vstbase目录下会看到funknown.h、fuid.h、ipluginbase.h、fplatform.h。funknown.h定义了FUnknown和tresult顺手把kResultOk、kResultTrue、kResultFalse、kInvalidArgument这些返回值常量也定义了——注意kResultOk和kResultTrue的值都是 0写代码时混用不影响运行但读代码的人会误解你的意图。vst目录下的头文件才是干活的地方头文件核心接口/类型什么时候必须翻它ivstcomponent.hIComponent、BusInfo、PlugType写总线数量、总线信息、激活、状态存取ivstaudioprocessor.hIAudioProcessor、ProcessData、ProcessSetup写process()、延迟、尾巴、采样精度ivsteditcontroller.hIEditController、ParameterInfo写参数定义、参数显示、界面创建vstspeaker.hSpeakerArr、SpeakerArrangement判断宿主给的是单声道、立体声还是多声道ivstevents.hIEventList、Event写乐器类插件收音符和控制器消息ivstmidicontroller.hIMidiMapping让宿主的 MIDI CC 能映射到你的参数这层不依赖public.sdk意味着你在宿主侧写一个最小加载器时只引这几个头文件就够不用把整个 SDK 拖进去。反过来也成立SDK 里那些现成的基类全都可以不用自己从FUnknown开始实现IComponent完全合法只是工作量大。2.2 public.sdk 是「可以不用的脚手架」public.sdk提供的是参考实现不是硬性要求。它的价值在于把引用计数、总线管理、参数容器这些重复劳动封装好了让样例工程的代码量能压到几百行。三个子目录要分清public.sdk/source/main/模块入口。dllmain.cpp、linuxmain.cpp、macmain.cpp负责导出GetPluginFactory这个宿主唯一会去找的符号pluginfactory.cpp落地了BEGIN_FACTORY_DEF/DEF_CLASS2/END_FACTORY这三个宏背后的工厂实现。public.sdk/source/vst/可以继承的基类。vstaudioeffect.cpp里的AudioEffect、vsteditcontroller.cpp里的EditController、vstsinglecomponenteffect.cpp里的SingleComponentEffect、vstparameters.cpp里的Parameter和RangeParameter。base/source/基础设施。FObject、FString、UString、UBStream这些被上面两层共同引用。编译顺序是base→public.sdk→ 你的插件。漏掉base会在链接阶段出现一堆FUnknown、FObject相关符号未定义。用 g 手工编一版大概长这样g -stdc11 -fPIC -shared -O2 \ -I. -Ipluginterfaces \ -Ipublic.sdk/source/vst \ -Ibase/source \ MyPlugin.cpp \ public.sdk/source/main/linuxmain.cpp \ public.sdk/source/main/pluginfactory.cpp \ public.sdk/source/vst/vstinitiids.cpp \ base/source/baseiids.cpp \ base/source/fobject.cpp \ base/source/fstring.cpp \ -o MyGain.so参数含义很直白-fPIC -shared生成位置无关的动态库-O2放到处理音频的代码路径上会明显影响单块耗时别用-O0测性能。这条命令里的源文件清单是手工挑过的只带了一个插件跑起来必须的那几个链接报未定义符号时把报错里的类名在base/source和public.sdk/source下grep -rn 类名::方法名一遍就能确定该补哪个.cpp。样例工程自带的 makefile 是更可靠的清单来源不确定就以它为准。2.3 以 AGain 为基准判断一个样例工程能不能直接改样例目录里有十来个工程挑错了会走很多冤枉路。先列出来find public.sdk/samples/vst -maxdepth 1 -mindepth 1 -type d | sort在 3.6.14 这一版里最值得当起点的是again。它是一个带界面的增益插件四层结构齐全代码量在一个晚上能读完文件职责换成自己的插件时改不改source/againprocess.h/.cppAudioEffect子类实现IAudioProcessor的process()改核心 DSP 都在这source/againcontroller.h/.cppEditController子类管参数和参数显示改参数表要重写source/againeditor.h/.cppVSTGUI 界面改或砍掉source/again.cpp工厂入口、UID 定义、模块初始化必须改UID 不能撞source/version.h版本字符串改note_expression_synth虽然更完整但它带音符表达和事件处理第一次上手容易被大量事件代码带偏adelay足够小可控制器和界面是残的改完还得自己补。AGain 是唯一一个「四层都在、每层都不长」的工程。把自己插件建在 AGain 上只需要动四个地方again.cpp里两处 UID 必须换成新生成的值同一份 SDK 里两个插件 UID 相同会被宿主当成同一个、工厂宏里传递厂商名和插件名的参数、getBusInfo里的总线名、以及处理类里的 DSP。剩下的骨架可以原样留着。3. 写出第一个能出声的 Processor总线谈判、process 循环与延迟上报process()本身很短难的是它前面那一串协商。宿主不会无条件按你想要的格式调用它先问、你答、谈不拢就降级这条链路走错了process()里拿到的数据和你想的完全不是一回事。这一章按调用顺序把链路走一遍。3.1 setupProcessing 之前的总线谈判宿主加载插件后的调用顺序大致是initialize()→ 查getBusCount()/getBusInfo()→activateBus()→setBusArrangements()→setActive(true)→setupProcessing()→setProcessing(true)→ 反复process()。中间任何一步返回失败后面都不会发生。先看getBusInfotresult PLUGIN_API MyProcessor::getBusInfo (MediaType type, BusDirection dir, int32 index, BusInfo info) { if (type ! kAudio) return kInvalidArgument; // 这个插件不收事件 if (index ! 0) return kInvalidArgument; // 只有一条总线 info.busType kMain; // kMain 表示宿主会自动连上kAux 需要用户手动配 info.channelCount 2; // 这里给的是默认值真正生效的以 setBusArrangements 为准 info.flags BusInfo::kDefaultActive; UString128 (MyGain).copyTo (info.name, 128); return kResultOk; }busType传kMain和kAux直接决定宿主会不会自动把这条总线连到通道上。写效果器时输入和输出都给kMain做成侧链才用kAux。channelCount这里填的是「我默认想要几个声道」后面setBusArrangements才是真正的谈判桌。谈判的实现是这样tresult PLUGIN_API MyProcessor::setBusArrangements (SpeakerArrangement* inputs, int32 numIns, SpeakerArrangement* outputs, int32 numOuts) { if (numIns ! 1 || numOuts ! 1) return kResultFalse; // 只做 1 进 1 出 // 输入输出必须同构避免出现「单声道进立体声出」这种要额外写混音逻辑的情况 if (inputs[0] ! outputs[0]) return kResultFalse; if (inputs[0] ! SpeakerArr::kStereo inputs[0] ! SpeakerArr::kMono) return kResultFalse; // 多声道一律拒绝 // 把谈下来的结果同步到自己的总线对象process() 里才不会按 p a hrefhttps://download.csdn.net/download/momomomo90/12273641 stylecolor:#ec7500;font-size:14px; 本文还有配套的精品资源点击获取 /a img altmenu-r.4af5f7ec.gif srchttps://csdnimg.cn/release/wenkucmsfe/public/img/menu-r.4af5f7ec.gif stylewidth:16px;margin-left:4px;vertical-align:text-bottom;cursor:text; /p

VST3 SDK 3.6.14：目录分层、AGain样例与出声链路

相关推荐

.NET条码识别SDK开发指南与性能优化

Qwen3系列模型性能对比与优化实践

impeccable一词的深度解析：从含义到职场实战，让你的表达无可挑剔

更多资讯

缺少博客内容，无法生成标题

科研答辩PPT设计黄金法则与实战技巧

Pixel MeanFlow：单步生成高质量图像的突破性技术

Mosquitto客户端开发指南：从基础到高级应用

联邦学习模型评估：指标改造与实践指南

ponytail插件实战：样式聚合与CSS变量自动化

今日更新

Agent-Reach：打通大模型触达外部系统的最后一公里

深度学习图像隐写分析实战：从CNN原理到毕设源码全解析

AI赋能知识产权供需匹配：专利评估、需求挖掘与多路召回工程实践

本周精选

防幻觉智能体架构：电源硬件设计中的大模型编排与工具化实践

OpenGL面试核心考点：渲染管线、矩阵变换与性能排查全解析

全国计算机二级C语言真题PDF高效刷题指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？