音频开发 / 系统课时

组合多个节点实现效果链

组合多个节点实现效果链

浏览器中的音频效果通常不是单个节点完成,而是把滤波、增益、延迟、压缩等处理按顺序连接。本节构建一条可切换节点、可实时调参的效果链,并用明确的连接顺序验证每个节点在链路中的职责。

学习目标

  • 用 connect() 组织滤波、增益、延迟和压缩节点的串联关系。
  • 通过断开并重建连接,实现效果节点的启用与旁路。
  • 理解节点顺序为何会改变最终听感,并能用最小步骤验证连接是否正确。

先明确效果链的数据流

一条串联效果链的核心是“前一个节点的输出成为后一个节点的输入”。本例让滤波器先限制频谱,再由增益节点控制电平,然后加入延迟,最后用压缩器约束动态范围。

滤波、增益、延迟与压缩器组成的串联效果链

顺序并非可随意交换。例如先放大再压缩,会让更多信号进入压缩区间;先压缩再放大,则主要改变压缩后的整体电平。因此调试效果链时,先确认连接顺序,再判断参数是否合理。

构建可切换的串联链路

下面的完整页面使用振荡器作为稳定音源。三个复选框决定滤波器、延迟和压缩器是否加入链路,增益节点始终存在;每次切换都会断开旧连接并重新串联当前节点。

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

预期结果

text
点击“开始播放”后可听到持续音调。调整截止频率、增益和延迟时间会立即改变声音;取消勾选某个效果后,该节点会从串联链路中被旁路,其他已启用节点继续工作。

这里使用 disconnect() 后整体重连,是为了让“是否经过某个节点”保持清晰。生产代码还可以把重连逻辑封装成效果链管理器,避免界面层直接操作大量节点。

调参时先防止音量失控

多个节点串联后,最容易出现的问题不是 API 报错,而是电平累积导致过响或削波。应先把 GainNode 的值保持在较低水平,再逐个加入效果并试听。DynamicsCompressorNode 能限制动态范围,但不能替代合理的增益结构。

如果需要明显的回声,单个 DelayNode 只会把整路信号延后一次;真正的反馈延迟通常还需要把延迟输出经过衰减后回接到延迟输入,并设置安全的反馈增益。本节故意不加入反馈,以保持串联链路的职责清楚。

用旁路定位链路问题

当效果链没有声音或听感异常时,按节点顺序逐个旁路最有效。先确认音源能直达 destination,再依次启用 Gain、Filter、Delay、Compressor;一旦某一步加入后出现静音或异常,就检查该节点的参数与连接。

还要注意一个常见错误:重复调用 connect() 不会自动替换旧连接,可能形成并行路径,让输出比预期更响。本例先对旧链路执行 disconnect() 再重建,就是为了确保任意时刻只有一条明确的串联路径。

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

目录与阅读设置

阅读设置

17

记录一个想法

组合多个节点实现效果链

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

登录哪都通