在 Roblox 中实现音频播放、3D 空间声、背景音乐…

适用于 Roblox 引擎内需要播放/混音/空间化音频、实现音乐与 SFX、使用 SoundGroup 或新模块化音频系统的场景。

适用场景

解决思路

1. 选择音频系统：Legacy 用 Sound/SoundGroup/SoundEffect，较简单；新项目优先用模块化 AudioPlayer/AudioEmitter/Wire/AudioDeviceOutput；语音聊天必须用新模块化系统。
2. 放置 Sound 以决定声源类型：作为 BasePart 的子对象 → 体积声；作为 Attachment/MeshPart 的子对象 → 点声源；放在 SoundService/Workspace 下 → 全局声音（BGM/UI）。
3. Legacy 基础播放：创建 Sound；设置 SoundId = rbxassetid://ID、Looped = true、Volume = 0.25；设置 RollOffMode = Enum.RollOffMode.InverseTapered、RollOffMinDistance = 10、RollOffMaxDistance = 100；Parent 到 SoundService；调用 s:Play()。
4. SoundGroups 混音：在 Master 下嵌套 SoundGroup，分别为 Music 和 SFX 建组，使玩家可分别调节音量；将 bgMusic.SoundGroup = musicGroup。
5. 音频效果器：把 ReverbSoundEffect、EqualizerSoundEffect、CompressorSoundEffect 等 parent 到 Sound 或 SoundGroup。
6. 实现 Ducking：在音乐上使用 CompressorSoundEffect，并设置 SideChain = sfxGroup。
7. 新模块化 2D 音频：连接 AudioPlayer → Wire → AudioDeviceOutput。
8. 新模块化 3D 音频：连接 AudioPlayer → Wire → AudioEmitter，并把 AudioEmitter 挂在 Part 上。
9. 控制监听器：Studio/plugin-only 的 SoundService.DefaultListenerLocation 控制默认 listener；运行时控制需显式连接 AudioListener。
10. 一次性 SFX：创建 Sound；设置 SoundId；设置 RollOffMode = Enum.RollOffMode.InverseTapered、RollOffMinDistance = 10、RollOffMaxDistance = 80；Parent 到 parent；调用 Play()；在 Ended:Once 中调用 Destroy()。
11. 预加载音频：调用 ContentProvider:PreloadAsync({sound1, sound2})。
12. 客户端 SFX：服务端用 FireClient → 客户端 OnClientEvent；在客户端创建 invisible Part；再调用 playSFX。
13. 避免服务器音频延迟：对需要即时反馈的声音在客户端播放。
14. 显式设置 RollOffMaxDistance，因为默认值是 10000 studs。
15. 保持 Volume ≤ 1，避免 clipping。
16. 快速连续触发前检查 IsPlaying，避免重复/重叠播放问题。
17. 一次性声音结束后总是 Destroy()。
18. 查阅 references/full.md 获取详细示例、效果表和客户端模式。

适用边界 · 注意事项

• 非 Roblox 平台或非 Roblox 引擎项目不适用。
• 需要语音聊天时，不要只用 legacy Sound/SoundGroup/SoundEffect 管线，必须使用新模块化音频系统。
• 若不需要空间音频、混音或 Roblox 音频对象，仅做纯服务端逻辑等其他功能时无需加载。