Loading and Switching Scenes

Cocos Creator 3D uses the scene's file name (without extension) to index the scene. Loading and switching scenes is performed using the loadScene() API. Example:

director.loadScene("MyScene");

Scene resource management and Persistent Nodes

The engine will only run one scene at the same time. When switching scenes, all nodes and other instances in the scene will be destroyed by default. Developer's may need to use a component to control the loading of all scenes, or to transfer parameter data between scenes, mark the node where the component is located as a Persistent Node so that it will not be automatically destroyed when the scene is switched, and will remain in memory. Example:

game.addPersistRootNode(myNode);

The above interface will turn myNode into a persistent node, so that the components attached to it can continue to function between scenes. This method can be used to store player information, or various things needed for the initialization of the next scene data.

Note: the target node must be the root node in the hierarchy, otherwise the setting is invalid.

Cancelling the persistece of a node is easy. Example:

game.removePersistRootNode(myNode);

Note: the above API does not immediately destroy the specified node, but restores the node to a node that can be destroyed when the scene is switched.

Scene loading callback

When loading a scene, you can attach a parameter to specify the callback function after the scene is loaded. Example:

director.loadScene("MyScene", onSceneLaunched);

onSceneLaunched is a callback function declared in this script, and can be used for further initialization or data transfer operations after the scene is loaded.

Since the callback function can only be written in this script, the scene loading callback is usually used in conjunction with the persistent node and used in the script mounted on the persistent node.

Preloading a scene

director.loadScene will automatically switch to run the new scene after loading the scene. It is also possible to silently load the new scene in the background and switch manually after the loading is complete. Use the preloadScene interface to preload the scene in advance. Example:

director.preloadScene("table", function () {
    console.log("Next scene preloaded");
});

Then call loadScene at an appropriate time to switch scenes. Example:

director.loadScene("table");

Note: if the preloading is not complete, you can also call director.loadScene() directly, and the scene will start after the preloading is complete.

Continue to the Loading Assets documentation.