SceneManager.sceneLoaded

Parameters

Description

Assign a custom callback to this event to get notifications when a Scene has loaded.

Create a custom callback method to receive the notification and assign it to the SceneManager.sceneLoaded event. The callback must have the required signature, taking a Scene and a LoadSceneMode as input parameters.

The code example below defines a custom calllback method called OnSceneLoaded with the required signature. It assigns OnSceneLoaded to SceneManager.sceneLoaded in the OnEnable callback and unassigns it in the OnDisable callback.

The code example and comment annotations demonstrate the execution order of the callbacks. Unity raises the SceneManager.sceneLoaded event and invokes the associated callback after OnEnable but before Start.

Additional resources: Details of disabling domain and scene reload

using UnityEngine;
using UnityEngine.SceneManagement;

public class ExampleCode : MonoBehaviour
{
    // called first
    void Awake()
    {
        Debug.Log("Awake");
    }

    // called second
    void OnEnable()
    {
        Debug.Log("OnEnable called");
        SceneManager.sceneLoaded += OnSceneLoaded;
    }

    // called third
    void OnSceneLoaded(Scene scene, LoadSceneMode mode)
    {
        Debug.Log("OnSceneLoaded: " + scene.name);
        Debug.Log(mode);
    }

    // called fourth
    void Start()
    {
        Debug.Log("Start");
    }

    // called when the game is terminated
    void OnDisable()
    {
        Debug.Log("OnDisable");
        SceneManager.sceneLoaded -= OnSceneLoaded;
    }
}