class in UnityEditor.SceneManagement

/

Inherits from:SceneManagement.SceneManager

Description

Manage scenes in the Editor when it is in Edit mode.

• SceneAsset is the imported object for scene asset files with the extension ‘.unity’. It is used to set up references to scene files in Editor scripts. Note that SceneAsset is Editor-only, since paths or the index of a scene in the Build Settings is used for loading at runtime.
• Scene is an instance of a scene file when loaded with SceneManager.LoadScene in Play mode or when opened with EditorSceneManager.OpenScene in Edit mode.

• EditorSceneManager.SaveScene
• EditorSceneManager.SaveScenes
• EditorSceneManager.SaveOpenScenes
• EditorSceneManager.SaveModifiedScenesIfUserWantsTo

• EditorSceneManager.OpenScene
• EditorSceneManager.CloseScene
• EditorSceneManager.RestoreSceneManagerSetup

• EditorSceneManager.NewPreviewScene
• EditorSceneManager.ClosePreviewScene

using UnityEngine;
using UnityEditor;
using UnityEditor.SceneManagement;
using UnityEngine.UIElements;
using UnityEditor.UIElements;
using System.Collections.Generic;
public class EditorSceneManagerTestWindow : EditorWindow
{
    private readonly string[] m_ScenePaths = { "Assets/Scene1.unity", "Assets/Scene2.unity", "Assets/Scene3.unity", "Assets/Scene4.unity" };
    private ObjectField[] m_SceneFields;
    [MenuItem("Examples/EditorSceneManager")]
    public static void ShowWindow()
    {
        var window = GetWindow<EditorSceneManagerTestWindow>();
        window.titleContent = new GUIContent("EditorSceneManager APIs");
        window.minSize = new Vector2(300, 400);
    }
    public void CreateGUI()
    {
        var root = rootVisualElement;
        root.style.paddingLeft = root.style.paddingRight = root.style.paddingBottom = root.style.paddingTop = 10;
        // Create buttons
        var createScenesButton = CreateButton("Create Test Scenes", 30, CreateScenes);
        var openSingleSceneButton = CreateButton("Open Single Scene", 10, OpenSingleScene);
        var restoreSceneManagerSetupButton = CreateButton("Restore SceneManager Setup", 10, RestoreSceneManagerSetup);
        var closeAllScenesButton = CreateButton("Close All Scenes", 10, CloseAllScenes);
        // Add buttons to rootVisualElement
        root.Add(createScenesButton);
        root.Add(openSingleSceneButton);
        root.Add(restoreSceneManagerSetupButton);
        root.Add(closeAllScenesButton);
        // Add title
        var titleLabel = new Label("Scene Asset References");
        titleLabel.style.fontSize = 12;
        titleLabel.style.marginBottom = 10;
        titleLabel.style.marginTop = 30;
        titleLabel.style.unityFontStyleAndWeight = FontStyle.Bold;
        root.Add(titleLabel);
        // Add a couple of object fields for picking SceneAssets
        const int kNumObjectFields = 5;
        m_SceneFields = new ObjectField[kNumObjectFields];
        for(int i=0; i<m_SceneFields.Length; i++)
        {
            var sceneField = new ObjectField()
            {
                objectType = typeof(SceneAsset),
                allowSceneObjects = false
            };
            root.Add(sceneField);
            m_SceneFields[i] = sceneField;
        }
      
        var openReferencedScenesButton = CreateButton("Open Referenced Scenes", 10, OpenReferencedScenes);
        root.Add(openReferencedScenesButton);
    }
    private Button CreateButton(string text, float bottomMargin, System.Action clickEvent)
    {
        var button = new Button(clickEvent) { text = text };
        button.style.marginBottom = bottomMargin;
        button.style.height = 30;
        return button;
    }
    private void CreateScenes()
    {
        foreach (var scenePath in m_ScenePaths)
        {
            var scene = EditorSceneManager.NewScene(NewSceneSetup.DefaultGameObjects, NewSceneMode.Single);
            EditorSceneManager.SaveScene(scene, scenePath);
        }
    }
    private void RestoreSceneManagerSetup()
    {
        if (!EditorSceneManager.SaveCurrentModifiedScenesIfUserWantsTo())
            return;
        var sceneSetups = new List<SceneSetup>();
        for (int i = 0; i < m_ScenePaths.Length; i++)
        {
            var scenePath = m_ScenePaths[i];
            var setup = new SceneSetup
            {
                path = scenePath,
                isLoaded = true,
                isActive = (i == 0) // First scene is active
            };
            sceneSetups.Add(setup);
        }
        EditorSceneManager.RestoreSceneManagerSetup(sceneSetups.ToArray());
    }
    private void OpenSingleScene()
    {
        if (!EditorSceneManager.SaveCurrentModifiedScenesIfUserWantsTo())
            return;
        EditorSceneManager.OpenScene(m_ScenePaths[0], OpenSceneMode.Single);
    }
    private void CloseAllScenes()
    {
        if (!EditorSceneManager.SaveCurrentModifiedScenesIfUserWantsTo())
            return;
        EditorSceneManager.NewScene(NewSceneSetup.EmptyScene, NewSceneMode.Single);
    }
    private void OpenReferencedScenes()
    {
        // Check if we have valid scenes
        var sceneSetups = new List<SceneSetup>();
        bool hasValidScenes = false;
        for (int i = 0; i < m_SceneFields.Length; i++)
        {
            var sceneAsset = m_SceneFields[i].value as SceneAsset;
            if (sceneAsset != null)
            {
                hasValidScenes = true;
                var scenePath = AssetDatabase.GetAssetPath(sceneAsset);
                var sceneSetup = new SceneSetup
                {
                    path = scenePath,
                    isLoaded = true,
                    isActive = (i == 0) // First scene is active
                };
                sceneSetups.Add(sceneSetup);
            }
        }
        if (!hasValidScenes)
        {
            EditorUtility.DisplayDialog("Error", "Please assign at least one scene.", "OK");
            return;
        }
        // Save current modified scenes if necessary
        if (!EditorSceneManager.SaveCurrentModifiedScenesIfUserWantsTo())
            return;
        // Restore the scene setup
        EditorSceneManager.RestoreSceneManagerSetup(sceneSetups.ToArray());
    }
}

