版本: Unity 6 (6000.0)
语言英语
  • C#

SceneManager.UnloadSceneAsync

建议更改

成功!

感谢您帮助我们提高 Unity 文档的质量。虽然我们无法接受所有提交内容,但我们会阅读用户提出的每一项建议更改,并在适用情况下进行更新。

关闭

提交失败

由于某些原因,您的建议更改无法提交。请<a>稍后重试</a>。感谢您抽出时间帮助我们提高 Unity 文档的质量。

关闭

取消

声明

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 场景在 BuildSettings 中的索引。
sceneName 要卸载的场景的名称或路径。
scene 要卸载的场景。
options 场景卸载选项。

返回值

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

描述

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

给定的场景名称可以是完整的场景路径、Build Settings 窗口中显示的路径或仅仅是场景名称。如果仅给出场景名称,则将卸载列表中第一个匹配的场景。如果有多个名称相同但路径不同的场景,则应使用完整的场景路径。支持的格式示例
"Scene1"
"Scene2"
"Scenes/Scene3"
"Scenes/Others/Scene3"
"Assets/scenes/others/scene3.unity"

注意: 这是不区分大小写的,并且由于它是异步的,因此无法保证完成时间。
注意: 目前不会卸载资源。若要释放资源内存,请调用 Resources.UnloadUnusedAssets.
注意: 如果没有要加载的场景,则无法 UnloadSceneAsync。例如,只有一个场景的项目无法使用此静态成员。