Tonejs/Tone.js 是什么？

Tone.js 是浏览器里做交互音乐的老牌框架，最新 15.x 版本把传输、循环和采样器都打磨得相当顺手。但它对音频上下文启动的严格限制，以及单声道合成器的默认设定，决定了它适合谁、不适合谁。

Tonejs/Tone.js 可以商用吗？

可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。

Tonejs/Tone.js 还在维护吗？

在维护。仓库在最近一天内有新的提交。

Tonejs/Tone.js 是用什么编程语言写的？

主要是 TypeScript（依据 GitHub 的语言统计）。

Tone.js 15 评测：Web Audio 框架的调度机制与适用场景

Q: Tonejs/Tone.js 还在维护吗？

在维护。仓库在最近一天内有新的提交。

秒懂

它是什么？: Tone.js 是浏览器里做交互音乐的老牌框架，最新 15.x 版本把传输、循环和采样器都打磨得相当顺手。但它对音频上下文启动的严格限制，以及单声道合成器的默认设定，决定了它适合谁、不适合谁。
适合谁用？: Tone.js 适合那些需要精确节拍调度、愿意学习时间编码体系的 Web 音频开发者，尤其是做音序器、鼓机或交互音乐作品的人。不适合只想要快速播放几个音效、不想理解 AudioContext 启动规则的人，也不适合需要大量复音或复杂采样映射的场合，因为默认合成器是单声道的，PolySynth 需要额外配置。
能商用吗？: 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
还在维护吗？: 在维护。仓库在最近一天内有新的提交。
用什么语言写的？: 主要是 TypeScript（依据 GitHub 的语言统计）。

以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。

开源项目深度解析

Hysen Labs 编辑部 · 2026年8月8日 · Tonejs/Tone.js

为什么浏览器音乐需要专门框架

原生 Web Audio API 能发声，但它的时间模型是低级的。你要自己管理 AudioContext 的时钟，把秒数换算成音符时长，还要手动处理多个音频节点的连接。Tone.js 把这一层抽象掉了。它提供类似数字音频工作站的传输（Transport），可以启停、循环、变速，还有预制的合成器和效果器。这个框架的目标用户很明确：想做交互音乐、但又不想从零搭音频图的开发者。它不解决录音、后期混音这类问题，它解决的是如何在浏览器里精确地安排音符和事件。

传输与回调：精确时间的来源

Tone.js 的核心机制是 Transport 和基于它的调度。Tone.getTransport() 返回全局时间轴，你可以启动、停止、循环它，甚至让 BPM 在运行中变化。关键设计在于回调函数收到的 time 参数。文档明确说 JavaScript 回调不是精确计时的，所以每个循环回调都会收到一个采样级精确的时间值，你必须用这个值去调度音符，而不是依赖回调触发的实际时刻。这个设计很务实，它承认了事件循环的抖动，把精确性交给 Web Audio 的调度机制。Tone.Loop 就是基于这个原理，你设定间隔如 "4n"，它会在每个四分音符触发回调，并把正确的 AudioContext 时间传给你。

时间编码：字符串与秒的换算

Tone.js 的时间系统是它最值得学习的部分。任何接受时间参数的方法，既可以传数字秒数，也可以传字符串。"4n" 代表四分音符，"8t" 是八分音符三连音，"1m" 是一小节。这套编码把音乐术语直接映射到调度逻辑里，省去了手动计算。但这也是个学习曲线，你得先理解这些记号的含义。文档里有一个专门的 Wiki 页面解释 Time 编码，说明它并不简单到一眼就能懂。对新手来说，直接传秒数可能更直观，但一旦你开始做循环和切分音，字符串记法就显示出优势。它让代码读起来像乐谱，而不是一堆浮点数。

启动限制：浏览器策略的硬约束

