Unity Addressable的基本使用

已于 2023-04-18 17:40:29 修改
阅读量2.7k 收藏 11
点赞数 3
分类专栏： Unity 文章标签： unity
于 2023-04-14 00:00:24 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/EdmundRF/article/details/130133242
版权

文章目录

1、设置

1.1 AddressableAssetSettings 基本配置

在这里插入图片描述

一般只需关注以下4个选项

  • Disable Catalog Update On Startup
    默认是没有勾选的，没有勾选，那么每次AddressableAsset(下称AA)系统初始化的时候，会自动更新catalog文件，勾选上，将不会自动更新catalog文件，也就意味着不会自动更新资源。AA系统的初始化会在任意接口第一次调用时初始化，也可以主动调用Addressables.InitializeAsync()初始化。
  • Build Remote Catalog
    默认没有勾选，只有勾选上才会创建catalog在指定目录（.hash和.json文件），记录着此次打包的资源信息，可用于在线更新，客户端通过下载这个catalog来进行对比更新。
  • Send Profiler Events
    调试用，允许加载资源的时候发送事件给EventViewer，可以通过这个工具查看资源的使用情况。
  • Log Runtime Exception
    输出加载资源时的异常，开启时如果资源加载发生异常，会直接抛出。如果关闭，我们也可以通过加载资源时返回的句柄，来获取到异常信息。同时我们也可以给项目添加宏ADDRESSABLES_LOG_ALL，来查看更多的日志信息。

1.2 资源管理窗口

Play Mode Script

在这里插入图片描述

  • Use Asset Database（快速模式）
    直接加载文件而不打包，快速但Profiler获取的信息较少。可以让你在完成游戏流程开发的同时也能快速运行游戏。它直接从asset database中加载资源，以便于游戏快速迭代，在这个过程中没有任何资源分析和asset bundle构建。
  • Simulate Groups（虚拟模式）
    在不打包的情况下模拟靠近AB的操作；与快速模式不同，您可以查看哪个AB包含资产。只会分析资源结构和依赖关系，但是不会创建asset bundle。资源是通过ResourceManager从asset database中加载而来，整个过程和从bundle中加载一样。所以可以在Addressables Event Viewer 窗口中查看资源的使用情况，以及bundle在游戏运行时的加载和卸载情况。
    你可以通过Simulate Groups模式的模拟asset bundle加载来帮助你调整asset group，让整个资源结构在非常平衡状态下发布APP。
  • Use Existing Build（打包模式）
    非常接近发布版本的加载方式。但这需要先执行资源构建。在你没有修改资源的前提下，这将是最快进入游戏的模式，因为在运行时不需要处理任何数据。所以在这个模式下运行APP前，你需要在Addressables Groups窗口（Window > Asset Management > Addressables > Groups）中，选择菜单 Build > New Build > Default Build Script或者使用AddressableAssetSettings.BuildPlayerContent()来构建资源。

资源配置

在这里插入图片描述

  • 1：资源名（可自定义）
  • 2：标签（用于批量加载）
    （后续可以通过标签或者名字加载资源）

1.3 Profiles 路径配置

在这里插入图片描述
在这里插入图片描述
（可自定义）

  • LocalBuildPath
    本地端打包路径
  • LocalLoadPath
    本地端加载路径
  • RemoteBuildPath
    远端打包的本地路径
  • RemoteLoadPath
    远端加载的地址路径

1.4 Group 资源组

在这里插入图片描述
在这里插入图片描述

Content Update Restriction

在这里插入图片描述
这个配置只有两个选项，用于表示这个包是静态的还是非静态的，

  • Can Chang Post Release: 非静态包，可以在AB包发布后被修改
  • Cannot Chang Post Release: 静态包，AB包在发布后不能再被修改

静态资源随APP一起发布（或者安装后立即下载），它们分散在少数非常大的bundle中。动态资源放在网络上，通常都是很小的bundle，以减少每次更新数量。所以Addressable Assets System的目标之一就是，更容易使用和修改，并且不需要修改你的脚本。

Content Packing & Loading

在这里插入图片描述

