Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


sceneLoaded

Assign a custom callback to this event to get notifications when a Scene has loaded.
Read time 1 minuteLast updated 13 days ago

Definition

public static event UnityAction<Scene, LoadSceneMode> sceneLoaded

Remarks

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
.

Examples

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