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,56 @@
+using System;
+using UnityEngine.Networking;
+
+namespace YooAsset
+{
+    /// <summary>
+    /// UnityWebRequest 文件下载器
+    /// </summary>
+    /// <remarks>
+    /// 将下载内容保存到本地文件，支持断点续传和追加写入。
+    /// </remarks>
+    internal sealed class UnityWebRequestFileDownloader : UnityWebRequestDownloaderBase, IDownloadFileRequest
+    {
+        private readonly DownloadFileRequestArgs _args;
+
+        /// <summary>
+        /// 文件保存路径
+        /// </summary>
+        public string SavePath
+        {
+            get { return _args.SavePath; }
+        }
+
+        /// <summary>
+        /// 构造文件下载器
+        /// </summary>
+        /// <param name="args">文件下载参数</param>
+        /// <param name="webRequestCreator">UnityWebRequest 创建器（可选）</param>
+        public UnityWebRequestFileDownloader(DownloadFileRequestArgs args, UnityWebRequestDelegate webRequestCreator)
+            : base(args.URL, webRequestCreator)
+        {
+            _args = args;
+        }
+
+        /// <summary>
+        /// 创建 UnityWebRequest
+        /// </summary>
+        protected override void CreateWebRequest()
+        {
+            var handler = new DownloadHandlerFile(_args.SavePath, _args.AppendToFile);
+            handler.removeFileOnAbort = _args.RemoveFileOnAbort;
+
+            _webRequest = CreateUnityWebRequestGet(URL);
+            _webRequest.downloadHandler = handler;
+            _webRequest.disposeDownloadHandlerOnDispose = true;
+
+            // 断点续传：设置 Range 请求头
+            if (_args.ResumeFromBytes > 0)
+            {
+                _webRequest.SetRequestHeader("Range", $"bytes={_args.ResumeFromBytes}-");
+            }
+
+            ApplyRequestOptions(_args.Timeout, _args.WatchdogTime, _args.Headers);
+        }
+    }
+}