EditorSceneManager

Управление сценами в редакторе, когда он находится в режиме редактирования.

EditorSceneManager является системой управления сценами для режима редактирования в Редакторе. EditorSceneManager расширяет SceneManager и обеспечивает логику и поведение, характерные для Редактора, в дополнение к SceneManager API.

Используйте EditorSceneManager для управления тем, какие сцены отображаются в окне Hierarchy с помощью OpenScene, CloseScene, или, чтобы открыть несколько сцен одновременно, используйте RestoreSceneManagerSetup.

Примечание: В режиме воспроизведения используйте SceneManager API для загрузки и разгрузки сцен.

Терминология:

• SceneAsset — это импортированный объект для файлов ассетов сцены с расширением ‘.unity’. Он используется для создания ссылок на файлы сцены в скриптах Редактора. Обратите внимание, что SceneAsset используется только Редактором, так как пути или индекс сцены в Настройках Build используются для загрузки во время выполнения.
• Scene является экземпляром файла сцены, когда загружается с помощью SceneManager.LoadScene в режиме воспроизведения или открывается с помощью EditorSceneManager.OpenScene в режиме редактирования.

Когда файл сцены открывается EditorSceneManager.OpenScene, содержимое файла сцены загружается в память, и в процессе выполнения Scene структура-дескриптор. Эта структура Scene используется различными API редактора и времени выполнения.

Создание сцены

Вы можете использовать EditorSceneManager.NewScene для создания новой сцены. Когда вы создаете новую Scene, она отображается в Hierarchy как "Без названия". Эта сцена без названия еще не сохранена на диск. Вы можете иметь только одну сцену "Без названия" одновременно.

Сохранение сцены в SceneAsset

Это APIs, которые можно использовать для сохранения сцены в SceneAsset на диске в указанном пути, либо непосредственно из кода, либо из диалога Сохранить:

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

Открытие и закрытие сцен

Используйте следующие команды для управления тем, какие сцены открываются в режиме редактирования и отображаются в окне Hierarchy:

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

Примечание: Редактор требует, чтобы хотя бы одна сцена была открыта и загружена. Если вы хотите закрыть все сцены, используйте NewSceneMode.Single с EditorSceneManager.NewScene API.

Доступ к загруженным сценам

EditorSceneManager предоставляет API для доступа к загруженным сценам через свой базовый класс. Например, SceneManager.loadedSceneCount, SceneManager.GetSceneAt, и SceneManager.GetSceneByPath.

Scene манипуляции

Используйте методы базового класса SceneManager, например SceneManager.MergeScenes и SceneManager.MoveGameObjectToScene, чтобы перемещать объекты между сценами.

EditorSceneManager события

EditorSceneManager предоставляет также множество событий, по которым можно отслеживать изменения сцен: создание новой сцены, открытие или закрытие сцены в редакторе. Скрипты могут подписаться на эти события и получать уведомления при изменении состояния сцены или EditorSceneManager. См. раздел «События».

Сцены инструментов редактора

EditorSceneManager также имеет следующие API для управления в памяти сценами инструментов только для Редактора. Они называются сценами предварительного просмотра и жизнь этих сцен должна поддерживаться вами. Вы можете использовать их для ваших собственных инструментов Редактора. Эти сцены не отображаются автоматически в окне Hierarchy.

• EditorSceneManager.NewPreviewScene
• EditorSceneManager.ClosePreviewScene

Управление стартовой сценой в режиме воспроизведения

В любом сценарии Редактора можно установить EditorSceneManager.playModeStartScene, если вы хотите имитируемую пользовательскую стартовую сцену для режима воспроизведения вместо воспроизведения текущих открытых сцен из режима редактирования.

Образец кода ядра EditorSceneManager APIs

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());
    }
}