feat(ResourceManager): 添加资源加载耗时统计功能

AlianBlank · AlianBlank · commit fa5cf5fdc2be · 2026-03-16T14:23:28.000+08:00
- 在 ProviderOperation 中添加 Duration 字段和加载时间记录方法
- 在 HandleBase 中暴露 Duration 属性
- 所有 Provider 在 InternalOnStart 中开始记录加载时间
diff --git a/Runtime/ResourceManager/Handle/HandleBase.cs b/Runtime/ResourceManager/Handle/HandleBase.cs
@@ -90,6 +90,22 @@ public float Progress
             }
         }
 
+        /// <summary>
+        /// 加载耗时
+        /// </summary>
+        public long Duration
+        {
+            get
+            {
+                if (IsValidWithWarning == false)
+                {
+                    return 0;
+                }
+
+                return Provider.Duration;
+            }
+        }
+
         /// <summary>
         /// 是否加载完毕
         /// </summary>
@@ -195,4 +211,4 @@ object IEnumerator.Current
 
         #endregion
     }
-}
+}
diff --git a/Runtime/ResourceManager/Provider/BundledAllAssetsProvider.cs b/Runtime/ResourceManager/Provider/BundledAllAssetsProvider.cs
@@ -1,4 +1,4 @@
-﻿using System.Collections;
+using System.Collections;
 using System.Collections.Generic;
 using UnityEngine;
 
@@ -18,6 +18,7 @@ public BundledAllAssetsProvider(ResourceManager manager, string providerGUID, As
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
             DebugBeginRecording();
         }
 
diff --git a/Runtime/ResourceManager/Provider/BundledAssetProvider.cs b/Runtime/ResourceManager/Provider/BundledAssetProvider.cs
@@ -1,4 +1,4 @@
-﻿using System.Collections;
+using System.Collections;
 using System.Collections.Generic;
 using UnityEngine;
 
@@ -18,6 +18,7 @@ public BundledAssetProvider(ResourceManager manager, string providerGUID, AssetI
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
             DebugBeginRecording();
         }
 
diff --git a/Runtime/ResourceManager/Provider/BundledRawFileProvider.cs b/Runtime/ResourceManager/Provider/BundledRawFileProvider.cs
@@ -1,4 +1,4 @@
-﻿namespace YooAsset
+namespace YooAsset
 {
     [UnityEngine.Scripting.Preserve]
     internal class BundledRawFileProvider : ProviderOperation
@@ -11,6 +11,7 @@ public BundledRawFileProvider(ResourceManager manager, string providerGUID, Asse
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
             DebugBeginRecording();
         }
 
diff --git a/Runtime/ResourceManager/Provider/BundledSceneProvider.cs b/Runtime/ResourceManager/Provider/BundledSceneProvider.cs
@@ -1,4 +1,4 @@
-﻿using System.Collections;
+using System.Collections;
 using System.Collections.Generic;
 using System.IO;
 using UnityEngine;
@@ -32,6 +32,7 @@ public BundledSceneProvider(ResourceManager manager, string providerGUID, AssetI
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
             DebugBeginRecording();
         }
 
@@ -160,4 +161,4 @@ public void UnSuspendLoad()
             }
         }
     }
-}
+}
diff --git a/Runtime/ResourceManager/Provider/BundledSubAssetsProvider.cs b/Runtime/ResourceManager/Provider/BundledSubAssetsProvider.cs
@@ -1,4 +1,4 @@
-﻿using System.Collections;
+using System.Collections;
 using System.Collections.Generic;
 using UnityEngine;
 
@@ -18,6 +18,7 @@ public BundledSubAssetsProvider(ResourceManager manager, string providerGUID, As
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
             DebugBeginRecording();
         }
 
@@ -150,4 +151,4 @@ public override void InternalOnUpdate()
             }
         }
     }
