/// <summary>Load the given level</summary>
/// <param name="aSceneName">Scene to load</param>
/// <param name="aLoadingData">An amount of key/value pairs to pass to the next scene</param>
public void LoadScene(string aSceneName, params KeyValue[] aLoadingData)
{
loading = true;
// Setup loading data if provided
LoadingOperation loadingOperation = null;
if (loadingOperations.TryGetValue(aSceneName, out loadingOperation) == false)
{
loadingOperation = new LoadingOperation();
loadingOperations[aSceneName] = loadingOperation;
}
if (aLoadingData != null)
{
loadingOperation.SetData(aLoadingData);
}
// Ensure loading can progress if the game is completely frozen
if (Time.timeScale == 0)
{
Time.timeScale = 1;
}
// Reloading scene clear previous operation
if (ActiveScene.name == aSceneName)
{
loadingOperation.Operation = null;
}
StartCoroutine(ProcessLoadingScene(aSceneName, loadingOperation));
}
/// <summary>Preload the given level</summary>
/// <param name="aSceneName">Scene to load</param>
/// <param name="aPostFadeAction">Action to perform after the initial fade</param>
public void PreloadScene(string aSceneName)
{
if (FindSceneContainer(aSceneName) == null)
{
loadingOperations[aSceneName] = new LoadingOperation(SceneManager.LoadSceneAsync(aSceneName, LoadSceneMode.Additive));
}
}
public LoadingOperation GetLoadingOperation(string aKey)
{
LoadingOperation data = null;
loadingOperations.TryGetValue(aKey, out data);
return(data);
}
public T GetLoadingData <T>(string aSceneName, string aKey)
{
LoadingOperation operation = null;
loadingOperations.TryGetValue(aSceneName, out operation);
object value = null;
if (operation != null)
{
value = operation.GetDataValue <T>(aKey);
}
return((T)value);
}
private IEnumerator ProcessLoadingScene(string aSceneName, LoadingOperation aLoadingOperation)
{
yield return(WaitForTransition(true));
// Display loading scene
SceneContainer loadingScene = FindSceneContainer(loadingSceneName);
if (loadingScene == null)
{
yield return(SceneManager.LoadSceneAsync(loadingSceneName, LoadSceneMode.Additive));
loadingScene = FindSceneContainer(loadingSceneName);
}
loadingScene.ObjectsContainer.SetActive(true);
yield return(WaitForTransition(false));
// Clear the active scenes loading operation unless we are reloading the same scene
if (ActiveScene.name != aSceneName)
{
loadingOperations.Remove(ActiveScene.name);
}
// Unload current scene
yield return(SceneManager.UnloadSceneAsync(ActiveScene));
// If we didn't preload the scene then load it now
if (aLoadingOperation.Operation == null)
{
aLoadingOperation.Operation = SceneManager.LoadSceneAsync(aSceneName, LoadSceneMode.Additive);
}
float elapsedTime = Time.time;
// Wait for the scene to complete loading
while (aLoadingOperation.Operation.isDone == false)
{
yield return(null);
}
SceneContainer scene = FindSceneContainer(aSceneName);
// Unload all scenes that aren't the active loading scenes
for (int i = SceneManager.sceneCount - 1; i >= 0; i--)
{
string activeSceneName = SceneManager.GetSceneAt(i).name;
if (activeSceneName != aSceneName && activeSceneName != loadingSceneName)
{
yield return(SceneManager.UnloadSceneAsync(activeSceneName));
loadingOperations.Remove(activeSceneName);
}
}
// Set the current scene to be the primary active one. This is required otherwise objects will be instantiated into the wrong scene.
SceneManager.SetActiveScene(FindScene(aSceneName));
scene.ObjectsContainer.SetActive(true);
// Wait for a completion event if the scene requires one
if (scene.RequiresCompletionEvent)
{
while (sceneLoadingCompleted == false)
{
yield return(null);
}
sceneLoadingCompleted = false;
}
yield return(WaitForTransition(true));
yield return(new WaitForEndOfFrame());
// Unload/Disable loading scene
if (retainLoadingScene)
{
FindSceneContainer(loadingSceneName).ObjectsContainer.SetActive(false);
}
else
{
yield return(SceneManager.UnloadSceneAsync(loadingSceneName));
}
// Too keep memory low ensure unused assets are cleared upon loading
yield return(Resources.UnloadUnusedAssets());
// Run an additional callback before the loading fades out into the active scene
if (loadingPreFadeOutCallback != null)
{
loadingPreFadeOutCallback();
loadingPreFadeOutCallback = null;
}
// Add an additional time offset if we don't want the loading screen to possibly blink
elapsedTime = Time.time - elapsedTime;
if (elapsedTime <= minLoadingTime)
{
yield return(new WaitForSeconds(minLoadingTime - elapsedTime));
}
// Fade into the newly loaded scene
yield return(WaitForTransition(false));
yield return(new WaitForEndOfFrame());
// Run a callback once the scene is in view
if (loadingCompletionCallback != null)
{
loadingCompletionCallback();
loadingCompletionCallback = null;
}
loading = false;
}