This is an old revision of the document!
When does scene loading happen? Scene loading and unloading happens at the start of the Update loop, within the EarlyUpdate.UpdatePreloading
phase of the PlayerLoop, and once during the Initialization phase of the player, before the first Update loop.
Player Loop Phases:
The scene loading queue is a pipeline, and only one AsyncOperation can progress at a time. Calling SceneManager.LoadSceneAsync
or SceneManager.UnloadSceneAsync
adds a new AsyncOperation onto the end of the queue.
During the UpdatePreloading
phase, Unity will execute the next operation in the scene loading queue.
The scene loading pipeline only seems to execute a single operation, every other frame. That is to say if you have 3 small scenes in the pipeline (Scene1, Scene2, Scene3), loading additively, the engine will load them at the following times:
The Engine simply “flushes” the scene loading queue during initialization.
The Unity scene flushing pipeline works differently in the initialization phase of the player. All AsyncOperations that are queued during initialization are fully loaded during initialization. For example, if SceneManager.LoadSceneAsync
is called in the Awake of the very first scene1), then the engine will fully load the new scene before starting the first Update.
(The scene load pipeline is fully flushed) I don't yet know how it handles unloads if they are in the pipeline then, so if we need this behaviour we should debug and see how it works. If scene unloads get flushed too, we'll need to add a bit of logic for it, in the same way LoadSceneAsync does.
Scenes are built during standalone in the following way: '
Here is an example of a scene loading additively in the middle of a game, in the editor. Note that:
scene.isLoaded=false
. scene.isLoaded=false
. 2)