refactor : 重构网络下载模块

新增通用下载接口，扩展了默认的Unity引擎下载器
2026-01-05 19:44:10 +08:00
parent 1884fab0c2
commit c87efdb509
89 changed files with 2597 additions and 1641 deletions
@@ -0,0 +1,61 @@
+using System;
+using UnityEngine.Networking;
+
+namespace YooAsset
+{
+    /// <summary>
+    /// UnityWebRequest 字节下载器
+    /// </summary>
+    /// <remarks>
+    /// 将下载内容保存到内存中的字节数组。
+    /// </remarks>
+    internal sealed class UnityWebRequestBytesDownloader : UnityWebRequestDownloaderBase, IDownloadBytesRequest
+    {
+        private readonly DownloadDataRequestArgs _args;
+
+        /// <summary>
+        /// 下载结果（字节数组）
+        /// </summary>
+        public byte[] Result { get; private set; }
+
+        /// <summary>
+        /// 构造字节数组下载器
+        /// </summary>
+        /// <param name="args">数据下载参数</param>
+        /// <param name="webRequestCreator">UnityWebRequest 创建器（可选）</param>
+        public UnityWebRequestBytesDownloader(DownloadDataRequestArgs args, UnityWebRequestDelegate webRequestCreator)
+            : base(args.URL, webRequestCreator)
+        {
+            _args = args;
+        }
+
+        /// <summary>
+        /// 创建 UnityWebRequest
+        /// </summary>
+        protected override void CreateWebRequest()
+        {
+            var handler = new DownloadHandlerBuffer();
+            _webRequest = CreateUnityWebRequestGet(URL);
+            _webRequest.downloadHandler = handler;
+            _webRequest.disposeDownloadHandlerOnDispose = true;
+            ApplyRequestOptions(_args.Timeout, _args.WatchdogTime, _args.Headers);
+        }
+
+        /// <summary>
+        /// 请求成功时的回调
+        /// </summary>
+        protected override void OnRequestSucceed()
+        {
+            var fileData = _webRequest.downloadHandler.data;
+            if (fileData == null || fileData.Length == 0)
+            {
+                Status = EDownloadRequestStatus.Failed;
+                Error = $"[{GetType().Name}] URL: {URL} - Download bytes data is null or empty !";
+            }
+            else
+            {
+                Result = fileData;
+            }
+        }
+    }
+}