Godot音频

它在解决什么问题

在 Godot 里让声音响起来很容易，让它响得正确却不容易。典型问题包括：音量滑块拖到一半听起来几乎没变化（因为 volume_db 用的是分贝而非线性值）、同一个 AudioStreamPlayer 被重复触发时短音效被截断、音乐不循环、3D 定位音频完全无声、以及只用 get_playback_position() 做节奏同步时抖动明显。这些坑的根源在于：音频系统运行在对数域，并且按 mix 帧更新，而不是按渲染帧更新。

技能如何工作

该技能把 Godot 4.3+ 的音频管线整理成一条清晰的工作流：

• 选择播放器节点：非定位声音（音乐、UI、全局音效）用 AudioStreamPlayer，3D 定位音频用 AudioStreamPlayer3D。
• 路由到总线：在 Audio 面板定义 Master/Music/SFX 总线，播放器按名称绑定；通过 AudioServer 按总线索引控制音量与静音。
• 用分贝思考：用 linear_to_db / db_to_linear 映射 UI 滑块，并注意 linear_to_db(0.0) 会返回 -inf。
• 节奏同步：结合 get_time_since_last_mix() 补偿 get_output_latency()，而不是只读播放位置。

适用边界

它只覆盖 Godot 引擎内的音频实现。引擎无关的音频设计（自适应音乐结构、混音哲学、ducking 模式）应交给 audio-design；引擎外的资源导入与编码同样不在范围内。