# Scene::DeserializeFromString

从字符串反序列化场景。

```cpp
void DeserializeFromString(const std::string& data);
```

从 JSON 格式的字符串数据恢复场景的完整状态，包括所有 GameObject、组件和层级结构。

**参数：**
- `data` - JSON 格式的序列化数据

**线程安全：** ❌ (非线程安全，应在主线程调用)

**注意：**
- 此操作会清空当前场景的所有数据
- 反序列化后的 GameObject 引用可能与原始引用不同

**示例：**

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

using namespace XCEngine::Components;

void Example(Scene* scene) {
    std::string data = R"({
        "name": "GameScene",
        "gameObjects": [...]
    })";
    scene->DeserializeFromString(data);
}
```

## 相关文档

- [Scene 总览](scene.md) - 返回类总览
- [Save](save.md) - 保存到文件
- [SerializeToString](serialize-to-string.md) - 序列化为字符串