feat: Added scene switch started event with internal Unity progress exposed

Author: TwoTenPvP

MLAPI/SceneManagement/NetworkSceneManager.cs

@@ -23,9 +23,17 @@ public static class NetworkSceneManager
         /// </summary>
         public delegate void SceneSwitchedDelegate();
         /// <summary>
+        /// Delegate for when a scene switch has been initiated
+        /// </summary>
+        public delegate void SceneSwitchStartedDelegate(AsyncOperation operation);
+        /// <summary>
         /// Event that is invoked when the scene is switched
         /// </summary>
         public static event SceneSwitchedDelegate OnSceneSwitched;
+        /// <summary>
+        /// Event that is invoked when a local scene switch has started
+        /// </summary>
+        public static event SceneSwitchStartedDelegate OnSceneSwitchStarted;
 
         internal static readonly HashSet<string> registeredSceneNames = new HashSet<string>();
         internal static readonly Dictionary<string, uint> sceneNameToIndex = new Dictionary<string, uint>();
@@ -105,12 +113,18 @@ public static SceneSwitchProgress SwitchScene(string sceneName)
 
             // Switch scene
             AsyncOperation sceneLoad = SceneManager.LoadSceneAsync(sceneName, LoadSceneMode.Single);
+
             nextSceneName = sceneName;
 
             sceneLoad.completed += (AsyncOperation asyncOp2) => { OnSceneLoaded(switchSceneProgress.guid, null); };
 
             switchSceneProgress.SetSceneLoadOperation(sceneLoad);
 
+            if (OnSceneSwitchStarted != null)
+            {
+                OnSceneSwitchStarted(sceneLoad);
+            }
+
             return switchSceneProgress;
         }
 
@@ -137,12 +151,18 @@ internal static void OnSceneSwitch(uint sceneIndex, Guid switchSceneGuid, Stream
             string sceneName = sceneIndexToString[sceneIndex];
 
             AsyncOperation sceneLoad = SceneManager.LoadSceneAsync(sceneName, LoadSceneMode.Single);
+
             nextSceneName = sceneName;
 
             sceneLoad.completed += (AsyncOperation asyncOp2) =>
             {
                 OnSceneLoaded(switchSceneGuid, objectStream);
             };
+
+            if (OnSceneSwitchStarted != null)
+            {
+                OnSceneSwitchStarted(sceneLoad);
+            }
         }
 
         internal static void OnFirstSceneSwitchSync(uint sceneIndex, Guid switchSceneGuid)