Tone.js 最容易被忽略的坑是音频启动规则。浏览器不允许网页在用户交互之前播放声音，所以你必须把 Tone.start() 放在点击或按键事件里调用，而且要等它返回的 Promise 解决后再安排任何播放。文档里特别警告：在 AudioContext 运行之前调度或播放音频，会导致静音或错误调度。这不是 Tone.js 的缺陷，是 Web Audio API 的固有限制。但这个约束直接影响你的应用设计：如果你的页面有自动播放的意图，比如加载后自动开始背景音乐，Tone.js 帮不了你，除非你先让用户点一下。对交互音乐来说这不是问题，但对某些场景可能就是障碍。

合成器与复音：默认单声道的取舍

Tone.js 提供多种合成器，包括 Tone.Synth、Tone.FMSynth、Tone.AMSynth 和 Tone.NoiseSynth。这些全是单声道的，一次只能发一个音。文档直接说了这一点。要复音就得用 Tone.PolySynth，它接受一个单声道合成器作为参数，自动处理音符分配。这个设计把复音的实现责任推给开发者，好处是你可以自由选择底层合成器，坏处是如果你忘了包一层 PolySynth，就会得到奇怪的断音效果。triggerRelease 在 PolySynth 里必须指定音符或音符数组，这比单声道版本更繁琐。对只想快速弹个和弦的人来说，这个 API 多了几步思考。

采样播放：Player 与 Sampler 的分工

除了合成，Tone.js 也支持采样播放。Tone.Player 负责加载和播放单个音频文件，比如一个 MP3。它配合 Tone.loaded() 使用，后者返回一个在所有音频文件加载完成后才解决的 Promise，省去逐个监听 onload 事件。Tone.Sampler 则把多个采样组合成乐器，文档在截断处没给完整示例，但可以推断它是为多采样映射设计的。Player 适合简单回放，Sampler 适合构建鼓组或乐器音色。这里有个潜在问题：如果你有大量采样，Tone.loaded() 会等待全部完成，可能拖慢启动。文档没有提供按需加载的策略，所以你可能需要自己拆分加载流程。

版本节奏与升级代价

仓库显示 Tone.js 在 2026 年 7 月发布了 15.1.22，而之前的 14.7.39 停在 2020 年，13.8.25 在 2019 年。版本号跳跃很大，说明 15.x 是一次重大更新。虽然 README 没有列出具体变更，但主版本号变化通常意味着 API 不兼容。如果你从 14 升级到 15，可能需要修改 Transport 相关调用或合成器构造方式。项目采用 MIT 许可，商用没有版权费，但你要自己承担维护成本。依赖 Tree-shaking 的话，Tone.js 的模块化结构应该能帮你只打包用到的部分，但文档没有明确说明这一点。升级前最好查一下 changelog 或迁移指南，仓库里应该有。

替代方案与适用边界

Tone.js 的主要替代是直接使用原生 Web Audio API。区别在于，原生 API 给你 AudioContext、OscillatorNode 和 GainNode，你得自己实现时间调度和音符管理。Tone.js 把这些封装成 Transport 和 Synth 类，但代价是你得接受它的抽象。另一个替代是 p5.js 的 sound 库，它更偏向教育和简单交互，但调度精度和合成器深度不如 Tone.js。Tone.js 的定位是给认真做音乐应用的人，它假设你愿意学习时间编码和传输模型。如果只是想在网页里加个按钮音效，直接写几行原生代码可能更轻量。Tone.js 的正确使用场景是那些需要精确节拍、循环和复杂音序的项目，比如节奏游戏、步进音序器或现场演出工具。

编辑结论

Tone.js 适合那些需要精确节拍调度、愿意学习时间编码体系的 Web 音频开发者，尤其是做音序器、鼓机或交互音乐作品的人。不适合只想要快速播放几个音效、不想理解 AudioContext 启动规则的人，也不适合需要大量复音或复杂采样映射的场合，因为默认合成器是单声道的，PolySynth 需要额外配置。采用前先验证三点：你的目标浏览器是否支持完整的 Web Audio API，你的用户交互流程能否保证 Tone.start() 在点击或按键后调用，以及你需要的采样格式是否能被 Tone.Player 直接加载。Tone.js 的 MIT 许可允许商用，但版本 15 与 14 的 API 差异可能要求你重写部分调度代码，升级前务必对照 changelog。

官方来源

社区笔记