Unity使用YooAsset实现资源热更新
妙妙的虚拟宝盒
2025年06月20日 10:30
收录于文集
共2篇

官网的文档其实很详细,以下的记录其实都是按照官网进行的

YooAsset官网:https://www.yooasset.com/ 

快速开始很简单,这边就不记录了,详细链接https://www.yooasset.com/docs/guide-editor/QuickStart

导入完成如下图

导入之后再行全局配置,通过右键创建配置文件(Project窗体内右键 -> Create -> YooAsset -> Create Setting)

注意:请将配置文件放在Resources文件夹下

然后就是资源的配置,当前项目的场景,我们把需要热更的资源都放在HotUpdate中

然后依次打开

创建一个包

然后这个包里面点击+可以创建组

修改一下组的名字,然后将文件夹直接拖到3的位置

然后我们依次添加组以及需要更新的文件夹,当然现在是资源热更,脚本还不能实现

将需要热更新的资源分类做好之后就可以按照如下图进行资源打包了

打包成功后直接弹出文件夹,具体内容在下方箭头所指的文件夹中

然后就是通过代码来实现初始化以及更新,以下代码完全是按照官网文档写的

代码块
text/x-csharp
自动换行
复制代码
using System;
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using YooAsset;

/// <summary>
/// LoadManager 是负责管理资源加载的核心类,根据不同的运行模式(编辑器模拟、离线单机、主机在线、Web)初始化资源系统,
/// 并处理资源下载、版本更新和场景加载等操作。
/// </summary>
public class LoadAssetsManager : MonoBehaviour
{
	/// <summary>
	/// 当前使用的播放模式。默认为编辑器模拟模式(EditorSimulateMode)。
	/// 可在 Inspector 中设置:
	/// - EditorSimulateMode:编辑器内模拟资源加载
	/// - OfflinePlayMode:本地资源包加载(单机)
	/// - HostPlayMode:从服务器下载资源并缓存
	/// - WebPlayMode:用于 WebGL 平台,通过 HTTP 加载资源
	/// </summary>
	public EPlayMode _playMode = EPlayMode.EditorSimulateMode;

	/// <summary>
	/// 默认的远程资源服务器地址(主用)
	/// </summary>
	public string defaultHostServer = "http://127.0.0.1/CDN/Android/v1.0";

	/// <summary>
	/// 备用的远程资源服务器地址(备用)
	/// </summary>
	public string fallbackHostServer = "http://127.0.0.1/CDN/Android/v1.0";

	/// <summary>
	/// 当前使用的资源包对象,所有资源操作都基于这个包进行
	/// </summary>
	ResourcePackage package;

	/// <summary>
	/// 需要加载的游戏场景名称
	/// </summary>
	public string loadSceneName;

	void Start()
	{
		// 初始化 YooAsset 系统
		YooAssets.Initialize();

		// 创建一个名为 "DefaultPackage" 的资源包
		package = YooAssets.CreatePackage("DefaultPackage");

		// 设置当前资源包为默认资源包,后续可以通过 YooAssets.LoadAsset 等方法直接调用
		YooAssets.SetDefaultPackage(package);

		// 启动协程开始初始化资源包
		StartCoroutine(InitPackage());
	}

	/// <summary>
	/// 根据不同播放模式初始化资源包
	/// 包括请求资源版本、更新清单、下载缺失资源等步骤
	/// </summary>
	private IEnumerator InitPackage()
	{
		InitializationOperation initOperation = null;

		switch (_playMode)
		{
			case EPlayMode.EditorSimulateMode:
				// 编辑器模式下使用模拟构建的资源目录
				var buildResult = EditorSimulateModeHelper.SimulateBuild("DefaultPackage");
				var packageRoot = buildResult.PackageRootDirectory;
				var editorFileSystemParams = FileSystemParameters.CreateDefaultEditorFileSystemParameters(packageRoot);
				var initParameters = new EditorSimulateModeParameters();
				initParameters.EditorFileSystemParameters = editorFileSystemParams;
				initOperation = package.InitializeAsync(initParameters);
				break;

			case EPlayMode.OfflinePlayMode:
				// 单机模式,使用内置资源(APK 内部或 StreamingAssets)
				var buildinFileSystemParams = FileSystemParameters.CreateDefaultBuildinFileSystemParameters();
				var offinitParameters = new OfflinePlayModeParameters();
				offinitParameters.BuildinFileSystemParameters = buildinFileSystemParams;
				initOperation = package.InitializeAsync(offinitParameters);
				break;

			case EPlayMode.HostPlayMode:
				// 主机模式,从远程服务器下载资源,并缓存在本地
				IRemoteServices remoteServices = new RemoteServices(defaultHostServer, fallbackHostServer);
				var cacheFileSystemParams = FileSystemParameters.CreateDefaultCacheFileSystemParameters(remoteServices);
				var hostbuildinFileSystemParams = FileSystemParameters.CreateDefaultBuildinFileSystemParameters();

				var hostinitParameters = new HostPlayModeParameters();
				hostinitParameters.BuildinFileSystemParameters = hostbuildinFileSystemParams;
				hostinitParameters.CacheFileSystemParameters = cacheFileSystemParams;
				initOperation = package.InitializeAsync(hostinitParameters);
				break;

			case EPlayMode.WebPlayMode:
				// Web 模式,适用于 WebGL 平台
				IRemoteServices webremoteServices = new RemoteServices(defaultHostServer, fallbackHostServer);
				var webServerFileSystemParams = FileSystemParameters.CreateDefaultWebServerFileSystemParameters();
				var webRemoteFileSystemParams = FileSystemParameters.CreateDefaultWebRemoteFileSystemParameters(webremoteServices); //支持跨域下载

				var webinitParameters = new WebPlayModeParameters();
				webinitParameters.WebServerFileSystemParameters = webServerFileSystemParams;
				webinitParameters.WebRemoteFileSystemParameters = webRemoteFileSystemParams;

				initOperation = package.InitializeAsync(webinitParameters);
				break;
		}

		// 等待初始化完成
		yield return initOperation;

		Debug.Log("初始化结果:" + initOperation.Status);
		if (initOperation.Status != EOperationStatus.Succeed)
		{
			Debug.LogError($"初始化失败: {initOperation.Error}");
			yield break;
		}

		// 请求最新的资源版本信息
		var requestOperation = package.RequestPackageVersionAsync();
		Debug.Log("正在请求最新的资源版本...");
		yield return requestOperation;

		string packageVersion = "";
		if (requestOperation.Status == EOperationStatus.Succeed)
		{
			packageVersion = requestOperation.PackageVersion;
			Debug.Log($"获取最新资源版本成功: {packageVersion}");
		}
		else
		{
			Debug.LogError("获取资源版本失败:" + requestOperation.Error);
		}

		// 更新资源清单
		var updateOperation = package.UpdatePackageManifestAsync(packageVersion);
		yield return updateOperation;

		if (updateOperation.Status == EOperationStatus.Succeed)
		{
			Debug.Log("资源清单更新成功");
		}
		else
		{
			Debug.LogError("资源清单更新失败:" + updateOperation.Error);
		}

		// 开始下载缺失资源
		yield return Download();
	}

