音频开发 / 系统课时
用曲线自动化制造动态效果
用曲线自动化制造动态效果
当音量、滤波频率或播放速率需要在一段时间内连续变化时,不应靠高频定时器反复改值。本节用 AudioParam 的指数渐变和自定义曲线直接写入音频时间轴,并说明多个自动化事件如何按时间顺序衔接。
学习目标
- 能用
exponentialRampToValueAtTime()制造听感自然的指数变化 - 能用
setValueCurveAtTime()描述任意参数包络 - 能按自动化事件的时间范围安排顺序,避免重叠和突变
把变化交给 AudioParam 时间轴
AudioParam 不是普通数值属性。调用 setValueAtTime()、exponentialRampToValueAtTime() 或 setValueCurveAtTime() 后,浏览器会把事件加入该参数的自动化时间轴,由音频渲染线程按 AudioContext.currentTime 执行。这样即使主线程短暂忙碌,已经排好的变化仍能按音频时钟推进。
指数渐变适合频率、播放速率等按比例感知更明显的参数。它从前一个自动化事件确定的值开始,持续变化到指定结束时间。起点或目标不要使用 0;需要衰减到静音时,更适合对增益使用线性渐变或自定义曲线。
setValueCurveAtTime(values, startTime, duration) 会把数组中的值均匀铺到给定时段,并在相邻采样点之间插值。它适合一次表达攻击、衰减、起伏等不规则包络。

选择指数渐变还是自定义曲线
如果只知道“从当前值平滑到目标值”,优先使用 ramp;如果已经能描述完整形状,则使用曲线。两者的区别不在于是否平滑,而在于你需要控制多少个中间状态。
| 需求 | 更合适的方法 | 原因 |
|---|---|---|
| 频率从低到高扫过 | exponentialRampToValueAtTime() |
按比例变化,频率听感通常更自然 |
| 音量做一次复杂包络 | setValueCurveAtTime() |
可以直接描述多个中间值 |
| 精确跳到某个起点 | setValueAtTime() |
明确建立后续自动化的起始值 |
同一个 AudioParam 上,事件的时间关系比代码书写位置更重要。尤其是 setValueCurveAtTime() 占用一整段时间区间,不要在曲线尚未结束时再给该参数安排另一个事件,否则可能抛出异常。
完整示例:同时扫频和塑造音量
下面保存为 index.html 后直接在浏览器打开。按钮点击属于用户手势,可用于恢复可能处于 suspended 状态的 AudioContext。示例让滤波器频率做两段指数变化,同时用曲线控制增益包络。
<!doctype html>
<meta charset="utf-8">
<title>AudioParam 曲线自动化</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 = "sawtooth";
osc.frequency.value = 180;
filter.type = "lowpass";
osc.connect(filter).connect(gain).connect(ctx.destination);
// 统一以未来一点的时刻开始,给调度留出余量。
const t0 = ctx.currentTime + 0.05;
filter.frequency.setValueAtTime(300, t0);
filter.frequency.exponentialRampToValueAtTime(4000, t0 + 0.7);
filter.frequency.exponentialRampToValueAtTime(500, t0 + 1.5);
// 曲线覆盖完整的 1.6 秒,期间不再给 gain 插入其他事件。
const envelope = new Float32Array([0, 0.25, 1, 0.7, 0.2, 0]);
gain.gain.setValueCurveAtTime(envelope, t0, 1.6);
osc.start(t0);
osc.stop(t0 + 1.7);
});
</script>预期结果
页面显示“播放动态效果”按钮。点击后约播放 1.7 秒锯齿波:音量先升后降,低通滤波器先快速打开再回落,因此音色会先变亮再变暗。实际起播时间取决于当前 AudioContext.currentTime,因此每次点击得到的绝对时间都不同,但各事件之间的相对间隔保持不变。
安排事件顺序时要守住边界
为 ramp 明确设置起点,可以避免它从未知状态开始。常见写法是先在 t0 用 setValueAtTime() 固定值,再把 ramp 的结束时间安排在 t0 + offset。如果某个参数之前可能已有自动化,还应先取消未来事件,再重新安排新的时间轴。
动态效果稳定的关键不是“更频繁地修改参数”,而是一次把正确的事件序列交给音频时间轴。简单过渡用 ramp,复杂包络用 value curve,并始终先确认起点、结束时间和是否存在重叠事件。