# SceneManager

**命名空间**: `XCEngine::Components`

**类型**: `class (singleton)`

**头文件**: `XCEngine/Scene/SceneManager.h`

**描述**: 场景管理器单例，管理所有场景和活动场景。

## 概述

SceneManager 是 XCEngine 中的场景管理器单例，负责管理所有加载的场景、场景切换（同步/异步）、设置活动场景，以及发布场景加载/卸载事件。它是场景系统的入口点，提供场景创建、加载、卸载和切换的接口。

## 单例访问

| 方法 | 描述 |
|------|------|
| `static SceneManager& Get()` | 获取场景管理器单例实例 |

## 公共方法

### 场景管理

| 方法 | 描述 |
|------|------|
| [`CreateScene`](create-scene.md) | 创建新场景 |
| [`LoadScene`](load-scene.md) | 同步加载场景 |
| [`LoadSceneAsync`](load-scene-async.md) | 异步加载场景 |
| [`UnloadScene`](unload-scene.md) | 卸载场景 |

### 活动场景

| 方法 | 描述 |
|------|------|
| [`SetActiveScene`](set-active-scene.md) | 设置活动场景 |
| [`GetActiveScene`](get-active-scene.md) | 获取当前活动场景 |

### 查找

| 方法 | 描述 |
|------|------|
| [`GetScene`](get-scene.md) | 按名称获取场景 |
| [`GetAllScenes`](get-all-scenes.md) | 获取所有场景 |

### 事件

| 方法 | 描述 |
|------|------|
| [`OnSceneLoaded`](on-scene-loaded.md) | 场景加载完成事件 |
| [`OnSceneUnloaded`](on-scene-unloaded.md) | 场景卸载完成事件 |
| [`OnActiveSceneChanged`](on-active-scene-changed.md) | 活动场景变更事件 |

## 使用示例

```cpp
#include <XCEngine/Scene/SceneManager.h>

using namespace XCEngine::Components;

void SceneManagerExample() {
    Scene* scene = SceneManager::Get().CreateScene("GameLevel");
    SceneManager::Get().SetActiveScene(scene);
    
    SceneManager::Get().LoadSceneAsync("levels/menu.json", [](Scene* loadedScene) {
        printf("Scene loaded: %s\n", loadedScene->GetName().c_str());
    });
}
```

## 相关文档

- [Scene 模块总览](../scene.md) - Scene 模块总览
- [Scene](../scene.md) - 场景类