-}
+}
diff --git a/Runtime/ResourceManager/Provider/CompletedProvider.cs b/Runtime/ResourceManager/Provider/CompletedProvider.cs
@@ -1,4 +1,4 @@
-﻿namespace YooAsset
+namespace YooAsset
 {
     [UnityEngine.Scripting.Preserve]
     internal sealed class CompletedProvider : ProviderOperation
@@ -11,6 +11,7 @@ public CompletedProvider(ResourceManager manager, AssetInfo assetInfo) : base(ma
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
         }
 
         [UnityEngine.Scripting.Preserve]
@@ -27,4 +28,4 @@ public void SetCompleted(string error)
             }
         }
     }
-}
+}
diff --git a/Runtime/ResourceManager/Provider/DatabaseAllAssetsProvider.cs b/Runtime/ResourceManager/Provider/DatabaseAllAssetsProvider.cs
@@ -1,4 +1,4 @@
-﻿using System.Collections;
+using System.Collections;
 using System.Collections.Generic;
 using UnityEngine;
 
@@ -15,6 +15,7 @@ public DatabaseAllAssetsProvider(ResourceManager manager, string providerGUID, A
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
             DebugBeginRecording();
         }
 
@@ -126,4 +127,4 @@ public override void InternalOnUpdate()
 #endif
         }
     }
-}
+}
diff --git a/Runtime/ResourceManager/Provider/DatabaseAssetProvider.cs b/Runtime/ResourceManager/Provider/DatabaseAssetProvider.cs
@@ -1,4 +1,4 @@
-﻿using System.Collections;
+using System.Collections;
 using System.Collections.Generic;
 using UnityEngine;
 
@@ -15,6 +15,7 @@ public DatabaseAssetProvider(ResourceManager manager, string providerGUID, Asset
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
             DebugBeginRecording();
         }
 
@@ -106,4 +107,4 @@ public override void InternalOnUpdate()
 #endif
         }
     }
-}
+}
diff --git a/Runtime/ResourceManager/Provider/DatabaseRawFileProvider.cs b/Runtime/ResourceManager/Provider/DatabaseRawFileProvider.cs
@@ -1,4 +1,4 @@
-﻿namespace YooAsset
+namespace YooAsset
 {
     [UnityEngine.Scripting.Preserve]
     internal class DatabaseRawFileProvider : ProviderOperation
@@ -11,6 +11,7 @@ public DatabaseRawFileProvider(ResourceManager manager, string providerGUID, Ass
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
             DebugBeginRecording();
         }
 
@@ -70,4 +71,4 @@ public override void InternalOnUpdate()
 #endif
         }
     }
-}
+}
diff --git a/Runtime/ResourceManager/Provider/DatabaseSceneProvider.cs b/Runtime/ResourceManager/Provider/DatabaseSceneProvider.cs
@@ -32,6 +32,7 @@ public DatabaseSceneProvider(ResourceManager manager, string providerGUID, Asset
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
             DebugBeginRecording();
         }
 
@@ -148,4 +149,4 @@ public void UnSuspendLoad()
             }
         }
     }
-}
+}
diff --git a/Runtime/ResourceManager/Provider/DatabaseSubAssetsProvider.cs b/Runtime/ResourceManager/Provider/DatabaseSubAssetsProvider.cs
@@ -1,4 +1,4 @@
-﻿using System.Collections;
+using System.Collections;
 using System.Collections.Generic;
 using UnityEngine;
 
@@ -15,6 +15,7 @@ public DatabaseSubAssetsProvider(ResourceManager manager, string providerGUID, A
         [UnityEngine.Scripting.Preserve]
         public override void InternalOnStart()
         {
+            BeginLoadTimeRecord();
             DebugBeginRecording();
         }
 
@@ -116,4 +117,4 @@ public override void InternalOnUpdate()
 #endif
         }
     }