这个配置用于配置打包信息，告诉AA系统，这个Group将如何打包，打包粒度，以及打出来的AB包存放在哪个位置，还有就是这个包里面的资源，应该在哪里加载，最终打包后，这个Group的位置信息，加载地址，还会被catalog记录。

  • Build And Load Paths: 决定AB包的存放位置和加载位置
  • Assets Bundle Compression: AB包的压缩方式
  • Include In Build: 默认勾选的，只有勾选上才会进行打包
  • BundleMode: AB包打包粒度，有三种选项
    – PackTogether: 把整个Group中的资源打包成一个AB包
    – PackSeparately: 每个资源各自打包为AB包
    – PackTogetherByLabel: 根据标签来决定哪些资源应该打成一个AB包
  • Bundle Naming Mode: AB包文件名命名方式
    – Filename: 文件名本身
    – Append Hash to Filename(默认): 文件名+Hash值
    – Use Hash of AssetBundle: AB包的Hash值
    – Use Hash of Filename: 文件名的Hash值

Resources and Built In Scenes

在这里插入图片描述
这个配置只有两个变量，一般不太会使用这个配置，所以默认都只会添加前面两个Schema

  • Include Resources Folders: 是否包含Resources文件夹中的资源，这个文件夹是Unity的一个特殊的文件夹，在这个文件夹下的资源在发布时都会包含在包体中，所以一般我们是不会包含这个文件夹中的资源的。
  • Include Build Settings Scenes: 是否包含Build Setting 中拖入的场景，一般情况下我们可以直接把场景拖入到Group中，没必要使用这个选项来自动包含，反而不直观。

2、资源在线下载/更新

详见：https://blog.csdn.net/u011366226/article/details/104506802/

3、脚本化

官方文档：https://docs.unity3d.com/Packages/com.unity.addressables@1.3/api/index.html

  • AddressableAssetSettings.BuildPlayerContent()
    执行打包

3.1 Group

AddressableAssetSettings类

  • 新建Group
AddressableAssetGroup group = setting.Createroup("Group Name", false, false, false,
	new List<addressableAssetGroupSchema> {setting.DefaultGroup.Schemas[0], Setting.DefaultGroup.Schemas[1] });

在这里插入图片描述

  • 查找Group（通过名字）
public AddressableAssetSettings setting;

AddressableAssetGroup group = setting.FindGroup("GroupName");

在这里插入图片描述

  • 添加资源进group
    （如果已有所属组，则移动到新组）
AddressableAssetEntry entry = setting.Create0rMoveEntry(guid, group):

在这里插入图片描述

AddressableAssetEntry类

  • 获取/修改名字
entry.address = "Address Name";

在这里插入图片描述
也可以用

entry.SetAddress("Address Name");

在这里插入图片描述

AddressableAssetGroup类

  • 获取Group上的组件
BundledAssetGroupSchema schema = group.GetSchema<BundledAssetGroupSchema>();

在这里插入图片描述
在这里插入图片描述

BundledAssetGroupSchema类

https://docs.unity3d.com/Packages/com.unity.addressables@1.17/api/UnityEditor.AddressableAssets.Settings.GroupSchemas.BundledAssetGroupSchema.html

ContentUpdateGroupSchema类

https://docs.unity3d.com/Packages/com.unity.addressables@1.17/api/UnityEditor.AddressableAssets.Settings.GroupSchemas.ContentUpdateGroupSchema.html

3.2 Profile

  • 获取 AddressableAssetProfileSetting
public AddressableAssetSettings setting;

AddressableAssetProfileSettings profileSet = setting.profileSettings;

在这里插入图片描述

  • 改变当前profile
setting.activeProfileld = profileId;

在这里插入图片描述

AddressableAssetProfileSetting类

  • 通过名字查找profile（返回id）
string id = profileSet.GetProfileld("Profile name")

在这里插入图片描述

  • 新建profile
profileSet.AddProfile("NewProfile name", profileSet.GetProfileId("Default"));

在这里插入图片描述

  • 修改profile的路径参数
profileSet.SetValue(id, "LocalBuildPath", "[UnityEngine.Application.streamingAssetsPath]/path01");
profileSet.SetValue(id, "LocalLoadPath", "{UnityEngine.Application streamingAssetsPath}/path0l");

