42 lines
1.2 KiB
Markdown
42 lines
1.2 KiB
Markdown
# SceneManager::UnloadScene
|
|
|
|
卸载一个已登记场景。
|
|
|
|
```cpp
|
|
void UnloadScene(Scene* scene);
|
|
void UnloadScene(const std::string& sceneName);
|
|
```
|
|
|
|
## 行为说明
|
|
|
|
当前有两个重载：
|
|
|
|
- 指针重载：
|
|
1. `scene == nullptr` 时直接返回。
|
|
2. 如果它正好是 `m_activeScene`，先把活动场景清空。
|
|
3. 在 `m_scenes` 里线性查找匹配指针。
|
|
4. 找到后触发 [OnSceneUnloaded](OnSceneUnloaded.md)，然后擦除。
|
|
5. 如果活动场景为空且仍有剩余场景，选择 `m_scenes.begin()` 作为新的活动场景，并触发 [OnActiveSceneChanged](OnActiveSceneChanged.md)。
|
|
- 字符串重载：先按 key 查找，再转到指针重载。
|
|
|
|
## 参数
|
|
|
|
- `scene` - 待卸载场景指针。
|
|
- `sceneName` - 待卸载场景 key。
|
|
|
|
## 返回值
|
|
|
|
- 无。
|
|
|
|
## 当前实现限制
|
|
|
|
- 后备活动场景来自 `unordered_map` 首元素，选择顺序不稳定。
|
|
- 如果卸载的是最后一个活动场景，当前不会额外发出“活动场景变为 `nullptr`”的切换事件。
|
|
- 指针重载内部需要线性扫描 map 找到匹配场景。
|
|
|
|
## 相关文档
|
|
|
|
- [返回类型总览](SceneManager.md)
|
|
- [OnSceneUnloaded](OnSceneUnloaded.md)
|
|
- [OnActiveSceneChanged](OnActiveSceneChanged.md)
|