cloudew / xasset

xasset 致力于为 Unity 项目提供一套精简稳健的资源管理环境

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

xasset

xasset 致力于为 Unity 项目提供了一套 精简稳健 的资源管理环境

主要特点

  • 致力于用最少的代码实现最健全的功能,并通过 Delegate 把 Runtime 部分的业务和 Editor 部分的业务剥离,没有为了模式而模式或者为了设计而设计的累赘代码
  • 自动管理 AssetBundle 的依赖的加载和卸载,在 Editor 下提供了敏捷高效的开发模式,不构建 AssetBundle 也可以加载相关的资源,对应还提供了 Runtime 模式,走构建后的加载流程
  • 基于内建的引用计数机制确保资源不会重复加载和轻易卸载,并对提供了给资源设置关注对象的机制,在对象被销毁时,底层自动释放资源引用计数,当引用计数为 0 时,再自动卸载资源
  • 支持 Buildin 和 AssetBundle 中的场景,以及 WWW 和 AssetBundle 中的常规资源的加载和卸载,并都提供了同步和异步的加载模式,和基于离散文件的资源版本更新机制,以及一系列的批处理打包工具

接口说明

Assets.Initialize

系统唯一的初始化接口,为更好的兼容 WebGL,初始化内部采用异步实现,对业务层使用输入的 Callback 函数 OnSucces 和 OnError 进行状态返回

Assets.LoadScene/Assets.UnloadScene

主要用来对 Buildin 和 AssetBundle 中的场景进行加载(同步/异步)和卸载。此外,对于场景的卸载,还可以通过调用加载时返回的 SceneAsset 对象的 Release 方法来卸载

Assets.Load(Async)/Assets.Unload

主要用来对 WWW 和 AssetBundle 中的资源进行加载(同步/异步)和卸载,同上,对于资源的卸载,还可以通过调用加载时返回的 Asset 对象的 Release 方法来卸载

Asset.Release

资源在 Load 后如果不想用了,就调用这个接口释放资源的引用计数,引用计数为 0 时,底层会对资源进行回收处理

Asset.Require

让资源关注输入的 Unity 对象,当输入对象为空时,底层会自动释放对应的引用计数,用这种方式可以避免 基于 OnDestroy 回收资源时,对象销毁时可能不触发 OnDestroy 导致资源不能正常回收的问题,这个机制借鉴了ABSystem 的做法,具体可以点击链接查看 ​ Asset.text/Asset.bytes ​ 当通过 WebAsset 加载文本/二进制 时,可以通过这个属性访问 文本/二进制 的内容

Asset.progress ​ 资源加载进度

Asset.completed ​ 资源加载完成时的事件回调

Asset.isDone ​ 资源是否加载完成

Asset.error ​ 资源加载的错误

操作流程

打包

对于资源打包,建议集成官方的 AssetBundleBrowser 来检查 AssetBundle 中的资源冗余情况,打包的主要流程是:

  1. 标记 要打包的资源

  2. 生成 AssetBundle

  3. 生成 播放器

下面是框架中提供的一些辅助工具:

Assets/AssetBundles/按目录标记

同一个目录下的资源一个AssetBundle ​ Assets/AssetBundles/按文件标记

每个文件一个AssetBundle,AssetBundle名称包含文件路径

Assets/AssetBundles/按名称标记

每个文件一个AssetBundle,AssetBundle名称不包含文件路径

Assets/AssetBundles/生成配置

对工程中的所有打包 AssetBundle 的资源生成 Manifest 文件,主要用来寻址

Assets/AssetBundles/生成資源包

将所有标记过的资源生成对应的 AssetBundle

Assets/AssetBundles/生成播放器

针对当前平台生产对应的可执行文件,例如 exe,apk,ipa(需要在安装了xcode的mac下进行)等

寻址

所有资源加载,会优先判断资源是否在 AssetBundle 中,然后再根据具体的资源类型分别执行对应的操作:

  1. 对于场景,不在 AssetBundle 中就从 Buildin 中的数据加载
  2. 对于常规资源,路径中以这些符号 http:// https:// file:// ftp:// 开头的,在AssetBundle 中的,会基于 WWW 的 AssetBundle 资源加载, 不在的则基于 WWW 的普通资源加载

更新

版本更新主要包括以下 3 个状态, 可以在框架中的 Demo 场景查看

  1. Check

    读取本地和远程资源版本,对比生成需要的下载的资源列表,如果列表的文件数量 > 0, 执行 Download,否则执行 Complete

  2. Download

    依次下载列表中的资源文件,下载完成后,完成更新执行 Complete

  3. Complete

    如果有下载更新,将下载的版本记录写入本地,并重新初始化完成资源热更

友情链接

  • QFramework Your first K.I.S.S Unity 3D Framework.

技术支持

Email: jiyuan.feng@live.com

QQ-group: 693203087

贡献成员

ezoic increase your site revenue

About

xasset 致力于为 Unity 项目提供一套精简稳健的资源管理环境

License:MIT License


Languages

Language:C# 99.6%Language:Shell 0.4%