跳到主要内容
版本:3.0.x

资源更新

学习如何进行资源文件的更新。

资源包下载

在补丁清单更新完毕后,就可以更新资源文件了。

根据产品需求,可以选择更新全部资源,或者只更新部分资源。

补丁包下载接口:

  • ResourcePackage.CreateResourceDownloader(ResourceDownloaderOptions options)

    用于下载更新当前资源版本所有的资源包文件,或通过指定 tag/tags 下载对应标签的资源包文件。

  • ResourcePackage.CreateResourceDownloader(BundleDownloaderOptions options)

    用于下载更新指定的资源列表依赖的资源包文件。

IEnumerator Download()
{
int downloadingMaxNum = 10;
int failedTryAgain = 3;
var package = YooAssets.GetPackage("DefaultPackage");
var downloader = package.CreateResourceDownloader(new ResourceDownloaderOptions(downloadingMaxNum, failedTryAgain));

//没有需要下载的资源
if (downloader.TotalDownloadCount == 0)
{
yield break;
}

//需要下载的文件总数和总大小
int totalDownloadCount = downloader.TotalDownloadCount;
long totalDownloadBytes = downloader.TotalDownloadBytes;

//注册回调方法
downloader.DownloadCompleted += OnDownloadCompletedFunction; //当下载器结束(无论成功或失败)
downloader.DownloadError += OnDownloadErrorFunction; //当下载器发生错误
downloader.DownloadProgressChanged += OnDownloadProgressChangedFunction; //当下载进度发生变化
downloader.DownloadFileStarted += OnDownloadFileStartedFunction; //当开始下载某个文件

//开启下载
downloader.StartDownload();
yield return downloader;

//检测下载结果
if (downloader.Status == EOperationStatus.Succeeded)
{
//下载成功
}
else
{
//下载失败
}
}

下载器合并

可以把同一个package下的多个下载器合并。

// 例如:把关卡资源下载器和某个指定资源下载器进行合并。
var downloader1 = package.CreateResourceDownloader(new ResourceDownloaderOptions("level_tag", downloadingMaxNum, failedTryAgain));
var assetInfo = package.GetAssetInfo("asset_location");
var downloader2 = package.CreateResourceDownloader(new BundleDownloaderOptions(assetInfo, false, downloadingMaxNum, failedTryAgain));
downloader1.Combine(downloader2);

//开启下载
downloader1.StartDownload();

源代码解析

Package.RequestPackageVersionAsync()方法解析。

  • 单机运行模式

    单机模式下请求的是应用程序内保存的版本文件,一般存放在StreamingAssets目录下。

  • 联机运行模式

    联机模式下请求的是远端的版本文件,该步骤可以自定义HTTP请求来代替,可以实现WEB端对请求版本的控制。