SuperAPI AI 工具集

creating-godot-procedural-audio

编程与开发

查看项目

更新于 10-15 10:15

技能介绍

该技能面向在 Godot 项目内部合成音频的场景,即程序化音频(procedural audio)的设计与实现。

用途: 用于在 Godot 项目中于运行时生成音效,使用 Godot 内置音频 API,并将游戏事件映射到相应音色。

产物与边界:

  • 若已知项目目录,将完整音频方案写入 <PROJECT_DIR>/SOUND_DESIGN.md。
  • 保留现有 README 中 Visual And Audio Direction 或 Required sounds 部分为简短摘要,仅在方向变化时更新。
  • 通过项目专属的小型模块(例如 <PROJECT_DIR>/audio_controller.gd)实现,main.gd 仅作编排。
  • 复用模板已有的 audio_synth.gd,或相对于已加载技能解析 assets/audio_synth.gd;仅当辅助文件缺失或实质不同时才复制。
  • 将不熟悉的项目/概念视觉标签映射到最接近的材质、几何、运动或氛围族,并在 SOUND_DESIGN.md 中记录该映射。
  • 连续音应暴露最小控制接口:start_<sound>()、update_<sound>(params)、release_<sound>()、stop_<sound>()。无头/空操作句柄必须保留相同调用,以便测试在不播放的情况下验证状态转换。

规则:

  • 使用 Godot 内置音频;外部文件需项目明确许可。
  • 在同一游戏内保持事件族语义稳定:得分、危险、伤害和状态变化应具有不同的音色身份。
  • 在不同游戏之间变化波形、音高、包络、调制、节奏和密度;不要复用全局的提示音词汇。
  • 优先使用生成的采样流;仅在需要实时合成时使用 AudioStreamGenerator。

工作流程:

  1. 从机制和视觉方向推导声音特征。
  2. 选择 1–2 个基础波形与调制。
  3. 定义事件到音色的映射。
  4. 让连击、速度、危险或难度至少对一种事件产生可听的调制。
  5. 通过小型音频职责模块实现。
  6. 阅读 references/sound-design-guide.md 获取事件目录、合成模式和检查项。可复用原语位于 assets/audio_synth.gd。

配套技能:

  • directing-game-visuals 生成 <PROJECT_DIR>/VISUAL_DESIGN.md,声音特征应从中推导。
  • scaffolding-godot-mini-games 提供上述模板 audio_synth.gd;仅当项目中没有模板副本时,才复制本技能的 assets/audio_synth.gd。

适用场景: 适用于在 Godot 项目中需要运行时生成音效、将游戏事件映射到音色、为连续音提供统一控制接口,以及需要在不播放音频的情况下验证状态转换的测试场景。

限制: 必须使用 Godot 内置音频,外部文件需项目明确许可;实时合成仅在必要时使用 AudioStreamGenerator。关于收费、价格、平台、效果等具体信息,资料中暂未提供。