SuperAPI AI 工具集

roblox-audio

测试与质量

查看项目

更新于 10-15 16:16

技能介绍

用途:在 Roblox 中搭建或调试音乐、空间音频、音效、文本转语音(TTS)和语音转文字(STT),处理音频图、资产权限与播放问题。

两套系统:现代音频图是官方推荐的新项目路径,由模块化实例组成,用 Wire 连接(SourceInstance→TargetInstance)。核心对象含 AudioPlayer(按资产 ID 产生流)、AudioEmitter(3D 发射点)、AudioListener(拾取)、AudioDeviceOutput(硬件输出)、AudioDeviceInput(麦克风)、AudioTextToSpeech、AudioSpeechToText。效果对象包括 AudioEqualizer、AudioCompressor、AudioReverb、AudioChorus、AudioDistortion、AudioEcho、AudioFlanger、AudioPitchShifter、AudioTremolo、AudioFader、AudioAnalyzer。传统 Sound/SoundGroup/SoundEffect 仍可用但不再推荐,简单 2D 音效或一次性 UI 声音可用 Sound,无需重写可用的旧代码。

用法要点:2D 音频需 AudioPlayer→Wire→AudioDeviceOutput,均挂在 SoundService 下;3D 音频需把 AudioEmitter 挂在 3D 部件上,并用 SoundService.ListenerLocation 设为 Camera 或 Character。发射位置由父对象位置决定,AudioEmitter 忽略自身朝向。DistanceAttenuation 是 NumberSequence 曲线,仅当 DistanceAttenuationMode 为 Custom 时生效;预设模式改用 DistanceAttenuationBounds。可通过 SetAngleAttenuation 设置角度衰减。声学模拟需开启 SoundService.AcousticSimulationEnabled 及发射器/监听器的 AcousticSimulationEnabled。

TTS/STT:AudioTextToSpeech 每次请求文本不超过 300 字符,VoiceId 有各语言编号(如 501/502 为中文);AudioSpeechToText 需 VoiceChatService.UseAudioApi = Enabled,并自动检测 17 种语言。

限制与注意:播放与效果在客户端执行,服务端不混音;游戏性判定不可信任客户端音频状态。并发声音数有上限,移动端明显更低;混响与声学模拟开销重,低配设备可能降级。跨创作者音频资产可能受权限限制而无法播放。可预加载音频以避免首次播放卡顿。