XCEngine/docs/api/XCEngine/Scene/SceneManager/LoadSceneAsync.md

SceneManager::LoadSceneAsync

异步加载场景。

void LoadSceneAsync(const std::string& filePath, std::function<void(Scene*)> callback);

行为说明

当前实现实际上并没有启动后台任务，而是：

1. 直接调用 LoadScene。
2. 如果 callback 非空，再执行 callback(GetScene(filePath))。

参数

• filePath - 场景文件路径。
• callback - 加载结束后调用的回调。

返回值

• 无。

当前实现限制

• 当前完全是同步执行，不是线程化或任务系统驱动的异步加载。
• 回调查找使用的是原始 filePath，而 LoadScene 存储使用的是文件名 stem。对于常见的 assets/scenes/Main.xc 这类输入，GetScene(filePath) 通常会返回 nullptr。

相关文档

• 返回类型总览
• LoadScene