Scene

Description

The runtime data structure for a scene.

This object can be used to query information about a scene, and as an input to various scene manipulation functions in SceneManager and EditorSceneManager. To query the PhysicsScene that is assigned to the scene, use the PhysicsSceneExtensions.GetPhysicsScene method.

The following script prints some information about the currently loaded scene, creates and switches to a new scene, then prints the same information for the new scene. To use the script, attach it to a GameObject and run the project.

using UnityEngine;
using UnityEngine.SceneManagement;

public class SwitchSceneAndQueryInfo : MonoBehaviour
{
    public static void QuerySceneInfo(Scene scene)
    {
        Debug.Log("Scene name: " + scene.name);
        Debug.Log("Scene path: " + scene.path);
        Debug.Log("Scene build index: " + scene.buildIndex);
        Debug.Log("Scene is dirty: " + scene.isDirty);
        Debug.Log("Scene is loaded: " + scene.isLoaded);
        Debug.Log("Scene root count: " + scene.rootCount);
    }

    public void Start()
    {
        // Query information about the currently active scene
        Scene currentScene = SceneManager.GetActiveScene();
        QuerySceneInfo(currentScene);

        // Create a new scene and switch to it
        var newScene = SceneManager.CreateScene("MyNewScene");
        SceneManager.SetActiveScene(newScene);
        SceneManager.UnloadSceneAsync(currentScene);

        // Query information about the new scene
        QuerySceneInfo(newScene);
    }
}

Additional resources: SceneAsset.

Properties

Public Methods

Operators