SuperAPI AI 工具集

godot-audio-systems

编程与开发

查看项目

更新于 10-15 18:28

技能介绍

用途

本技能面向 Godot 引擎的音频系统开发,提供混音、空间音频、音频池化与交互式音乐的专家级实现模式。适用于音乐系统、音效、空间音频以及音频驱动玩法的构建。

主要能力

  • 播放器选型:区分 AudioStreamPlayer(全局,用于音乐、UI、语音)、AudioStreamPlayer2D(2D 平移)、AudioStreamPlayer3D(3D 定位,支持多普勒与衰减)的适用场景与性能差异。
  • 总线架构:Master 仅用于最终限幅,游戏音频路由至 Music / SFX / UI / Voice 子总线;提供运行时总线音量与静音辅助。
  • 动态效果:混响、EQ、压缩、限幅等总线效果链,用于闪避与环境区域。
  • 音频池化:优先级语音池(可抢占最低优先级最旧语音,保护主角语音)、相同音效并发上限(防止削波失真)。
  • 音乐过渡:0.5–2.0 秒 Tween 交叉淡入淡出或 BPM 对齐切换;支持垂直分层(AudioStreamSynchronized)与水平片段图(AudioStreamInteractive)自适应配乐。
  • 空间音频:衰减模型、多普勒、遮挡闷音(射线检测降低衰减滤波截止频率)、环境混响区域。
  • 程序化音频:实时生成嗡鸣、引擎、信号音。
  • 音频驱动玩法:FFT 频谱驱动视觉或玩法;字幕与播放位置精确同步(含延迟补偿)。

使用方式

技能以脚本目录形式组织,按需求选择对应脚本:一次性音效与语音抢占使用 audio_voice_pool_manager.gd;相同音效并发上限使用 audio_voice_limiter_manager.gd;对话压过音乐使用 audio_bus_ducker_logic.gd;总线布局与运行时静音使用 audio_bus_manager.gd;线性 UI 滑块转 dB 使用 audio_linear_volume_interpolator.gd;墙体闷音使用 audio_occlusion_raycast.gd;房间混响区域使用 audio_environmental_reverb_zone.gd;垂直强度分层使用 audio_interactive_music_manager.gd;水平片段图使用 interactive_music_graph.gd;自适应音乐包装使用 audio_adaptive_music_player.gd;Autoload 音效入口使用 audio_manager.gd;脚步表面音效库使用 audio_footstep_surface_selector.gd;程序化合成使用 audio_procedural_generator_synth.gd;频谱驱动视觉使用 audio_reactive_visualizer_component.gd 与 audio_visualizer.gd;字幕同步使用 subtitle_sync_system.gd。

适用场景

  • 需要音乐、音效、空间音频或音频驱动玩法的 Godot 项目。
  • 需要总线混音、动态效果、音频池化或交互式音乐过渡的游戏。

限制

  • 技能内容为专家规则与脚本目录,具体实现细节需参考对应脚本与参考文档。
  • 部分脚本被标注为强制使用(MANDATORY),需按对应场景选用。
  • 官方文档与相关技能链接需按需查阅,不应预加载全部内容。