该技能面向在 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 个基础波形与调制。
- 定义事件到音色的映射。
- 让连击、速度、危险或难度至少对一种事件产生可听的调制。
- 通过小型音频职责模块实现。
- 阅读 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。关于收费、价格、平台、效果等具体信息,资料中暂未提供。