在这里插入图片描述
注：有常量
AddressableAssetSettings.kLocalBuildPath = “LocalBuildPath”
AddressableAssetSettings.kLocalLoadPath = “LocalLoadPath”
建议使用

4、资源加载

  • Addressables.LoadAssetAsync(“Group中的路径”)
    （仅支持异步加载）
void Start()
{
	var handle = Addressables.LoadAssetAsync<GameObject>("Assets/Res/prefab/obj.prefab");
	handle.Completed += OnLoad;
}
void OnLoad(AsyncOperationHandle<Game0bject> handle)
{
	Instantiate(handle.Result);
}

在这里插入图片描述
官方在最新版中也提供了一种同步加载的方法：使用.WaitForCompletion()进行阻塞等待

var handle = Addressables.LoadAssetAsync<GameObject>("Assets/Res/prefab/obj.prefab");
handle.WaitForCompletion();
Instantiate(handle.Result);

5、资源释放

卸载分为两种方式，一种用于卸载不能实例化的资源（如Mat），一种用于卸载能实例化的资源（如GameObject）

5.1 不能实例化的资源卸载方式

public static void Release<T>(T obj);

obj: 资源
直接释放T类型的资源，并且减少引用计数

public static void Release(AsyncOperationHandle handle);

handle: 上面加载时LoadAssetAsync得到的handle
释放由该handle加载出来的资源，并减少引用计数

5.2 能实例化的资源卸载方式

public static bool ReleaseInstance(GameObject instance);

instance: 实例化的资源

销毁游戏物体，并且减少引用计数。如果用该方法卸载不是由寻址系统实例化的物体，那么释放不会产生影响。

public static bool ReleaseInstance(AsyncOperationHandle handle);

handle：同上

释放由该handle加载出来的资源，并减少引用计数

6、注意

当一个Resources文件夹内的资源被标记为Addressable时，系统会自动将它从Resources文件夹移出到Resources_moved的新文件夹。
• 默认的关联位置会指向原来的旧路路径。
• 原本的加载代码会从Resources.LoadAsync (“xxx.prefab”)变成 Addressables.LoadAssetAsync ( “xxx.prefab”);

7、旧资源方案迁移到Addressable

当工程已有Asset Bundles设置时，第一次打开Addressables菜单会询问是否要全部转入Addressables群组。

  • 使用资源有三种传统方法：
    ·直接引用：直接在组件上引用或者场景中使用。
    ·Resources文件夹：将资源添加到Resources文件夹并按文件名加载。
    ·Asset bundle：将资源打包到Asset bundle中，然后按文件路径加载它们和依赖项。

从直接引用迁移

要从这种方法迁移，按照下列步骤操作：
将对象的直接引用替换为AssetReference引用（例如，public GameObject obj; 变为public AssetReference obj;）。
将资源拖到对应组件的Inspector上，和原来直接引用一样（这个过程非addressable的资源会被自动标记为addressable）。
如果你要基于对象而不是字符串地址加载addressable资产，直接用AssetReference对象实例化该资产（例如AssetRefMember.LoadAssetAsync(); 或AssetRefMember.InstantiateAsync(pos, rot);）。
注意：addressable系统中是异步加载。当你将直接引用更新为AssetReference引用时，还必须将代码更新为异步操作。

从Resources文件夹迁移

当你将Resources文件夹中的资产标记为Addressable时，系统会弹框提示，你可以选择自动将资产从Resources文件夹移动到你项目中名为Resources_moved的新文件夹中。被移动的资产的默认地址是原来Resources目录下的旧路径，除了根目录变成了Resources_moved。

你的加载代码可能从Resources.LoadAsync(“desert/tank.prefab”); 变为Addressables.LoadAssetAsync(“desert/tank.prefab”);。

从Asset Bundle迁移

当你安装或打开Addressable系统窗口时，Unity会弹窗提示是否将所有Assetbundle包转换为Addressable组。
在这里插入图片描述
选择是的话会自动转换，每个ab包为一个Group；
如果你选择手动转换资产，选择”Ignore”。然后，使用前面介绍的直接引用或资源文件夹迁移方法。

