音频开发 / 系统课时
用时间轴同步多个参数
用时间轴同步多个参数
多个节点如果分别用 setTimeout() 或临时读取时间来触发,主线程抖动会让变化逐渐错位。本节用一次读取的 AudioContext.currentTime 建立共同基准,把音高、滤波频率和增益都安排到同一音频时间轴上。
学习目标
- 能用一个基准时刻安排多个
AudioParam的相对时间 - 能区分音频时间轴调度与主线程定时器触发
- 能为开始、变化和停止事件预留统一的调度余量
只读取一次基准时刻
同步的核心不是让多行 JavaScript 在同一毫秒执行,而是让它们引用同一个音频时刻。常见做法是先计算 const t0 = context.currentTime + lookAhead,然后所有事件都使用 t0 + offset。
currentTime 是 AudioContext 的音频时钟,单位为秒。给 t0 加一个很小的提前量,可以避免代码刚安排完事件时,目标时刻已经落到过去。对于本地交互,几十毫秒通常足以演示这种模式;实际应用应根据启动链路和调度策略确定提前量。
不要为每个参数各自重新计算“现在加 0.5 秒”。虽然同一段同步代码中差异可能很小,但共享基准更容易审查,也能确保后续修改某个偏移量时不会破坏其他参数的关系。

为什么不用 setTimeout 同步声音
setTimeout() 的回调由主线程事件循环调度,页面渲染、脚本计算或后台节流都可能让回调晚到。它适合决定“什么时候去安排下一批音频事件”,但不适合承担需要精确对齐的实际音频边界。
相反,AudioParam 自动化和 AudioScheduledSourceNode.start()、stop() 接收的都是音频时间轴上的绝对时刻。只要事件提前进入时间轴,浏览器就能在目标音频时刻执行,而不是等主线程回调恰好赶到。
因此,多个参数同步时应遵循一个简单原则:主线程负责计算计划,音频时间轴负责执行计划。
完整示例:音高、滤波和增益一起变化
下面的页面在一次按钮点击中创建声音,并以同一个 t0 安排三个参数。音高在 0.8 秒内升高,滤波器先打开再收窄,增益负责淡入和淡出。
<!doctype html>
<meta charset="utf-8">
<title>多参数时间轴同步</title>
<button id="play">播放同步效果</button>
<script>
const ctx = new AudioContext();
document.querySelector("#play").addEventListener("click", async () => {
await ctx.resume();
const osc = ctx.createOscillator();
const filter = ctx.createBiquadFilter();
const gain = ctx.createGain();
osc.type = "triangle";
filter.type = "lowpass";
osc.connect(filter).connect(gain).connect(ctx.destination);
// 所有节点共享这一基准时刻,而不是各自读取 currentTime。
const lookAhead = 0.05;
const t0 = ctx.currentTime + lookAhead;
osc.frequency.setValueAtTime(220, t0);
osc.frequency.exponentialRampToValueAtTime(440, t0 + 0.8);
filter.frequency.setValueAtTime(500, t0);
filter.frequency.exponentialRampToValueAtTime(3500, t0 + 0.4);
filter.frequency.exponentialRampToValueAtTime(900, t0 + 1.0);
gain.gain.setValueAtTime(0, t0);
gain.gain.linearRampToValueAtTime(0.25, t0 + 0.08);
gain.gain.setValueAtTime(0.25, t0 + 0.9);
gain.gain.linearRampToValueAtTime(0, t0 + 1.2);
osc.start(t0);
osc.stop(t0 + 1.25);
});
</script>预期结果
点击“播放同步效果”后,会听到约 1.25 秒的三角波。声音先快速淡入,音高由 220Hz 升到 440Hz;滤波器较早打开,再在尾部收窄;最后音量平滑降到 0。实际绝对时间会随每次点击变化,但 0.08、0.4、0.8、1.0、1.2 秒这些相对偏移始终围绕同一个 t0 对齐。
让同步计划更容易维护
真实应用通常会把一组偏移量定义成节拍或段落边界,例如“起音”“峰值”“释放”。这样修改整体开始时间只需要改变 t0,而修改效果节奏只需要调整相对偏移,不必重写每个节点的绝对时间。
如果用户可能在上一段自动化尚未结束时再次触发同一个长期存活的节点,应先处理旧事件。cancelScheduledValues(time) 会删除该时刻之后的已安排事件;需要取消后保持取消点的瞬时值时,可考虑 cancelAndHoldAtTime(time),再从新的基准时刻继续安排。
多参数同步最终依赖的是同一个时间坐标系:先确定共享 t0,再用相对偏移描述每个事件。这样参数数量增加后,时序仍然可读、可验证,也更不容易受主线程抖动影响。