Events

Event	Description
activeSceneChangedInEditMode	Subscribe to this event to get notified when the active Scene has changed in Edit mode in the Editor.
newSceneCreated	This event is called after a new Scene has been created.
sceneClosed	This event is called after a Scene has been closed in the editor.
sceneClosing	This event is called before closing an open Scene after you have requested that the Scene is closed.
sceneDirtied	This event is called after a Scene has been modified in the editor.
sceneManagerSetupRestored	This can be useful to get notified when the SceneManager's scenes are replaced with a set of new scenes from calls to RestoreSceneManagerSetup.Use the scenes argument to check what scenes has just been opened.Additional resources: SceneManagerSetupRestoredCallback.
sceneOpened	This event is called after a Scene has been opened in the editor.
sceneOpening	This event is called before opening an existing Scene.
sceneSaved	This event is called after a Scene has been saved.
sceneSaving	This event is called before a Scene is saved disk after you have requested the Scene to be saved.

Delegates

Delegate	Description
NewSceneCreatedCallback	Callbacks of this type which have been added to the newSceneCreated event are called after a new Scene has been created.
SceneClosedCallback	Callbacks of this type which have been added to the sceneClosed event are called immediately after the Scene has been closed.
SceneClosingCallback	Callbacks of this type which have been added to the sceneClosing event are called just before a Scene is closed.
SceneDirtiedCallback	Callbacks of this type which have been added to the sceneDirtied event are called after a Scene changes from being unmodified to being modified.
SceneManagerSetupRestoredCallback	Callbacks of this type which have been added to the sceneManagerSetupRestored event are called after RestoreSceneManagerSetup has been called.
SceneOpenedCallback	Callbacks of this type which have been added to the sceneOpened event are called after a Scene has been opened.
SceneOpeningCallback	Callbacks of this type which have been added to the sceneOpening event are called just before opening a Scene.
SceneSavedCallback	Callbacks of this type which have been added to the sceneSaved event are called after a Scene has been saved.
SceneSavingCallback	Callbacks of this type which have been added to the sceneSaving event are called just before the Scene is saved.

Inherited Members