SuperAPI AI 工具集

roblox-audio

通用与其它

查看项目

更新于 10-16 09:41

技能介绍

用途 本技能适用于在 Roblox 中实现音频相关功能,包括音频播放、空间/3D 声音、背景音乐、音效、音频混合(SoundGroups)以及动态音效。当需要添加、更改或修复 Roblox 音频时使用。资料说明其同时覆盖旧版 Sound 对象体系和较新的模块化 AudioPlayer/Wire 体系。

体系选择 资料指出存在两套体系:旧版(Sound/SoundGroup/SoundEffect)更简单;新版模块化(AudioPlayer/AudioEmitter/Wire/AudioDeviceOutput)在新项目中更受推荐,并且是语音聊天所必需的。

声音放置位置 BasePart 的子对象为体积声源;Attachment/MeshPart 为点声源;SoundService/Workspace 下为全局声音(用于背景音乐或 UI)。

旧版设置 示例代码创建一个 Sound,设置 SoundId 为 rbxassetid://ID,Looped 为 true,Volume 为 0.25,RollOffMode 为 Enum.RollOffMode.InverseTapered,RollOffMinDistance 为 10,RollOffMaxDistance 为 100,随后挂载到 SoundService 并调用 Play()。

SoundGroups(混音器) 将 SoundGroup 嵌套在 Master 之下,可实现玩家可调节的音乐与音效音量;通过 bgMusic.SoundGroup = musicGroup 进行分配。效果器(ReverbSoundEffect、EqualizerSoundEffect、CompressorSoundEffect 等)挂载到 Sound 或 SoundGroup 上。闪避(Ducking)做法:在音乐上使用 CompressorSoundEffect 并将 SideChain 设为 sfxGroup。

新版模块化 2D 路径:AudioPlayer → Wire → AudioDeviceOutput。3D 路径:AudioPlayer → Wire → AudioEmitter(挂在 Part 上)。仅 Studio/插件的 SoundService.DefaultListenerLocation 控制默认监听器;运行时控制需显式连接 AudioListener。

一次性音效 资料提供一个 playSFX 函数:创建 Sound,设置 SoundId,RollOffMode 为 InverseTapered,RollOffMinDistance 为 10,RollOffMaxDistance 为 80,挂载到父对象并 Play(),在 Ended:Once 中 Destroy()。预加载使用 ContentProvider:PreloadAsync({sound1, sound2})。客户端音效通过 FireClient → OnClientEvent 创建不可见 Part 并调用 playSFX。

常见坑点 服务器端声音存在延迟,因此反馈音效应在客户端播放。默认 RollOffMaxDistance=10000 studs,需显式设置。Volume 大于 1 会削波。快速连发时检查 IsPlaying。一次性音效务必在 Ended 后 Destroy()。

更多细节 资料提示参见 references/full.md 获取详细示例、效果器表格和客户端模式。

限制 资料未提供收费、价格、适用平台、性能数据或具体版本要求等信息。