SceneManagement.SceneManager.LoadSceneAsync

Unity · Версия 2020.3 LTS · Scripting · SceneManager

SceneManagement.SceneManager.LoadSceneAsync

Объявление

public static AsyncOperation LoadSceneAsync(string sceneName, SceneManagement.LoadSceneMode mode = LoadSceneMode.Single);

public static AsyncOperation LoadSceneAsync(int sceneBuildIndex, SceneManagement.LoadSceneMode mode = LoadSceneMode.Single);

public static AsyncOperation LoadSceneAsync(string sceneName, SceneManagement.LoadSceneParameters parameters);

public static AsyncOperation LoadSceneAsync(int sceneBuildIndex, SceneManagement.LoadSceneParameters parameters);

Параметры

sceneName Имя или путь загружаемой сцены.
sceneBuildIndex Индекс сцены в настройках сборки для загрузки.
mode Если LoadSceneMode.Single, то все текущие сцены будут выгружены перед загрузкой.
parameters Структура, которая собирает различные параметры в одном месте, кроме имени и индекса.

Возвращает

AsyncOperation Используйте AsyncOperation, чтобы определить, завершена ли операция.

Описание

Загружает сцену асинхронно в фоновом режиме.

Вы можете указать полный путь к сцене, путь, указанный в окне "Параметры сборки", или просто имя сцены. Если вы укажете только имя сцены, Unity загрузит первую совпадающую сцену из списка. Если у вас есть несколько сцен с одинаковым именем, но разными путями, вы должны использовать полный путь к сцене в настройках сборки.

Examples of supported formats:
"Scene1"
"Scenes/Scene1"
"Scenes/Others/Scene1"
"Assets/scenes/others/scene1.unity"

Примечание. При вводе имени сцены не учитывается регистр.
Если вы вызываете этот метод с недопустимым sceneName или sceneBuildIndex, Unity генерирует исключение.

using System.Collections;
using UnityEngine;
using UnityEngine.SceneManagement;

public class Example : MonoBehaviour
{
    void Update()
    {
        // Press the space key to start coroutine
        if (Input.GetKeyDown(KeyCode.Space))
        {
            // Use a coroutine to load the Scene in the background
            StartCoroutine(LoadYourAsyncScene());
        }
    }

    IEnumerator LoadYourAsyncScene()
    {
        // The Application loads the Scene in the background as the current Scene runs.
        // This is particularly good for creating loading screens.
        // You could also load the Scene by using sceneBuildIndex. In this case Scene2 has
        // a sceneBuildIndex of 1 as shown in Build Settings.

AsyncOperation asyncLoad = SceneManager.LoadSceneAsync("Scene2");

        // Wait until the asynchronous scene fully loads
        while (!asyncLoad.isDone)
        {
            yield return null;
        }
    }
}

Обновлено 17 ноября 2026 г.