Version: 2022.3

SceneManager.UnloadSceneAsync

切换到手册
public static AsyncOperation UnloadSceneAsync (int sceneBuildIndex);
public static AsyncOperation UnloadSceneAsync (string sceneName);
public static AsyncOperation UnloadSceneAsync (SceneManagement.Scene scene);
public static AsyncOperation UnloadSceneAsync (int sceneBuildIndex, SceneManagement.UnloadSceneOptions options);
public static AsyncOperation UnloadSceneAsync (string sceneName, SceneManagement.UnloadSceneOptions options);
public static AsyncOperation UnloadSceneAsync (SceneManagement.Scene scene, SceneManagement.UnloadSceneOptions options);

参数

sceneBuildIndex Build Settings 中的场景索引。
sceneName 要卸载的场景的名称或路径。
scene 要卸载的场景。
options 场景卸载选项。

返回

AsyncOperation 使用 AsyncOperation 确定操作是否已完成。

描述

销毁所有与给定场景关联的游戏对象,并将场景从 SceneManager 中移除。

提供的场景名称可以是完整场景路径(Build Settings 窗口中 显示的路径),也可以只是场景名称。如果仅提供场景名称, 此方法将卸载场景列表中匹配的第一个场景。如果您有 多个名称相同但路径不同的场景,应该使用完整的场景路径。 支持的格式示例:\ "Scene1"\ "Scene2"\ "Scenes/Scene3"\ "Scenes/Others/Scene3"\ "Assets/scenes/others/scene3.unity"\ \ **注意:**这不区分大小写。由于是异步场景,不保证完成时间。 \ **注意:**目前不会卸载资源。要释放资源内存,请调用 Resources.UnloadUnusedAssets。 \ **注意:**如果没有可加载的场景,则无法执行 UnloadSceneAsync。例如,只包含一个场景的项目无法使用此静态成员。