SonoBus 项目架构与核心模块解析

项目架构解析

如何快速掌握 SonoBus 的目录逻辑？从项目根目录出发，核心架构分为五大功能区：Source 目录存放核心业务代码，JUCE 提供跨平台音频框架支持，deps 管理第三方依赖，scripts 包含编译脚本，images 存储界面资源。这种分层设计确保了功能模块的解耦与扩展性。

哪些文件是项目的"骨架"？根目录下的 CMakeLists.txt 定义了整个项目的构建规则，包括源文件组织、依赖库链接和编译选项。而 Source/SonobusPluginProcessor.cpp 和 Source/SonobusPluginEditor.cpp 则分别负责音频处理核心逻辑与用户界面渲染，是理解项目运行机制的关键入口。

核心模块探秘

音频处理流程是如何实现的？Source/SoundboardProcessor.cpp 实现了实时音频流处理，包括声音采样、效果器应用和网络传输控制。配合 Source/ChannelGroup.cpp 中的多通道管理逻辑，确保了低延迟的音频协作体验。

网络通信模块藏在哪里？Source/ConnectView.cpp 处理用户连接状态管理，而 Source/LatencyMeasurer.cpp 则通过 MTDM 算法实现网络延迟检测，这两个模块共同保障了远程协作的稳定性。

配置指南

如何快速编译项目？根目录提供了多个平台的构建脚本：setupcmake.sh 用于 Linux 环境配置，setupcmakewin.sh 针对 Windows 系统，setupcmakexcode.sh 则适用于 macOS。执行对应脚本后，通过 buildcmake.sh 即可完成编译。

第三方依赖如何管理？deps 目录包含所有外部库，其中 deps/ff_meters 提供电平表显示功能，deps/aoo 实现音频优化算法，这些预编译依赖确保了项目的跨平台兼容性。修改依赖版本时，需同步更新根目录的 CMakeLists.txt 配置。