	/// <summary>
	/// 下载缺失的远程资源
	/// </summary>
	IEnumerator Download()
	{
		int downloadingMaxNum = 10;   // 最大并发下载数
		int failedTryAgain = 3;       // 下载失败重试次数

		var downloader = package.CreateResourceDownloader(downloadingMaxNum, failedTryAgain);

		if (downloader.TotalDownloadCount == 0)
		{
			Debug.Log("没有需要下载的资源");
			yield return EnterGame(); // 直接进入游戏
		}

		// 注册回调函数
		downloader.DownloadFinishCallback = OnDownloadFinishFunction;
		downloader.DownloadErrorCallback = OnDownloadErrorFunction;
		downloader.DownloadUpdateCallback = OnDownloadUpdateFunction;
		downloader.DownloadFileBeginCallback = OnDownloadFileBeginFunction;

		// 开始下载
		downloader.BeginDownload();
		yield return downloader;

		if (downloader.Status == EOperationStatus.Succeed)
		{
			Debug.Log("资源下载成功");
			yield return EnterGame();
		}
		else
		{
			Debug.LogError("资源下载失败");
		}
	}

	/// <summary>
	/// 进入游戏场景
	/// </summary>
	IEnumerator EnterGame()
	{
		SceneHandle handle = package.LoadSceneAsync(loadSceneName);
		yield return handle;

		if (!handle.IsSucceed())
		{
			Debug.Log($"加载场景失败:{handle.SceneObject.name}");
		}
	}

	#region 下载回调函数

	/// <summary>
	/// 下载进度更新回调
	/// </summary>
	private void OnDownloadUpdateFunction(DownloadUpdateData data)
	{
		float progress = (float)data.CurrentDownloadBytes / (float)data.TotalDownloadBytes;
		Debug.Log($"总大小: {data.TotalDownloadBytes / 1024.0f / 1024} MB | 已下载: {data.CurrentDownloadBytes / 1024.0f / 1024} MB | 进度: {progress * 100:F2}%");
	}

	/// <summary>
	/// 开始下载某个文件时触发
	/// </summary>
	private void OnDownloadFileBeginFunction(DownloadFileData data)
	{
		Debug.Log($"开始下载文件:{data.FileName},大小:{data.FileSize / 1024.0f} KB");
	}

	/// <summary>
	/// 下载错误时触发
	/// </summary>
	private void OnDownloadErrorFunction(DownloadErrorData data)
	{
		Debug.LogError("下载错误");
	}

	/// <summary>
	/// 下载结束时触发(无论成功或失败)
	/// </summary>
	private void OnDownloadFinishFunction(DownloaderFinishData data)
	{
		Debug.Log("下载完成");
	}

	#endregion
}
internal class RemoteServices : IRemoteServices
{

	private readonly string _defaultHostServer;
	private readonly string _fallbackHostServer;

	public RemoteServices(string defaultHostServer, string fallbackHostServer)
	{
		_defaultHostServer = defaultHostServer;
		_fallbackHostServer = fallbackHostServer;
	}


	public string GetRemoteFallbackURL(string fileName)
	{
		return $"{_fallbackHostServer}/{fileName}";
	}

	public string GetRemoteMainURL(string fileName)
	{
		return $"{_defaultHostServer}/{fileName}";
	}
}
复制成功

然后新建一个场景,这个场景是不参与热更新的,挂载脚本,选择HostPlayMode,从服务器获取缓存,下面写上服务器地址,我是在本地模拟的,最后loadSceneName写资源加载完成后需要跳转的场景,记得是全路径

然后打包exe

双击打开进入了场景

测试热更,我们在场景中创建四个立方体,完成之后保存场景

修改完成后发现Scenes文件中增加了MainSettings和NewTerrain,因为同一个文件不能存放多种资源,我们再将资源分离出来重新配置

修改完后直接重新打包资源

将服务器上的资源替换成刚刚打包出来的,这里是用HFS来模拟服务器

然后执行Exe发现热更成功了

至此资源热更就实现了,当然这个只是基本的实现,如何通过代码加载以及在load时候进度的显示都没有完善,后续找机会再完善一下吧