NS_unknown_game/game/docs/modules/audio_save.md

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)

路径解析优先级：

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 和权限。