54 lines
1011 B
Markdown
54 lines
1011 B
Markdown
# 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 和权限。
|