音频开发 / 系统课时

用曲线自动化制造动态效果

用曲线自动化制造动态效果

当音量、滤波频率或播放速率需要在一段时间内连续变化时,不应靠高频定时器反复改值。本节用 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。示例让滤波器频率做两段指数变化,同时用曲线控制增益包络。

html
<!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>

预期结果

text
页面显示“播放动态效果”按钮。点击后约播放 1.7 秒锯齿波:音量先升后降,低通滤波器先快速打开再回落,因此音色会先变亮再变暗。

实际起播时间取决于当前 AudioContext.currentTime,因此每次点击得到的绝对时间都不同,但各事件之间的相对间隔保持不变。

安排事件顺序时要守住边界

为 ramp 明确设置起点,可以避免它从未知状态开始。常见写法是先在 t0 用 setValueAtTime() 固定值,再把 ramp 的结束时间安排在 t0 + offset。如果某个参数之前可能已有自动化,还应先取消未来事件,再重新安排新的时间轴。

动态效果稳定的关键不是“更频繁地修改参数”,而是一次把正确的事件序列交给音频时间轴。简单过渡用 ramp,复杂包络用 value curve,并始终先确认起点、结束时间和是否存在重叠事件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用曲线自动化制造动态效果

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通