AudioListener是AudioContext中定义虚拟听者位置、朝向和上方向的只读对象，需配合PannerNode及HRTF模型才能实现3D音频定位；其position、forward、up三组单位向量共同构建空间参考系，缺一不可。
AudioListener 是 AudioContext 中用于定义虚拟听者（listener）空间属性的对象，它不直接“控制”声音源的位置，而是为 PannerNode 等空间化节点提供参考坐标系。要实现 3D 音频定位效果，必须同时设置 AudioListener 的位置/朝向/上方向，并配合 PannerNode 设置声源位置。
1. 获取 AudioListener 实例
每个 AudioContext 自动创建一个 listener 属性，不可替换或重新实例化：
const audioCtx = new (window.AudioContext || window.webkitAudioContext)(); const listener = audioCtx.listener; // 只读属性，直接访问即可
2. 设置听者空间参数（关键三组向量）
AudioListener 通过三组三维向量定义听者在 3D 空间中的姿态：
-
position：听者在世界坐标系中的位置（
x, y, z），默认为(0, 0, 0) -
forward：听者“正前方”指向的单位向量（如
(0, 0, -1)表示朝 Z 轴负方向看） -
up：听者“头顶朝向”的单位向量（如
(0, 1, 0)表示 Y 轴向上）
示例：将听者置于原点，面朝 Z 负方向，Y 轴为上方向：
立即学习“前端免费学习笔记（深入）”；
Wechat Article Html
下载
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
listener.positionX.value = 0; listener.positionY.value = 0; listener.positionZ.value = 0; listener.forwardX.value = 0; listener.forwardY.value = 0; listener.forwardZ.value = -1; listener.upX.value = 0; listener.upY.value = 1; listener.upZ.value = 0;
⚠️ 注意：所有值都需是 单位向量（长度为 1），否则空间计算会失真。例如 forward 若设为 (0, 0, -2) 就不合法。
3. 配合 PannerNode 实现空间音频
AudioListener 单独设置无效，必须与启用空间化的 PannerNode 协同工作：
- 创建 panner 时需指定
panningModel: 'HRTF'（推荐）或'equalpower' - 设置 panner 的
position、orientation、refDistance、maxDistance等参数 - 听者和声源的相对位置/朝向共同决定双耳延迟、频谱变化等效果
简单示例：
const panner = audioCtx.createPanner(); panner.panningModel = 'HRTF'; panner.positionX.value = 1; // 声源在听者右侧 1 单位 panner.positionY.value = 0; panner.positionZ.value = 0; source.connect(panner); panner.connect(audioCtx.destination);
4. 动态更新与注意事项
所有 listener 属性都是 AudioParam 类型，支持自动化（如 setValueAtTime、linearRampToValueAtTime）：
// 平滑移动听者到新位置 listener.positionX.setValueAtTime(0, audioCtx.currentTime); listener.positionX.linearRampToValueAtTime(2, audioCtx.currentTime + 1);
其他要点：
- 浏览器默认禁用自动播放音频，首次触发需由用户手势（如点击）启动
audioCtx.resume() - HRTF 模型依赖系统支持，部分设备（如 Safari iOS）可能回退为
equalpower - 听者朝向影响左右声道判断逻辑，尤其在旋转头部模拟中至关重要
