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>
+    /// 将下载内容解析为 UTF-8 文本字符串。
+    /// </remarks>
+    internal sealed class UnityWebRequestTextDownloader : UnityWebRequestDownloaderBase, IDownloadTextRequest
+    {
+        private readonly DownloadDataRequestArgs _args;
+
+        /// <summary>
+        /// 下载结果（文本字符串）
+        /// </summary>
+        public string Result { get; private set; }
+
+        /// <summary>
+        /// 构造文本下载器
+        /// </summary>
+        /// <param name="args">数据下载参数</param>
+        /// <param name="webRequestCreator">UnityWebRequest 创建器（可选）</param>
+        public UnityWebRequestTextDownloader(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 fileText = _webRequest.downloadHandler.text;
+            if (string.IsNullOrEmpty(fileText))
+            {
+                Status = EDownloadRequestStatus.Failed;
+                Error = $"[{GetType().Name}] URL: {URL} - Download text data is null or empty";
+            }
+            else
+            {
+                Result = fileText;
+            }
+        }
+    }
+}