Split game module documentation

2026-06-09 23:11:08 +08:00
parent d41f9d1096
commit 0257c8058e
15 changed files with 647 additions and 88 deletions
@@ -0,0 +1,53 @@
+# Audio and Save
+
+## 职责
+
+音频和存档模块负责调用引擎已有 `Sound`、`Music`、`AudioDatabase` 和 `SaveSystem`。
+
+主要源码：
+
+- `game/src/core/game_audio.*`
+- `game/src/core/game_save.*`
+- `game/src/core/game_services.*`
+
+## 音频
+
+`GameAudio` 支持：
+
+- `PlaySoundCue(cueId)`
+- `PlayMusicCue(cueId)`
+
+路径解析优先级：
+
+```text
+AudioDatabase cue
+  -> assets/sounds/<cue>.wav
+  -> assets/music/<cue>.ogg
+```
+
+当前已接入 cue：
+
+- `stage_01`
+- `player_jump`
+- `player_attack`
+- `battle_zone_enter`
+
+缺音频资源时直接跳过，不影响场景运行。
+
+## 存档
+
+`GameSave` 当前用 `SaveSystem` slot `0` 保存 debug overlay 开关。
+
+保存内容：
+
+- debug 总开关。
+- 碰撞/网格显示。
+- 玩家包围盒。
+- battle zone/camera bounds。
+- spawn point。
+
+## 下一步
+
+- 正式设置、进度、角色成长继续走 `SaveSystem`。
+- 正式音频资源到位后补 `assets/audio/audio.xml`。
+- 根据 Switch 实机行为确认 save root 和权限。