SceneManager.UnloadSceneAsync
Declaration
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 | Индекс Scene в BuildSettings. |
| sceneName | Имя или путь файла Scene для выгрузки. |
| сцена | Scene для разгрузки. |
| варианты | Scene варианты разгрузки. |
Возвращаемое значение
AsyncOperation Используйте AsyncOperation, чтобы определить, завершена ли операция.
Описание
Уничтожает все GameObjects, связанные с данным Scene и удаляет Scene из SceneManager.
Заданное имя Scene может быть полным путем Scene, путем, показанным в окне Настройки сборки, или только именем Scene. Если задано только имя Scene, то это выгрузит первый Scene в соответствующем списке. Если у вас есть несколько сцен с одинаковым именем, но разными путями, вы должны использовать полный путь Scene. Примеры поддерживаемых форматов:
"Scene1"
"Scene2"
"Scenes/Scene3"
"Scenes/Others/Scene3"
"Assets/scenes/others/scene3.unity"
Примечание: Это не зависит от регистра и из-за того, что это асинхронно, нет гарантий о времени завершения.
Примечание: Ассеты в настоящее время не выгружаются. Для того, чтобы освободить память ассетов вызвать Resources.UnloadUnusedAssets.
Примечание: Нельзя UnloadSceneAsync если загружать нечего. Например, проект с единственной сценой не может использовать этот статический член.