-}
+}
diff --git a/Runtime/ResourceManager/Provider/ProviderOperation.cs b/Runtime/ResourceManager/Provider/ProviderOperation.cs
@@ -258,6 +258,7 @@ protected void ProcessFatalEvent()
         protected void InvokeCompletion(string error, EOperationStatus status)
         {
             DebugEndRecording();
+            EndLoadTimeRecord();
 
             _steps = ESteps.Done;
             Error = error;
@@ -316,6 +317,22 @@ public DownloadStatus GetDownloadStatus()
         /// 加载耗时（单位：毫秒）
         /// </summary>
         public long LoadingTime { protected set; get; }
+        /// <summary>
+        /// 加载耗时（单位：毫秒）
+        /// </summary>
+        public long Duration { private set; get; }
+
+        /// <summary>
+        /// 加载开始时间（单位：秒）
+        /// 使用UnityEngine.Time.realtimeSinceStartup记录，初始值为-1表示未开始
+        /// </summary>
+        private float _loadingStartTime = -1f;
+
+        /// <summary>
+        /// 加载结束时间（单位：秒）
+        /// 使用UnityEngine.Time.realtimeSinceStartup记录，初始值为-1表示未结束
+        /// </summary>
+        private float _loadingEndTime = -1f;
 
         // 加载耗时统计
         private Stopwatch _watch = null;
@@ -358,6 +375,46 @@ private void DebugEndRecording()
                 _watch = null;
             }
         }
+        /// <summary>
+        /// 开始记录加载时间（单位：秒）
+        /// 仅当尚未记录时，以 UnityEngine.Time.realtimeSinceStartup 赋值 _loadingStartTime
+        /// </summary>
+        [UnityEngine.Scripting.Preserve]
+        protected void BeginLoadTimeRecord()
+        {
+            if (_loadingStartTime < 0f)
+            {
+                _loadingStartTime = UnityEngine.Time.realtimeSinceStartup;
+            }
+        }
+
+        /// <summary>
+        /// 结束加载时间记录并计算总耗时
+        /// 1. 若 _loadingEndTime 未记录，则以当前 realtimeSinceStartup 赋值  
+        /// 2. 若 _loadingStartTime 仍未记录（异常场景），则将其设为与 _loadingEndTime 相同，避免负值  
+        /// 3. 计算耗时（毫秒），负值则取 0，最终写入 Duration 字段  
+        /// </summary>
+        [UnityEngine.Scripting.Preserve]
+        private void EndLoadTimeRecord()
+        {
+            if (_loadingEndTime < 0f)
+            {
+                _loadingEndTime = UnityEngine.Time.realtimeSinceStartup;
+            }
+
+            if (_loadingStartTime < 0f)
+            {
+                _loadingStartTime = _loadingEndTime;
+            }
+
+            var duration = (_loadingEndTime - _loadingStartTime) * 1000f;
+            if (duration < 0f)
+            {
+                duration = 0f;
+            }
+
+            Duration = (long)duration;
+        }
 
         /// <summary>
         /// 获取资源包的调试信息列表
@@ -376,4 +433,4 @@ internal void GetBundleDebugInfos(List<DebugBundleInfo> output)
 
         #endregion
     }
-}
+}

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-using System.Collections;`
	`1`	`+using System.Collections;`
`2`	`2`	`using System.Collections.Generic;`
`3`	`3`	`using UnityEngine;`
`4`	`4`
`@@ -18,6 +18,7 @@ public BundledAllAssetsProvider(ResourceManager manager, string providerGUID, As`
`18`	`18`	`[UnityEngine.Scripting.Preserve]`
`19`	`19`	`public override void InternalOnStart()`
`20`	`20`	`{`
	`21`	`+ BeginLoadTimeRecord();`
`21`	`22`	`DebugBeginRecording();`
`22`	`23`	`}`
`23`	`24`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-namespace YooAsset`
	`1`	`+namespace YooAsset`
`2`	`2`	`{`
`3`	`3`	`[UnityEngine.Scripting.Preserve]`
`4`	`4`	`internal class BundledRawFileProvider : ProviderOperation`
`@@ -11,6 +11,7 @@ public BundledRawFileProvider(ResourceManager manager, string providerGUID, Asse`
`11`	`11`	`[UnityEngine.Scripting.Preserve]`
`12`	`12`	`public override void InternalOnStart()`
`13`	`13`	`{`
	`14`	`+ BeginLoadTimeRecord();`
`14`	`15`	`DebugBeginRecording();`
`15`	`16`	`}`
`16`	`17`