音频开发 / 系统课时
组合多个节点实现效果链
组合多个节点实现效果链
浏览器中的音频效果通常不是单个节点完成,而是把滤波、增益、延迟、压缩等处理按顺序连接。本节构建一条可切换节点、可实时调参的效果链,并用明确的连接顺序验证每个节点在链路中的职责。
学习目标
- 用
connect()组织滤波、增益、延迟和压缩节点的串联关系。 - 通过断开并重建连接,实现效果节点的启用与旁路。
- 理解节点顺序为何会改变最终听感,并能用最小步骤验证连接是否正确。
先明确效果链的数据流
一条串联效果链的核心是“前一个节点的输出成为后一个节点的输入”。本例让滤波器先限制频谱,再由增益节点控制电平,然后加入延迟,最后用压缩器约束动态范围。

顺序并非可随意交换。例如先放大再压缩,会让更多信号进入压缩区间;先压缩再放大,则主要改变压缩后的整体电平。因此调试效果链时,先确认连接顺序,再判断参数是否合理。
构建可切换的串联链路
下面的完整页面使用振荡器作为稳定音源。三个复选框决定滤波器、延迟和压缩器是否加入链路,增益节点始终存在;每次切换都会断开旧连接并重新串联当前节点。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>Web Audio 效果链</title>
</head>
<body>
<button id="start">开始播放</button>
<label><input id="filterEnabled" type="checkbox" checked> 滤波</label>
<label><input id="delayEnabled" type="checkbox" checked> 延迟</label>
<label><input id="compressorEnabled" type="checkbox" checked> 压缩</label>
<br>
<label>截止频率 <input id="frequency" type="range" min="300" max="8000" value="1800"></label>
<label>增益 <input id="gain" type="range" min="0.02" max="0.3" step="0.01" value="0.08"></label>
<label>延迟 <input id="delay" type="range" min="0" max="0.5" step="0.01" value="0.15"></label>
<script>
const startButton = document.querySelector('#start');
const filterEnabled = document.querySelector('#filterEnabled');
const delayEnabled = document.querySelector('#delayEnabled');
const compressorEnabled = document.querySelector('#compressorEnabled');
const frequency = document.querySelector('#frequency');
const gainControl = document.querySelector('#gain');
const delayControl = document.querySelector('#delay');
let context;
let source;
let filter;
let gain;
let delay;
let compressor;
function rebuildChain() {
if (!source) return;
// 先移除旧连接,避免多次 connect() 造成并行叠加。
[source, filter, gain, delay, compressor].forEach(node => node.disconnect());
const chain = [source];
if (filterEnabled.checked) chain.push(filter);
chain.push(gain);
if (delayEnabled.checked) chain.push(delay);
if (compressorEnabled.checked) chain.push(compressor);
chain.push(context.destination);
for (let i = 0; i < chain.length - 1; i++) {
chain[i].connect(chain[i + 1]);
}
}
startButton.addEventListener('click', async () => {
context = new AudioContext();
await context.resume();
source = context.createOscillator();
filter = context.createBiquadFilter();
gain = context.createGain();
delay = context.createDelay(1);
compressor = context.createDynamicsCompressor();
source.frequency.value = 220;
filter.type = 'lowpass';
filter.frequency.value = Number(frequency.value);
filter.Q.value = 4;
gain.gain.value = Number(gainControl.value);
delay.delayTime.value = Number(delayControl.value);
compressor.threshold.value = -24;
compressor.ratio.value = 6;
rebuildChain();
source.start();
startButton.disabled = true;
});
[filterEnabled, delayEnabled, compressorEnabled].forEach(control => {
control.addEventListener('change', rebuildChain);
});
frequency.addEventListener('input', () => {
if (filter) filter.frequency.setTargetAtTime(Number(frequency.value), context.currentTime, 0.02);
});
gainControl.addEventListener('input', () => {
if (gain) gain.gain.setTargetAtTime(Number(gainControl.value), context.currentTime, 0.02);
});
delayControl.addEventListener('input', () => {
if (delay) delay.delayTime.setTargetAtTime(Number(delayControl.value), context.currentTime, 0.02);
});
</script>
</body>
</html>预期结果
点击“开始播放”后可听到持续音调。调整截止频率、增益和延迟时间会立即改变声音;取消勾选某个效果后,该节点会从串联链路中被旁路,其他已启用节点继续工作。这里使用 disconnect() 后整体重连,是为了让“是否经过某个节点”保持清晰。生产代码还可以把重连逻辑封装成效果链管理器,避免界面层直接操作大量节点。
调参时先防止音量失控
多个节点串联后,最容易出现的问题不是 API 报错,而是电平累积导致过响或削波。应先把 GainNode 的值保持在较低水平,再逐个加入效果并试听。DynamicsCompressorNode 能限制动态范围,但不能替代合理的增益结构。
如果需要明显的回声,单个 DelayNode 只会把整路信号延后一次;真正的反馈延迟通常还需要把延迟输出经过衰减后回接到延迟输入,并设置安全的反馈增益。本节故意不加入反馈,以保持串联链路的职责清楚。
用旁路定位链路问题
当效果链没有声音或听感异常时,按节点顺序逐个旁路最有效。先确认音源能直达 destination,再依次启用 Gain、Filter、Delay、Compressor;一旦某一步加入后出现静音或异常,就检查该节点的参数与连接。
还要注意一个常见错误:重复调用 connect() 不会自动替换旧连接,可能形成并行路径,让输出比预期更响。本例先对旧链路执行 disconnect() 再重建,就是为了确保任意时刻只有一条明确的串联路径。