50 lines
2.2 KiB
Markdown
50 lines
2.2 KiB
Markdown
# Scene
|
|
|
|
**命名空间**: `XCEngine::Components`
|
|
|
|
**类型**: `module`
|
|
|
|
**描述**: 提供场景容器、多场景管理入口以及场景运行时调度器。
|
|
|
|
## 概览
|
|
|
|
当前 `XCEngine/Scene` 目录里的 public API 主要分成三层：
|
|
|
|
- [Scene](Scene/Scene.md) 负责对象树、场景级更新和场景序列化。
|
|
- [SceneManager](SceneManager/SceneManager.md) 负责多场景注册与活动场景入口。
|
|
- [SceneRuntime](SceneRuntime/SceneRuntime.md) 负责把某个场景真正“跑起来”，并和脚本系统衔接。
|
|
|
|
这种分层和商业引擎里常见的思路接近：`Scene` 是数据与对象容器，`SceneManager` 负责更高层的场景切换，而 `SceneRuntime` 则承担运行时执行语义。
|
|
|
|
## 设计要点
|
|
|
|
- `Scene` 专注对象拥有权、查询和序列化，不直接变成庞大的运行时调度中心。
|
|
- `SceneRuntime` 把脚本生命周期和场景更新顺序集中管理，避免脚本系统散落到 `Scene` 内部。
|
|
- `SceneManager` 让多场景入口和单个场景数据模型解耦，便于以后扩展更复杂的场景切换策略。
|
|
|
|
## 当前实现边界
|
|
|
|
- 当前公开类型都位于 `XCEngine::Components` 命名空间，而不是单独的 `XCEngine::Scene` 命名空间，这反映了引擎当前建模历史。
|
|
- `SceneRuntime` 目前只管理单个运行中的场景。
|
|
- `SceneManager::LoadSceneAsync()` 仍是同步包装，不是完整异步加载系统。
|
|
- 场景序列化使用引擎私有文本格式，强调可落地而不是通用交换格式。
|
|
|
|
## 头文件
|
|
|
|
- [Scene](Scene/Scene.md) - `Scene.h`
|
|
- [SceneManager](SceneManager/SceneManager.md) - `SceneManager.h`
|
|
- [SceneRuntime](SceneRuntime/SceneRuntime.md) - `SceneRuntime.h`
|
|
|
|
## 相关指南
|
|
|
|
- [Scene Lifecycle And Serialization](../../_guides/Scene/Scene-Lifecycle-And-Serialization.md) - 解释场景容器、运行时调度和序列化之间的关系，以及当前实现的真实限制。
|
|
|
|
## 相关文档
|
|
|
|
- [GameObject](../Components/GameObject/GameObject.md)
|
|
- [Component](../Components/Component/Component.md)
|
|
- [TransformComponent](../Components/TransformComponent/TransformComponent.md)
|
|
- [Scripting](../Scripting/Scripting.md)
|
|
- [上级目录](../XCEngine.md)
|
|
- [API 总索引](../../main.md)
|