音频开发 / 系统课时

用 StereoPanner 调整左右声道

用 StereoPanner 调整左右声道

StereoPannerNode 用一个 pan 参数控制声音在左右声道中的位置,适合做角色方位、界面提示音或简单立体声移动。本节用可运行示例试听从左到右的变化,并说明它与多声道独立路由的边界。

学习目标

  • 理解 pan 在 -1、0、1 等典型取值下的听感和声道含义。
  • 在用户交互后创建 AudioContext,并实时修改 StereoPannerNode 的 pan。
  • 判断何时应改用 ChannelSplitterNode、ChannelMergerNode 等多声道路由节点。

pan 控制的是声像位置

StereoPannerNode 位于音源与后续节点之间。pan 的常用范围是 -1 到 1:-1 偏向左声道,0 位于中央,1 偏向右声道。它采用等功率声像规则,因此中央位置不是简单把左右各乘以固定的线性比例,而是尽量避免移动过程中出现明显的总体响度塌陷。

pan 值 听感 典型用途
-1 最左 左侧提示、左方角色
0 居中 默认音乐、对白
1 最右 右侧提示、右方角色

当你只是要表达“这个声音来自左边还是右边”时,StereoPannerNode 通常比手工拆分声道更直接。

在浏览器中实时调整声像

下面的页面使用振荡器产生持续音调,通过滑块实时修改 pan。AudioContext 必须在点击按钮后恢复或创建,才能符合浏览器的自动播放限制。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>StereoPanner 示例</title>
</head>
<body>
  <button id="start">开始播放</button>
  <label>
    pan:
    <input id="pan" type="range" min="-1" max="1" step="0.01" value="0">
    <span id="value">0.00</span>
  </label>

  <script>
    const startButton = document.querySelector('#start');
    const panSlider = document.querySelector('#pan');
    const valueLabel = document.querySelector('#value');

    let context;
    let panner;

    startButton.addEventListener('click', async () => {
      context = new AudioContext();
      await context.resume();

      const oscillator = context.createOscillator();
      const gain = context.createGain();
      panner = context.createStereoPanner();

      oscillator.frequency.value = 440;
      gain.gain.value = 0.08; // 控制试听音量,避免振荡器过响
      panner.pan.value = Number(panSlider.value);

      oscillator.connect(gain).connect(panner).connect(context.destination);
      oscillator.start();

      startButton.disabled = true;
    });

    panSlider.addEventListener('input', () => {
      const value = Number(panSlider.value);
      valueLabel.textContent = value.toFixed(2);

      if (panner && context) {
        // 在当前音频时间点平滑逼近目标值,减少突变产生的听感跳跃
        panner.pan.setTargetAtTime(value, context.currentTime, 0.015);
      }
    });
  </script>
</body>
</html>

预期结果

text
点击“开始播放”后可听到持续音调。将滑块从 -1 移到 1,声音会从左侧连续移动到右侧;页面上的数值同步更新。

实际设备、耳机与系统声道映射会影响听感,但 pan 参数本身的取值规则不变。

StereoPanner 不是多声道矩阵

StereoPannerNode 适合“一个声音在左右立体声中的位置”这类任务,而不是保留并单独控制 5.1、7.1 等多声道的每一条通道。即使上游来源包含复杂声道信息,声像处理的目标仍是立体声空间,而不是任意声道矩阵。

如果需求是“只衰减第 3 个声道”“把左后声道复制到右后声道”或“重新组合多个独立通道”,应把信号拆成独立通道处理,再按目标顺序合并。此时 ChannelSplitterNode、ChannelMergerNode 或 AudioWorklet 更合适。

什么时候使用声像自动化

角色在屏幕中移动、拖拽对象改变方位或音乐制作中需要连续扫声像时,不要在动画循环里粗暴跳变 pan.value。可以使用 setTargetAtTime()、linearRampToValueAtTime() 等 AudioParam 自动化方法,让参数变化沿音频时间轴执行。

对于静态提示音,直接设置 panner.pan.value 已足够;对于连续运动的空间效果,再考虑自动化曲线或更完整的三维定位节点。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 StereoPanner 调整左右声道

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

登录哪都通