Game Frame X Doc

Appearance

下载 ​

GameFrameX 的 Download 下载任务组件

Download 下载任务组件 (Download Component) - 提供管理下载队列、处理下载任务，并提供下载状态的实时更新。相关的接口。负责管理下载队列、处理下载任务，并提供下载状态的实时更新。

功能概述 ​

  • 管理多个下载任务
  • 支持断点续传功能
  • 提供下载任务的优先级设置
  • 实时更新下载进度和下载速度
  • 可以通过事件接收下载的各个阶段状态

基础用法 ​

要开始使用 DownloadComponent，需要在游戏对象上添加此组件。以下是一些核心属性的解释：

  • Paused: 获取或设置下载是否被暂停。
  • TotalAgentCount: 获取下载代理总数量。
  • FreeAgentCount: 获取可用下载代理数量。
  • WorkingAgentCount: 获取工作中下载代理数量。
  • WaitingTaskCount: 获取等待下载任务数量。
  • Timeout: 获取或设置下载超时时长。
  • FlushSize: 获取或设置写入磁盘的临界大小。
  • CurrentSpeed: 获取当前下载速度。

如何增加下载任务 ​

以下是添加下载任务的几种方法：

csharp
// 根据指定的下载路径和URI增加下载任务
public int AddDownload(string downloadPath, string downloadUri);

// 根据指定的下载路径、URI和任务标签增加下载任务
public int AddDownload(string downloadPath, string downloadUri, string tag);

// 根据指定的下载路径、URI和优先级增加下载任务
public int AddDownload(string downloadPath, string downloadUri, int priority);

// 根据指定的下载路径、URI和用户自定义数据增加下载任务
public int AddDownload(string downloadPath, string downloadUri, object userData);

如何移除下载任务 ​

可以通过任务的序列编号或者标签来移除下载任务：

csharp
// 根据序列编号移除下载任务
public bool RemoveDownload(int serialId);

// 根据标签移除下载任务
public int RemoveDownloads(string tag);

// 移除所有下载任务
public int RemoveAllDownloads();

事件通知 ​

DownloadComponent 提供事件，以便于当下载任务开始、更新、成功、失败时接收通知。

  • DownloadStart: 当下载开始时触发。
  • DownloadUpdate: 当下载更新时触发。
  • DownloadSuccess: 当下载成功时触发。
  • DownloadFailure: 当下载失败时触发。

初始化 ​

组件初始化时，它会设置其内部管理器，并为每个下载代理辅助器注册相应的事件。

csharp
protected override void Awake()
{
    base.Awake();
    // ...初始化代码...
}

示例 ​

要添加一个新的下载任务并接收其进度：

csharp
// 假设已经存在 downloadComponent 实例
int serialId = downloadComponent.AddDownload("本地存储路径", "下载链接");

// 通过事件组件订阅下载成功事件
eventComponent.Subscribe(DownloadSuccessEventArgs.EventId, OnDownloadSuccess);

// 下载成功回调
void OnDownloadSuccess(object sender, GameEventArgs e)
{
    DownloadSuccessEventArgs ne = (DownloadSuccessEventArgs)e;
    if (ne.SerialId == serialId)
    {
        // 处理下载成功
    }
}

注意：此组件依赖于Event 组件：https://github.com/GameFrameX/com.gameframex.unity.event

使用方式(任选其一) ​

  1. 直接在 manifest.json 的文件中的 dependencies 节点下添加以下内容

    json
    {
   "com.gameframex.unity.event": "https://github.com/GameFrameX/com.gameframex.unity.event.git",
   "com.gameframex.unity.download": "https://github.com/GameFrameX/com.gameframex.unity.download.git"
}

  2. 在Unity 的Packages Manager 中使用Git URL 的方式添加库,地址为：https://github.com/GameFrameX/com.gameframex.unity.download.git,

  3. 直接下载仓库放置到Unity 项目的Packages 目录下。会自动加载识别

QQ群:467608841