音频开发 / 系统课时
用 ramp 实现平滑淡入淡出
用 ramp 实现平滑淡入淡出
直接把增益从 0 改成 1,可能在波形任意位置制造突变并产生可闻的 click。更稳妥的做法是把增益变化安排到 AudioContext 的时间轴上,用起点事件和 ramp 让浏览器连续计算中间值。
学习目标
- 用
setValueAtTime()建立自动化起点 - 用
linearRampToValueAtTime()完成淡入和淡出 - 能验证一段基于音频时间轴的平滑增益变化
为什么不要直接跳变增益
gain.value = 1 会把参数改到当前值,而 setValueAtTime() 可以把一个确定值安排在指定的 AudioContext.currentTime 上。对于淡入淡出,先明确起点,再安排结束时间,能让变化脱离主线程定时器抖动,交给音频时间轴执行。([MDN Web Docs][3])
如果音频正在非零振幅处播放,较大的瞬时增益跳变可能形成明显不连续,听起来像 click 或 pop。ramp 的作用就是让增益在一段时间内连续过渡,而不是一次跳到目标值。
用时间轴描述一次淡入淡出
linearRampToValueAtTime(value, endTime) 会从前一个自动化事件的时间和值开始,线性变化到目标值,并在 endTime 到达目标。实际写法通常是先用 setValueAtTime() 锚定起点,再安排一个或多个 ramp。([MDN Web Docs][4])

这类时间安排使用的是音频上下文自己的秒级时钟,不要用 Date.now() 或页面加载时间去计算结束点。每次开始自动化时先读取新的 ctx.currentTime,再基于它加上相对时长。
完整实现一个可听见的淡入淡出
把下面内容保存为一个 HTML 文件并在浏览器中打开。点击按钮后创建振荡器,通过 GainNode 把 440 Hz 音调先从静音淡入,再保持一小段时间,最后淡出到静音。
<button id="play">播放淡入淡出</button>
<script>
const ctx = new AudioContext();
const button = document.querySelector("#play");
button.addEventListener("click", async () => {
// 在点击回调里恢复上下文,满足常见浏览器的自动播放策略。
await ctx.resume();
const oscillator = new OscillatorNode(ctx, { frequency: 440 });
const gain = new GainNode(ctx, { gain: 0 });
oscillator.connect(gain).connect(ctx.destination);
const now = ctx.currentTime;
// 先锚定起点,后续 ramp 才有明确的起始值和时间。
gain.gain.setValueAtTime(0, now);
gain.gain.linearRampToValueAtTime(1, now + 0.5);
gain.gain.setValueAtTime(1, now + 1.0);
gain.gain.linearRampToValueAtTime(0, now + 1.5);
oscillator.start(now);
// stop 前增益已经回到 0,避免在可闻音量处直接截断。
oscillator.stop(now + 1.55);
});
</script>预期结果
点击按钮后会听到 440 Hz 音调在约 0.5 秒内从静音逐渐变响,短暂保持后再在约 0.5 秒内平滑变为静音。页面本身只显示“播放淡入淡出”按钮;实际音量变化由 AudioParam 时间轴完成。
处理实际项目里的边界
如果同一个参数已经排了未来事件,又重新安排一组自动化,旧事件可能继续影响结果。实际交互中应先明确要不要取消旧计划,再重新锚定当前时间点;不要不断追加互相重叠的 ramp。
线性 ramp 适合先建立清晰、可预测的淡入淡出。需要指数变化时可以考虑 exponentialRampToValueAtTime(),但它不能以 0 作为指数 ramp 的当前值或目标值,通常要先降到一个正的小值,再单独设为 0。([MDN Web Docs][5])