最后同步日期：2026-04-15 | Godot 官方原文 — Audio

音频

音频是游戏的声音系统。Godot 提供了三种音频播放器，区别在于声音有没有"位置感"。

想象一下你在看电影：

• 没有位置感：背景音乐（BGM）无论你站在哪里都一样大——这就是 AudioStreamPlayer
• 2D 位置感：画面里左边有个人在说话，声音就从左边的音箱出来——这就是 AudioStreamPlayer2D
• 3D 位置感：你戴着耳机在 3D 游戏里转身，身后传来脚步声，你真的感觉声音在背后——这就是 AudioStreamPlayer3D

类型	位置感	典型用途
AudioStreamPlayer	无	BGM、UI 音效
AudioStreamPlayer2D	2D 位置	2D 射击音效、脚步声
AudioStreamPlayer3D	3D 位置	3D 爆炸声、NPC 说话

节点继承关系图

下面这张图展示了音频相关节点之间的"家族关系"——箭头从父类指向子类，表示"谁派生出谁"：

---

节点列表

节点	描述	频率
AudioStreamPlayer	非定位音频播放器	★★★
AudioStreamPlayer2D	2D 位置音频播放器	★★
AudioStreamPlayer3D	3D 位置音频播放器	★★
AudioListener2D	2D 音频监听器	★
AudioListener3D	3D 音频监听器	★

提示

大多数情况不需要手动添加 AudioListener，因为 Camera2D/3D 默认自带。

---

节点选择指南

不知道该用哪个音频节点？跟着下面的流程图走一遍就知道了：

---

常见场景搭配

音频节点负责游戏中的所有声音。下面按具体场景逐一展示典型的节点搭配结构。

背景音乐（BGM）

全场景统一的背景音乐，没有位置感。AudioStreamPlayer 播放 BGM，音量不受角色位置影响。

2D 射击音效

2D 游戏中子弹发射、爆炸等需要位置感的音效。AudioStreamPlayer2D 挂在子弹/角色上。

3D 环境音效

3D 游戏中的环境声（流水、鸟叫）和 NPC 说话。AudioStreamPlayer3D 挂在音源位置。