4.9 KiB
4.9 KiB
obs-audio-waveform-dock
OBS Studio 插件:在主窗口右侧增加「音频频谱监视」面板,实时分析 选定音频输入源 与 主输出(Master / Program Mix) 的频谱,并可切换为波形显示;同时保留 OBS 原版的音频快速设置(监听 / 电平 / 滤镜)。
功能
-
双路实时频谱
- 上方:下拉框选择的音频输入源(麦克风、桌面音频、媒体源、采集卡音频等)。
- 下方:主输出(所有音频轨道混音后的 Program Mix,
obs_add_raw_audio_callback(0, ...))。 - 8192 点 Hann 窗 FFT,20 Hz ~ 20 kHz 对数频率轴,-90 ~ 0 dB 幅度显示;带峰值频率标记与实时读数(如
439 Hz)。 - 输入源按源音量/静音加权,和 OBS 混音器电平表一致。
-
波形模式
- 同一面板可在「频谱 / 波形」之间切换,波形按逐像素 min/max 包络滚动显示最近 3 秒,并显示峰值 / RMS 与电平表。
-
保留原版快速设置
- 监听(与混音器耳机按钮等价,调用
obs_source_set_monitoring_enabled;OBS 33 起监听为开关式)。 - 静音 开关。
- 电平/音量 滑杆(-60.0 dB ~ 0.0 dB),与源音量双向同步。
- 滤镜 按钮:直接打开 OBS 原生滤镜窗口,增益、压缩器、限制器、噪声门、EQ 等原版滤镜全部可用。
- 在显示区域 右键:监听 / 静音 / 音量重置 0 dB / 滤镜 / 属性。
- 监听(与混音器耳机按钮等价,调用
-
自动记住上次选择的输入源与显示模式(写入当前 OBS 配置文件);源被删除时自动回退;无记录时优先选择「桌面音频」。
-
面板启动后自动停靠在右侧,也可从 视图 → 停靠窗口(Docks) 中开关。
安装
- 退出 OBS。
- 以管理员身份运行
scripts/install.ps1:
powershell -ExecutionPolicy Bypass -File scripts\install.ps1
脚本会把以下文件复制到 OBS 安装目录(默认 C:\Program Files\obs-studio):
obs-plugins/64bit/audio-waveform-dock.dll
data/obs-plugins/audio-waveform-dock/locale/{en-US,zh-CN}.ini
也可以手动复制 dist/audio-waveform-dock.dll 与 data/ 目录到对应位置。
卸载:scripts\uninstall.ps1。
从源码构建(Windows)
依赖:
- Visual Studio 2022 Build Tools(MSVC v143 + Windows 10/11 SDK)
- Qt 6.10.x(或任意 Qt 6.9+)MSVC 2022 64-bit,仅需 Core/Gui/Widgets
- CMake ≥ 3.28、Ninja、Python 3(
pip install pefile) - obs-studio 33.0.0 源码(只使用头文件,不需要编译 OBS)
# 1) 从已安装 OBS 的 DLL 导出表生成 obs.lib / obs-frontend-api.lib
powershell -ExecutionPolicy Bypass -File scripts\gen-obs-libs.ps1 `
-ObsPath "C:\Program Files\obs-studio" `
-OutDir "D:\dsh-build\obs-libs"
# 2) 编译
powershell -ExecutionPolicy Bypass -File scripts\build.ps1 `
-ObsSource "D:\dsh-build\obs-studio-33" `
-ObsLibs "D:\dsh-build\obs-libs" `
-QtRoot "D:\Qt\6.10.3\msvc2022_64" `
-VsPath "D:\VS\BuildTools"
产物:build\bin\audio-waveform-dock.dll。
实现说明
- 输入源音频:
obs_source_add_audio_capture_callback(滤波后、推子前的 float planar,插件按源音量/静音加权显示);源通过obs_weak_source_t持有,切换/删除/退出时注销回调。 - 主输出音频:
obs_add_raw_audio_callback(0, conversion, ...),mix 0 即主混音,转换请求为 48 kHz / float planar / stereo。 - 频谱:对两路音频分别做 8192 点 Hann 窗 radix-2 FFT(单声道混合),按对数频率映射到像素列,峰值快速起、55 dB/s 缓慢回落;峰值频率由最大幅度 bin 计算。
- 监听:OBS 33 将三态监听合并为开关,
obs_source_set_monitoring_type已废弃,插件使用obs_source_set_monitoring_enabled保持与原版一致。 - 滤镜:
obs_frontend_open_source_filters打开 OBS 原生滤镜窗口,不重新实现滤镜 UI。 - 停靠:等待 OBS 恢复完布局后,通过
toggleViewAction()显示,再setFloating(false)停靠到右侧;不对已由 OBS 管理的 Dock 再次调用addDockWidget()(会破坏 Qt 布局并导致启动崩溃)。 - 编译期通过
third_party/obsconfig/obsconfig.h提供 obs-studio 配置头,避免依赖完整的 OBS 构建树。
兼容性
- 在 OBS Studio 33.0.0(Windows x64,Qt 6.11.1 runtime)上构建并实测:
- 面板加载、自动停靠;
- 440 Hz 测试音在输入源与主输出频谱中均正确显示峰值频率(439 Hz)与幅度;
- 频谱/波形模式切换;
- 监听开关、音量同步、原生滤镜窗口均正常;
- 连续多次启动稳定性测试通过。
- 插件使用 Qt 6.10.3 开发包编译,依赖 Qt 6 的二进制向前兼容,在 OBS 自带的 Qt 6.11.1 下运行正常。
- 仅支持 64 位 OBS。


