音频开发 / 系统课时
控制空间音频中的监听位置
控制空间音频中的监听位置
当玩家、摄像机或虚拟麦克风在场景中移动时,与其反向修改所有音源,不如更新 AudioListener。监听者定义整个 AudioContext 的听觉位置和朝向,本节用两个固定音源验证监听者移动时的相对空间变化。
学习目标
- 理解
AudioListener与多个PannerNode共享同一空间参考系的关系 - 设置监听者的位置、前向向量和上方向向量
- 通过移动监听者验证多个固定音源的声像变化
一个 AudioContext 只有一个监听者
AudioListener 通过 audioContext.listener 获取,它不是 AudioNode,因此不需要也不能使用 connect()。同一 AudioContext 中的所有 PannerNode 都会基于这个监听者计算方向和距离。

这意味着场景中有十几个固定环境音时,玩家移动通常只需要更新一次监听者位置,而不是为了模拟玩家移动去修改十几个音源坐标。音源仍保存世界坐标,监听者保存玩家或摄像机坐标,二者职责更清楚。
位置与朝向必须一起考虑
监听者位置由 positionX、positionY、positionZ 三个 AudioParam 表示。朝向则由两组向量组成:forwardX/Y/Z 表示面向哪里,upX/Y/Z 表示头顶方向。
例如监听者位于原点、面向负 Z 轴并保持 Y 轴向上时,可以使用前向向量 (0, 0, -1) 和上向量 (0, 1, 0)。如果只更新位置而从不更新朝向,那么角色转身后听觉方向仍可能停留在旧方向。
移动监听者经过两个固定音源
下面创建两个频率不同的固定音源:220 Hz 位于左前方,330 Hz 位于右前方。滑块只修改监听者的 X 坐标,因此可以直接观察“世界中的音源不动,听者移动”产生的变化。
<!doctype html>
<html lang="zh-CN">
<body>
<button id="start">启动音频</button>
<label>
监听者 X 位置
<input id="listenerX" type="range" min="-4" max="4" step="0.1" value="0">
</label>
<script>
const startButton = document.querySelector('#start');
const listenerX = document.querySelector('#listenerX');
let context;
function createSource(ctx, frequency, x, z) {
const oscillator = new OscillatorNode(ctx, { frequency });
const gain = new GainNode(ctx, { gain: 0.04 });
const panner = new PannerNode(ctx, {
panningModel: 'HRTF',
distanceModel: 'inverse',
refDistance: 1,
maxDistance: 50,
rolloffFactor: 1
});
panner.positionX.value = x;
panner.positionY.value = 0;
panner.positionZ.value = z;
oscillator.connect(gain).connect(panner).connect(ctx.destination);
oscillator.start();
}
function updateListenerPosition() {
if (!context) return;
context.listener.positionX.value = Number(listenerX.value);
}
startButton.addEventListener('click', async () => {
if (!context) {
context = new AudioContext();
const listener = context.listener;
listener.positionX.value = Number(listenerX.value);
listener.positionY.value = 0;
listener.positionZ.value = 0;
// 监听者始终面向场景前方,并保持 Y 轴向上。
listener.forwardX.value = 0;
listener.forwardY.value = 0;
listener.forwardZ.value = -1;
listener.upX.value = 0;
listener.upY.value = 1;
listener.upZ.value = 0;
createSource(context, 220, -3, -3);
createSource(context, 330, 3, -3);
}
await context.resume();
});
listenerX.addEventListener('input', updateListenerPosition);
</script>
</body>
</html>预期结果
点击“启动音频”后可以同时听到 220 Hz 和 330 Hz 两个持续音调。
监听者位于 X=0 附近时,两个固定音源分别位于左右前方。
向左移动监听者时,与左侧 220 Hz 音源的相对位置和距离发生变化;向右移动时,与右侧 330 Hz 音源的相对关系发生相反变化。
实际空间感和响度变化会受到播放设备与浏览器空间化实现影响。把监听者接到应用坐标系
真实应用通常在渲染循环或状态更新阶段读取玩家、相机或虚拟麦克风的世界变换,再把位置写入 AudioListener。多个音源则继续把各自的世界坐标写入对应 PannerNode,这样视觉场景和听觉场景使用同一份空间数据。
位置更新频率不必高于画面刷新率。移动连续时可以使用 setValueAtTime() 或 linearRampToValueAtTime() 平滑更新,避免低频状态同步造成突兀跳变。多人或网络场景中,还应使用已经插值后的本地渲染位置,而不是直接把抖动的网络快照写入监听者。
当玩家移动时更新监听者、当场景对象移动时更新各自的 PannerNode,可以保持清晰的世界坐标模型,也能避免随着音源数量增加而重复执行不必要的反向坐标计算。