音频处理编程语言【免费下载链接】supercolliderAn audio server, programming language, and IDE for sound synthesis and algorithmic composition.项目地址https://gitcode.com/gh_mirrors/su/supercollider点击查看免费下载SuperCollider 是一个用于声音合成与算法作曲的音频服务器scsynth、编程语言sclang与 IDE 项目。本文基于仓库根目录的 README_WASM.md系统讲解 SuperCollider 的 WebAssemblyWASM移植scsynth 与 sclang 如何被编译进浏览器、它们对外暴露的 JavaScript API、底层源码级实现网络栈移除、WebAudioWorklet 音频驱动、OSC 桥接层、已知限制、开发构建流程与生产部署配置。读完本文你将掌握如何在无安装的浏览器环境中运行 SuperCollider、如何用 JS 与它进行 OSC 通信以及如何从源码构建 wasm 产物并配置带正确 HTTP 头的服务器。一、移植总览在浏览器中运行 SuperColliderWebAssemblywasm被浏览器及其他运行时广泛支持可用同一份二进制在不同平台与处理器架构上获得接近原生的性能。由于几乎所有现代浏览器都内置 WebAssembly 运行时SuperCollider 可以在浏览器中运行而无需任何安装。本仓库已将scsynth音频服务端和sclang语言解释器双双移植到 WebAssembly并通过 JS API 与之交互。二者可以独立使用也可以协同工作由webeditor目标演示。移植的基本思路README_WASM.md 明确说明是移除网络栈。浏览器环境无法创建 socket因此SC_ComPort.cpp被移出编译ReplyAddress结构体移除了boost::asio::ip::address mAddress成员所有 OSC 输入/输出改由 JavaScript 函数提供消息被直接写入 scsynth 的World所有插件plugins以静态链接方式打包。在源码中任何 wasm 相关的修改都由__EMSCRIPTEN__符号守卫见 server/scsynth/CMakeLists.txt 中的EMSCRIPTEN相关配置与各源文件。二、scsynth 的 WASM 版本以 OSC 为核心的 JS 交互2.1 交互模型OSC 消息即Uint8Array与 scsynth 的所有交互都必须通过 OSC 进行。由于浏览器没有网络接口wasm 版 scsynth不重建网络接口而是把 OSC 消息以二进制Uint8Array形式直接通过 JS 函数传给 wasm 中的 scsynth。对应地在 sclang 中可以对数组调用.asRawOSC得到一条 OSC 消息的原始字节在 JS 中可以使用现成的 scsynth JS 客户端或通过脚本把 OSC 通信包装进 WebSocket仓库提供了一套基础的 JS 绑定函数parseOscMessage解析 OSC 消息和对象OscMessage()构建 OSC 消息。2.2 JS API启动参数与默认值wasm 版 scsynth 的 JS API 由 platform/wasm/scsynth.pre.js 提供。核心入口是Module[boot]其参数及默认值如下与底层 server/scsynth/SC_WebAudio.cpp 中ScWebAudioOptions结构体的默认值一致参数默认值含义numInputBusChannels0音频输入总线通道数numOutputBusChannels2音频输出总线通道数realTimeMemorySize8192实时内存大小KB用于分配 synth 及 UGen 自身分配的内存如 CombN 这类不用 buffer 的延迟 UGen与 buffer 内存分离设得过低是 exception in real time: alloc failed 错误的常见原因bufLength64一个控制周期的采样数maxWireBufs64用于 UGen 间互连的最大 wire buffer 数不同于全局采样 Buffer决定可运行时加载的 SynthDef 复杂度上限启动时可自动上调但之后无法再增大numBuffers1024全局采样 buffer 数量maxNodes1024最大节点数maxGraphDefs1024最大 SynthDef 数numAudioBusChannels1024音频速率总线数含输入与输出总线numControlBusChannels16384内部控制速率总线数verbosity0服务器消息详细程度0 为正常-1 抑制信息消息-2 抑制信息和多数错误消息以及 Poll 消息这些参数在 platform/wasm/scsynth.pre.js 中被映射为 C 的Options并调用bootWithOptions。此外还有几个关键的 JS 回调/函数Module[sendOsc]把Uint8Array形式的 OSC 原始字节发送给服务器Module[onPrint]scsynth 向 stdout 输出新行时被调用默认为console.log可覆盖Module[onOscReply]服务器向客户端发送 OSC 回复时被调用注意字节会被释放如需传给 sclang 应复制Module[getAudioContext]/Module[getWorkletNode]获取 scsynth 所用的AudioContext与AudioWorkletNode例如用于接入麦克风。2.3 一个完整的 scsynth 网页示例仓库在 platform/wasm/scsynth/index.html 与 platform/wasm/scsynth/init.js 提供了完整可运行的示例页面原文档提及的示例即对应这一套页面构建后位于wasm-dist中。要点如下import ScSynth from ./scsynth.js; // 创建 scsynth 实例模块默认导出加载 wasm 与 worklet window.scsynth await ScSynth(); // 覆盖回调把 stdout 与 OSC 回复输出到页面控件 scsynth.onPrint (line) { /* ... */ }; scsynth.onOscReply (message) { const oscObject scsynth.parseOscMessage(message); // oscObject.address / oscObject.arguments }; // 用户点击按钮后启动浏览器要求用户手势才能启用音频输出 window.start () { scsynth.boot({ numInputBusChannels: 0, numOutputBusChannels: 2 }); };发送一条 OSC 命令例如播放 synthdef// 用 OscMessage() 构建消息/s_new defname id addAction target const oscMessage new scsynth.OscMessage(); const oscData oscMessage .beginMessage(/s_new).addString(synthDefName).addInt(-1).addInt(1).addInt(0) .endMessage().getData(); oscMessage.delete(); // 手动释放 embind 对象见 emscripten 内存管理文档 scsynth.sendOsc(oscData);发送一个内置的演示 SynthDefgcd由 SC_WebOsc 的 addBlob 打包const gcdDef Uint8Array.from(GCD_SYNTHDEF); // 硬编码的二进制 SynthDef const oscMessage new scsynth.OscMessage(); const data oscMessage.beginMessage(/d_recv).addBlob(gcdDef).endMessage().getData(); oscMessage.delete(); scsynth.sendOsc(data); // 延迟 500ms 再播放因为 synthdef 注册是异步的示例还展示了cmdPeriod发送/g_freeAll 0与麦克风接入通过navigator.mediaDevices.getUserMedia获取音频流再用scsynth.getAudioContext().createMediaStreamSource(stream)连接到scsynth.getWorkletNode()。2.4 scsynth 的已知限制依赖 pthreads 与 SharedArrayBufferscsynth 需要线程间通信因此必须使用SharedArrayBuffer。出于安全原因浏览器只在服务器设置了以下 HTTP 头时才提供该能力Cross-Origin-Embedder-Policy: require-corpCross-Origin-Opener-Policy: same-origin需要用户交互网站必须先获得一次用户手势如点击才能启用音频输出浏览器自动播放策略。不支持加载 Buffer采样缓冲这需要文件系统访问目前未实现预计在未来的版本中支持。未实现任何 Mouse/X11 类 UGen如MouseX、MouseY尽管存在访问鼠标数据的 emscripten 绑定同样预计在未来版本实现。三、源码剖析网络栈移除与 WebAudio 驱动3.1SC_WebOsc.cppOSC 桥接层platform/wasm/SC_WebOsc.cpp 实现了基于仓库已内置的 oscpack 的基础 OSC 构建器与解析器让 JS 端无需额外 OSC 库。由于 embind/JavaScript 无法重载函数与运算符oscpack 依赖运算符重载这里提供了胶水封装OscMessageBuilder类通过OscMessage()暴露给 JSbeginMessage/endMessage、beginBundle/endBundle、addBlob接受 JSUint8Array、addInt、addFloat、addString、getData把内部缓冲复制为 JS GC 拥有的Uint8ArrayparseOscMessage函数parseOscBlobToJs把 JS 的Uint8Array单条消息或 bundle解析为 JS 对象。对 bundle 返回address: #bundlearguments为子消息对象数组对普通消息返回{ address, arguments }参数按类型标签int/float/string/double/true/false/nil/blob转换为对应 JS 值不支持的参数类型输出警告并使用undefined。绑定通过EMSCRIPTEN_BINDINGS(OSC_Helper)导出platform/wasm/SC_WebOsc.cpp并用extern C EMSCRIPTEN_KEEPALIVE void webOscBindingAnchor() {}防止死代码消除把绑定裁掉。该文件在 platform/wasm/CMakeLists.txt 中被编译为静态库webosc链接 oscpack供 scsynth 与 sclang 的 wasm 构建共同使用。3.2SC_WebAudioDriver把 AudioWorklet 当作“伪音频驱动”server/scsynth/SC_WebAudio.cpp 是 wasm 版 scsynth 的主要新增源码核心是SC_WebAudioDriver它把浏览器实时音频环境的AudioWorklet实现为一个“伪音频驱动”由浏览器回调生成接下来 n 个采样。该文件还包含因移除SC_ComPort.cpp而缺失的所有“伪实现”即 JS 侧的 OSC 回复通路使用 emscripten 的 JS↔C 胶水代码全局状态server/scsynth/SC_WebAudio.cppOSC 时间偏移gOSCoffset把 emscripten 的get_now相对时间换算为绝对 NTP-epoch OSC 时间、1 MiB 的 worklet 栈、AudioContext与 worklet 节点句柄供 JS 侧做麦克风接入、打印环形缓冲区大小 0x100000避免日志损坏ScWebAudioOptions结构体与toScWorld()转换函数把 JS 传入的选项映射为内部WorldOptions其中若干选项被硬编码mLoadGraphDefsfalse、mRealTime1、mSharedMemoryID0。此外platform/wasm/scsynth.pre.js 还包含运行时脚手架由于使用 pthreads 且内存可增长堆地址不固定见 WebAssembly 设计 issue #1271每次分配后需要更新缓冲区位置缓存scHeap同时每 20ms 轮询一次 scsynth 的 stdout 环形缓冲Module[nextLine]并转发给onPrint。四、sclang 的 WASM 版本文本与 OSC 双通道4.1 交互模型sclang 的交互经由 OSC 与文本 I/O 进行两者都通过 JS API 暴露所有入站OSC 消息以二进制Uint8Array传给sendOsc所有出站消息通过onOsc回调以Uint8Array接收文本 I/O 通过printCallback/printErrCallback转发emscripten 的print/printErr在运行时不可重赋值因此 platform/wasm/sclang.pre.js 先把它们转发到可在运行时覆盖的回调。与 scsynth 一样所有网络能力都被剥离wasm 不提供 socket 访问。当前的网络 mock 较有限主要面向与scsynth.wasm服务器通信IP 地址与端口的概念已被移除这使得 wasm 构建仅限于单客户端/服务器场景未来可能改变。4.2 底层关键 patch均为__EMSCRIPTEN__守卫README_WASM.md 指出最关键的三处源码修改PyrObject.cpp类库编译不再使用 boost 线程池而是像 Windows 实现那样用std::async——使用线程池曾导致线程池终止问题OSCData.cppwasm 不允许创建 socket因此假定网络 socket 位于127.0.0.1:57120诸如NetAddr.broadcastFlag的操作被 no-opSC_ComPort.h移除所有对 socket 的引用。同时派生于LanguageClient的终端客户端SC_TerminalClient被替换为SC_WasmClient通过 embind 暴露文本与 OSC 的 JS APISC_WebOsc.cpp也加入 sclang 的构建用于构造与解析 OSC 消息。4.3 sclang 的已知限制尚无文件访问待确定与 scsynth、浏览器配合的最佳文件系统方案后才会提供DOM 交互未测试但JS.runCode可以在浏览器主线程中运行 JS 代码从而与 DOM 交互超出服务器范围的 OSCFunc/OSCdef 未实现与服务器的时钟再同步尚未就位。五、webeditor浏览器里的 SC IDE 原型wasm 专属构建目标webeditor是 SC IDE 在浏览器中的原型使用 CodeMirror 5 做代码编辑器把 sclang 与 scsynth 打包在一起作为“如何在 wasm 环境中连接 sclang 与 scsynth”的示例。源码位于 platform/wasm/editor。platform/wasm/editor/init.js 展示了双向桥接的关键代码import ScLang from ./sclang.js; import ScSynth from ./scsynth.js; const scsynth await ScSynth(); const sclang await ScLang(); sclang.bootInterpreter(); // sclang 发出的 OSC 直接送给 scsynth sclang.onOsc (osc) { scsynth.sendOsc(osc); }; // scsynth 的 OSC 回复直接送回 sclang scsynth.onOscReply (oscReply) { sclang.sendOsc(oscReply); };编辑器还实现了sclang 输出的printCallback重定向到页面控制台超过 1000 行时清掉前 500 行、CmdPeriod快捷键Ctrl/Alt/Cmd .执行CmdPeriod.run、基于CodeMirror.defineSimpleMode(scd)的 SuperCollider 语法高亮覆盖关键字、内建符号、数字字面量、类名、symbol、字符串、注释、环境变量等、Ctrl-Enter/Shift-Enter运行光标行/选中区以及bootServer后按需接入麦克风。构建系统在 platform/wasm/CMakeLists.txt 中定义webeditor目标依赖sclang与scsynth后构建阶段把editor/index.html、editor/init.js、LICENSE、dev_server.py、README_WASM.md以及三个产物scsynth.js/scsynth.wasm、sclang.js/sclang.wasm/sclang.data复制到wasm-dist/editor。六、部署正确设置 HTTP 头6.1 本地开发服务器如前所述要让SharedArrayBuffer可用Web 服务器必须返回两个安全相关头。仓库提供了 platform/wasm/dev_server.py 一键启动带必要头的本地开发服务器python dev_server.py # 默认 127.0.0.1:8000 python dev_server.py 8080 # 自定义端口 python dev_server.py 8080 0.0.0.0该脚本基于SimpleHTTPRequestHandler在end_headers中注入Access-Control-Allow-Origin: *、Cross-Origin-Embedder-Policy: require-corp、Cross-Origin-Opener-Policy: same-originplatform/wasm/dev_server.py。README 明确提醒该脚本不应被用来向互联网暴露文件。6.2 生产环境nginx 示例生产环境应使用 nginx 之类的 Web 服务器配置大致如下README_WASM.md 原文示例server { server_name supercollider.dennis-scheiba.com; # Path to the root directory for serving static files root /home/scheiba/supercollider; # URL prefix where the static files are located location / { # Set the default index file index index.html; # Set additional HTTP headers add_header Cross-Origin-Embedder-Policy require-corp; add_header Cross-Origin-Opener-Policy same-origin; types { application/wasm wasm; text/html html; application/javascript js; text/css css; default text/plain; } } listen 80; }注意types块需要为.wasm提供application/wasmMIME 类型。同时SharedArrayBuffer与AudioContext的访问还要求HTTPS 上下文因此需要为域名申请证书如使用 certbot。七、从源码构建 WASM 版本构建 wasm 版本仅用于开发目的普通用户在 Web 中使用 SuperCollider 建议直接使用 CI 构建产物。7.1 安装 emscripten按照 emscripten 官方下载说明安装。假设已克隆emsdk仓库一般步骤如下./emsdk install latest ./emsdk activate latest source ./emsdk_env.sh当前仓库 CI 支持的 emscripten 版本可参考 .github/workflows/build_wasm.yml其中使用mymindstorm/setup-emsdkv16、版本4.0.18。配置完成后可用emcc -v验证。7.2 配置与构建创建一个干净的构建目录例如build-emscripten在其中执行emcmake cmake \ -DSC_ELno \ -DSUPERNOVAno \ -DSC_HIDAPIno \ -DNO_LIBSNDFILEyes \ -DSTATIC_PLUGINSyes \ -DSC_QTno \ -DNO_AVAHIyes \ -DSC_ABLETON_LINKno \ -DCMAKE_BUILD_TYPERelease \ -Wno-dev \ -DNO_X11yes \ -DAUDIOAPIwebaudio \ ..各选项含义禁用 SC 编辑器SC_ELno、supernovaSUPERNOVAno、HIDAPI、Qt、Avahi、Ableton Link 与 X11关闭 libsndfileNO_LIBSNDFILEyes因为无文件系统访问静态链接全部插件STATIC_PLUGINSyes音频 API 选择webaudio。然后构建webeditor目标emmake cmake --build . --target webeditor构建产物含示例会写入你的构建目录/wasm-dist。仓库的 CI.github/workflows/build_wasm.yml也遵循同样的流程配置 →emmake cmake --build . --target webeditor→ 用node sclang-tests.mjs在wasm-dist/sclang目录跑 sclang 求值测试 → 打包wasm-dist.zip并作为 CI artifact 上传。7.3 CLion 开发配置wasm 构建是使用 CLion 开发的CLion 对开源项目免费思路是在 CLion 中创建一个新的EMSDKtoolchainC 编译器使用例如/Users/scheiba/github/emsdk/upstream/emscripten/em调试器用捆绑的 LLDB新增名为Emscripten的 CMake Profile使用该 toolchain且必须使用独立的 build 目录以避免与本地构建冲突需要指定如下环境变量示例EMSDK/Users/scheiba/github/emsdk;EMSDK_NODE/Users/scheiba/github/emsdk/node/22.16.0_64bit/bin/node;EMSDK_PYTHON/Users/scheiba/github/emsdk/python/3.13.3_64bit/bin/python3;SSL_CERT_FILE/Users/scheiba/github/emsdk/python/3.13.3_64bit/lib/python3.13/site-packages/certifi/cacert.pemCMake 选项除前述选项外额外关闭 SSE-DCMAKE_TOOLCHAIN_FILE/Users/scheiba/github/emsdk/upstream/emscripten/cmake/Modules/Platform/Emscripten.cmake -DSC_ELno -DSUPERNOVAno -DSC_HIDAPIno -DNO_LIBSNDFILEyes -DSC_QTno -DNO_AVAHIyes -DSC_ABLETON_LINKno -DCMAKE_BUILD_TYPERelease -Wno-dev -DSSEno -DSSE2no -DNO_X11yes -DAUDIOAPIwebaudio7.4 调试使用-DWASM_DEBUGon标志可生成带调试信息的 wasm 构建可参考 Chrome 官方的 wasm 调试文章用 Chrome DevTools 调试该构建。八、许可证与致谢scsynth与sclang本体采用 GPL-3.0 许可sclang 与 scsynth 的 wasm 绑定采用 AGPL-3.0 许可platform/wasm/LICENSE 随构建产物一同分发。移植历史README_WASM.md 原文scsynth 的 wasm 首个实现由 Hanns Holger RutzSciss编写当前基于 AudioWorklet 的实现未保留其实现代码仅保留了少量 CMake 行演示 SynthDefgcd由 Dennis Scheiba 编写。sclang 由 Dennis Scheiba 移植并大量受益于 Christof Ressi 的评审。赞分享音频处理编程语言【免费下载链接】supercolliderAn audio server, programming language, and IDE for sound synthesis and algorithmic composition.项目地址https://gitcode.com/gh_mirrors/su/supercollider点击查看免费下载相关推荐Wasm3终极移植指南如何将WebAssembly运行时部署到RISC-V架构Wasm3终极移植指南如何将WebAssembly运行时部署到RISC V架构 WebAssemblyWASM作为新一代的通用二进制格式正在改变嵌入式开解释器嵌入式语言运行时终极Nuklear WebAssembly移植指南如何在浏览器中构建原生级GUI体验终极Nuklear WebAssembly移植指南如何在浏览器中构建原生级GUI体验 Nuklear是一款单头文件ANSI C即时模式跨平台GUI库通过WeUI组件嵌入式MicroPython PSOC™ Edge 移植版完全指南环境搭建、固件构建与烧录部署MicroPython PSOC™ Edge 移植版完全指南环境搭建、固件构建与烧录部署 PSOC™ Edge 是英飞凌面向边缘 AI 场景推出的微控制器系列嵌入式语言运行时编程语言解释器编译器物联网系统编程上一篇深入解析 PHPStan 错误标识符 return.deprecatedInterface返回值类型引用已弃用接口的检测与修复下一篇华硕笔记本色彩发灰G-Helper 一键恢复 ICC 配置文件完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
