XCEngine/docs/api/scene/scene.md

Scene 模块概览

命名空间: XCEngine::Components

类型: module

描述: XCEngine 的场景管理模块，提供场景创建、加载和 GameObject 管理功能。

概述

Scene 模块是 XCEngine 中管理游戏场景的核心模块。它提供了 Scene 类用于管理场景中的所有 GameObject，以及 SceneManager 单例用于管理多个场景、场景切换和生命周期。场景是 GameObject 的容器，支持场景保存/加载、子对象查找、事件通知等功能。

模块内容

核心类

组件	文件	描述
Scene	Scene.h	场景类，管理 GameObject 层级和生命周期
SceneManager	SceneManager.h	场景管理器单例，管理所有场景

使用示例

#include <XCEngine/Scene/SceneManager.h>
#include <XCEngine/Scene/Scene.h>
#include <XCEngine/Components/GameObject.h>

using namespace XCEngine::Components;

void CreateNewScene() {
    Scene* scene = SceneManager::Get().CreateScene("MainMenu");
    SceneManager::Get().SetActiveScene(scene);
    
    GameObject* camera = scene->CreateGameObject("MainCamera");
}

void LoadSceneExample() {
    SceneManager::Get().LoadScene("levels/gameplay.json");
}

相关文档

• Components 模块 - Components 模块总览
• GameObject - 游戏对象