一个资产的默认地址是它的文件路径。如果将文件路径用作资产的地址，则和之前用Assetbundle加载的方式相同。Addressable系统会处理加载asset bundle以及其依赖项。

8、与AssetBundle的差异

依赖项

无需再手动加载依赖包，Addressable会自动加载，并在无引用时自动释放（释放时机未知）。但要注意的是，手动释放只能释放手动加载的包，无法主动释放自动加载的依赖包。

加载路径

假设文件夹” Assets\Res\Effect\Logo\1001”为一个资源包，文件夹下有一个"1001.prefab"
则可以直接用” Assets\Res\Effect\Logo\1001\1001.prefab”来加载物体，无需再先加载ab包然后加载物体

Unity使用远程IIS服务器进行Addressables资源更新
weixin_43312381的博客
02-07 1160
我使用的是含有公网IP的Win10主机使用的是IIS进行部署没有公网IP无法在外部网络访问,需要内网穿透或者其他方法。
Unity Addressable使用
最新发布
weixin_52110073的博客
12-29 726
8、当我们构建好之后会生成一些文件 红框标记的就是第四步设置的路径 然后找到这个路径下的文件夹会有一些资源 然后把这些资源上传到远端就可以使用了（注意第四步设置的远端IP上传文件记得保持一致）9、这里可以切换是使用本地还是远端 第一个是使用本地 第二个是模拟远端 第三个是使用构建好的远端资源。第一个buildpath是打包路径 如果设置了打包的时候就回打包在工程文件夹路径下+设置的路径。第二个loadpath是远端资源存放路径 可以是本地也可以是远端域名或IP地址。本次学习笔记就先记录到这里。
Unity-Addressable工具的使用
某不知名气人选手
08-25 1039
自己使用aa插件的经历，保存下载，方便以后自己观看，有不对的地方谦虚的请教。
Unity Addressables 使用说明（二）管理 Addressables
长脖鹿的博客
09-06 3733
在决定如何管理项目中的资源之前，先熟悉资源如何创建对其他资源的依赖关系。有关依赖关系的更多信息，请参阅。有关组织资源时需要考虑的策略的更多信息，请参阅。组是 Addressables 系统的主要组织单位。使用 Addressables Groups 窗口创建和管理组及其包含的资源。为了控制 Unity 在内容构建期间如何处理资源，将 Addressables 组织到组中，并根据需要为每个组分配不同的设置。有关如何组织资源的信息，请参阅。
Unity 之 Addressable可寻址系统 -- 可寻址系统使用介绍 -- 入门（三）
陈言必行 -- Unity游戏开发领域优质博主
01-12 3641
本篇文章带大家了解可寻址系统的目录和各个设置面板的属性介绍。
【Unity】Addressables插件-资源管理系统
热门推荐
weixin_42186644的博客
09-08 1万+
文章目录Addressable Asset System（可寻址资产系统）1. 背景2. Addressable系统介绍3. Addressable系统优势：4. Addressable系统与AssetBundle的区别Addressable系统的使用1. 安装2. Addressables管理窗口3. AddressableAssetSettings系统设置4. 资源组设置5. 标记资源6. 资源打包7. 加载资源8. 更新资源包9. 热更新代码和方案10. 资源自动分组11. 内存管理12. Addre
Unity+Addressable中文手册1106.pdf
01-08
- **基本概念**：Addressable 资产系统的核心理念是通过“地址”加载资源，无论是本地还是远程服务器上的资源。 - **异步加载**：支持异步加载资产，这意味着可以在后台加载资源而不阻塞主线程，从而提升用户体验。 ...
Unity Addressable魔改
ShowMe
07-10 455
Addressable 基于实际需求的魔改 或者一些笔记
Unity Addressable内存管理
u011366226的博客
02-25 7389
先看一个真机测试实例： 两个物体放在同一个Group里面 只创建Cube时，内存资源中只有Cube的材质球和贴图 同时创建了Cube和Sphere，内存资源中拥有两个材质球和贴图 此时只删除Cube，Cube的材质球和贴图不会被释放，当然场景内存（SceneMemory）肯定是释放了的 只有把Sphere也释放掉才会同时将两个材质球和贴图都从资源内存中释放。 所以一个Gro...
Unity-Addressable Demo工程
02-20
Unity-Addressable Demo工程 理解local和Remote分组，CanChange Post Release 和 Cannot Chage Post Release区别。
Addressables.unitypackage
06-07
Unity Addressables案例工程，需要2019.3.4或者以上
Unity Addressables 使用说明（一）概述
长脖鹿的博客
09-06 3027
Addressables 提供了一个可以随项目扩展的系统。您可以从一个简单的设置开始，然后随着项目复杂性的增加进行重组，并且只需最少的代码更改。例如，您可以从一组 Addressable 资源开始，Unity 会将其作为一个集合加载。然后，随着您添加更多内容，可以将资源拆分为多个组，以便在特定时间仅加载所需的资源。随着团队规模的增长，您可以创建单独的 Unity 项目来开发不同类型的资源。
Unity热更新笔记（二）Addressable基础使用
SangsDog的博客
08-28 5110
系列文章目录 提示：这里可以添加系列文章的所有文章的目录，目录需要自己手动添加 例如：第一章 Python 机器学习入门之pandas的使用 提示：写完文章后，目录可以自动生成，如何生成可参考右边的帮助文档 文章目录系列文章目录前言一、pandas是什么？二、使用步骤1.引入库2.读入数据总结 前言 提示：这里可以添加本文要记录的大概内容： 例如：随着人工智能的不断发展，机器学习这门技术也越来越重要，很多人都开启了学习机器学习，本文就介绍了机器学习的基础内容。 提示：以下是本篇文章正文内容，下面案例
Unity Addressable 快速使用
StrayInWorld的博客
06-21 7129
Unity Addressable 快速使用
Unity AA分包 - Addressables可寻址系统 入门教程
weixin_63623077的博客
05-30 3669
一、前言 AA包(Addressables Assets)相比于旧版AB包(Asset Bundle)的优点： ① AA包不需要知道资源的地址，可以直接用名称引用； ② Unity提供AA包的资源管理可视化界面； ③ AA包能自动管理资源卸载（当资源引用计数为0时）； ④ AA包能自动管理依赖关系：当资源1依赖于资源2时，AB包要求先将资源2加载，才能加载资源1；而AA包直接加载资源1，就能自动将依赖的资源2加载进来； ⑤ AA包支持远程资源加载以及热更新（热补丁）。
Unity 之 Addressable可寻址系统 -- 可寻址系统面板介绍 -- 入门（二）
陈言必行 -- Unity游戏开发领域优质博主
01-12 3481
本篇文章带大家了解可寻址系统的目录和各个设置面板的属性介绍。
unity Addressable 使用记录
qq_40795166的博客
12-14 1445
参考https://www.icode9.com/content-4-694479.html Unity新的资源管理系统 Addressable 正好学习到Unity新的资源管理系统 在这里给大家分享一下最近的一些想法 如果你也在学习 那么我这里可能有你需要的内容 （也可能没有） 经历的项目中 以前都是bundle去处理资源以及依赖关系，但是当内容过多时依赖关系及其不好处理（也可能是都这个样子） 这篇文章主要是实践 而非长篇大论的理论 我始终认为实践才是一个合格程序员的正途 废话不多说直接上干货 如
Unity学习之Addressable
qq_34123138的博客
06-24 1691
Unity学习之Addressable
CondaValueError: Malformed version string ~ : invalid character(s).
12-13
根据提供的引用内容，CondaValueError: Malformed version string ~ : invalid character(s) 是由于版本号格式错误导致的错误。可能是版本号中包含了非法字符。解决这个问题的方法是重新创建一个新的环境，或者清理当前环境并重新安装。具体步骤如下： 1. 清理当前环境 ```shell conda clean -i ``` 2. 创建一个新的环境 ```shell conda create -n py38 python=3.8 anaconda ``` 如果您仍然遇到问题，请检查您的版本号是否正确，并确保它不包含任何非法字符。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值