43 lines
1.0 KiB
Markdown
43 lines
1.0 KiB
Markdown
# SceneRuntime::Start
|
||
|
||
**命名空间**: `XCEngine::Components`
|
||
|
||
**类型**: `method`
|
||
|
||
**头文件**: `XCEngine/Scene/SceneRuntime.h`
|
||
|
||
## 签名
|
||
|
||
```cpp
|
||
void Start(Scene* scene);
|
||
```
|
||
|
||
## 作用
|
||
|
||
让一个场景进入运行状态，并启动其脚本运行时。
|
||
|
||
## 当前实现流程
|
||
|
||
按 `engine/src/Scene/SceneRuntime.cpp`：
|
||
|
||
1. 如果当前已经在运行同一个 `scene`，直接返回。
|
||
2. 先调用 [Stop](Stop.md) 清掉旧运行时。
|
||
3. 如果传入空场景，返回。
|
||
4. 写入 `m_scene`，把 `m_running` 设为 `true`。
|
||
5. 调用 `ScriptEngine::Get().OnRuntimeStart(scene)`。
|
||
|
||
## 参数
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| `scene` | 要开始运行的场景；可为空，空时表示“停掉当前运行时但不启动新场景”。 |
|
||
|
||
## 设计含义
|
||
|
||
这种“先停再启”的切换方式很直接，也和很多商业引擎的 play mode 切场景行为一致。优点是生命周期边界清晰；代价是当前没有做平滑切换或状态迁移。
|
||
|
||
## 相关文档
|
||
|
||
- [SceneRuntime](SceneRuntime.md)
|
||
- [SceneRuntime::Stop](Stop.md)
|