音频开发 / 系统课时
用 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 必须在点击按钮后恢复或创建,才能符合浏览器的自动播放限制。
<!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>预期结果
点击“开始播放”后可听到持续音调。将滑块从 -1 移到 1,声音会从左侧连续移动到右侧;页面上的数值同步更新。实际设备、耳机与系统声道映射会影响听感,但 pan 参数本身的取值规则不变。
StereoPanner 不是多声道矩阵
StereoPannerNode 适合“一个声音在左右立体声中的位置”这类任务,而不是保留并单独控制 5.1、7.1 等多声道的每一条通道。即使上游来源包含复杂声道信息,声像处理的目标仍是立体声空间,而不是任意声道矩阵。
如果需求是“只衰减第 3 个声道”“把左后声道复制到右后声道”或“重新组合多个独立通道”,应把信号拆成独立通道处理,再按目标顺序合并。此时 ChannelSplitterNode、ChannelMergerNode 或 AudioWorklet 更合适。
什么时候使用声像自动化
角色在屏幕中移动、拖拽对象改变方位或音乐制作中需要连续扫声像时,不要在动画循环里粗暴跳变 pan.value。可以使用 setTargetAtTime()、linearRampToValueAtTime() 等 AudioParam 自动化方法,让参数变化沿音频时间轴执行。
对于静态提示音,直接设置 panner.pan.value 已足够;对于连续运动的空间效果,再考虑自动化曲线或更完整的三维定位节点。