Files
NS_unknown_game/game/docs/modules/scene_camera.md
T
2026-06-09 23:11:08 +08:00

52 lines
1.2 KiB
Markdown

# Scene and Camera
## 职责
场景模块负责局内生命周期、关卡装配、摄像机和 battle zone 流程。
主要源码:
- `game/src/scene/whitebox_scene.*`
- `game/src/scene/camera_controller.*`
## `WhiteboxScene`
当前负责:
- 加载 `LevelDefinition`
- 创建玩家。
- 配置摄像机。
- 驱动 battle zone 状态。
- 调用 `StageRenderer`
- 调用 `DebugOverlay`
- 推入 `GameUiOverlay`
- 播放关卡 BGM 和 battle zone 进入音效。
- 保存 debug 开关。
## 摄像机
`CameraController` 当前支持:
- 玩家横向跟随。
- dead zone。
- 平滑移动。
- 世界边界 clamp。
- battle zone 临时 camera bounds。
进入/离开 battle zone 时,camera bounds 通过短过渡平滑切换,避免硬切瞬移。
## Battle Zone
当前 battle zone 还是场景骨架阶段:
- 玩家进入触发区后激活。
- 摄像机锁定到 zone camera bounds。
- `F2` debug 清场后解除锁定。
- enemy spawn point 只做 debug 显示,暂不刷敌。
## 下一步
- 用敌人清空结果替代 `F2` debug 清场。
- 给 battle zone 增加入口/出口锁定数据。
- 把场景切换、重置、加载/卸载流程独立成 SceneFlow 模块。