许可优化
许可优化
产品
产品
解决方案
解决方案
服务支持
服务支持
关于
关于
软件库
当前位置:服务支持 >  软件文章 >  Unity3D AssetBundle中的TypeTree数据解析分享

Unity3D AssetBundle中的TypeTree数据解析分享

阅读数 10
点赞 0
article_banner


好的,我们来深入探讨一下 Unity3D AssetBundle 中的 TypeTree 数据。这是一个相对底层但非常重要的概念,对于理解 Unity 的序列化系统和确保资源兼容性至关重要。

对惹,这里有一个游戏开发交流小组984358500,希望大家可以点击进来一起交流一下开发经验呀!

1. TypeTree 是什么?

简单来说,TypeTree 是描述 Unity 序列化数据结构的“元数据”或“模式(Schema)”。

当 Unity 将一个对象(如一个 Prefab、一个 Texture 或一个 MonoBehaviour 脚本实例)序列化到 AssetBundle 或 .asset 文件中时,它并不是存储为人类可读的文本(如 JSON 或 XML),而是一种紧凑的二进制格式。为了在反序列化时能够正确解读这些二进制数据,读取数据的代码必须知道:

  • 这个对象由哪些字段组成?每个字段是什么类型?(int, float, string, PPtr<Object>, 另一个结构体等)每个字段的顺序如何?字段的名称是什么?(在某些情况下)

TypeTree 就是用来存储这些信息的。它本质上是一个嵌套的数据结构,描述了序列化数据中每一个字节的含义。

2. 为什么需要 TypeTree?

TypeTree 的存在主要为了解决两个核心问题:

1. 版本兼容性与稳定序列化(Stable Serialization)

想象一下,你有一个项目在 Unity 2019.4 中创建了一个 AssetBundle,然后想在 Unity 2021.3 中加载它。在这期间,Unity 引擎内部的一些类(如 GameObject, Texture2D, Shader)的结构可能已经发生了变化(例如,添加了新字段、重命名字段、修改了继承关系)。

如果没有 TypeTree,新版本的 Unity 将无法正确解析旧版本序列化的数据,导致反序列化失败、资源损坏或崩溃。

TypeTree 机制确保了:

  • 向后兼容(读取旧数据):新版本 Unity 读取数据时,会使用数据自带的 TypeTree(来自旧版本)来理解其结构。即使新版本中类的定义已经改变,它也能通过对比字段名和类型,安全地跳过未知字段或使用默认值,从而最大限度地还原数据。向前兼容(写入新数据):序列化数据时,会将当前版本的类结构信息(TypeTree)一并写入。这样,即使用户在未来更新的 Unity 版本中加载,也能被正确解析。

2. 脚本类型(MonoBehaviour)的序列化

对于自定义的 MonoBehaviour 脚本,其序列化完全依赖于 TypeTree。Unity 的 C++ 端底层序列化代码并不知道你用 C# 写了什么类。当你构建 AssetBundle 时,Unity 会提取你脚本中所有 [Serializable] 字段的信息,并为这个脚本类型生成一个 TypeTree,然后将其与序列化的二进制数据一起打包。

这就是为什么你可以在一个没有源代码的项目(例如,仅使用了编译后的程序集)中,依然能够成功反序列化 AssetBundle 中的自定义脚本数据——因为 TypeTree 告诉反序列化器数据的布局。

3. TypeTree 的结构

一个 TypeTree 由多个 TypeTree Node 组成,每个节点描述一个字段。节点以深度优先的顺序排列,形成了一个树形结构。

每个节点通常包含以下信息(具体细节可能因 Unity 版本而异):

  • 字段名(Field Name): 例如 "m_Name", "m_Enabled", "localPosition"。类型名(Type Name): 例如 "int", "string", "Vector3", "PPtr<GameObject>"。大小(Size): 该字段占用的字节数。对于可变大小类型(如数组、字符串)或复杂类型,可能为 0 或 1,并有特殊规则。索引(Index): 在树中的位置。类型标志(Type Flags): 指示该类型的特性(例如,是否是 public 的 protected,是否是数组等)。版本(Version): 该节点/结构体被引入的版本,用于处理不同版本间的差异。元数据(Meta Flag): 其他标志位。子节点数量(Number of Children): 如果该字段是一个结构体或类,它会有子节点来描述其内部的字段。

示例:一个简单的类

[Serializable]

public class MyData {

public int health;

public Vector3 position;

}

它的 TypeTree 结构可能类似于:

  1. MyData (整体类型,有 2 个子节点) health (类型:SInt32,大小:4,子节点数:0)position (类型:Vector3,大小:12,子节点数:3)
  2. x (类型:float,大小:4,...)y (类型:float,大小:4,...)z (类型:float,大小:4,...)

4. 如何查看和管理 TypeTree?

1. 查看 TypeTree:

  • AssetBundle Browser Tool: Unity 官方提供的工具,在加载 AB 后可以以树形视图查看每个资源的 TypeTree。第三方工具: 如 AssetStudio、uTinyRipper 等,它们可以解析并显示 AssetBundle 中的 TypeTree,非常适合进行逆向工程或诊断问题。脚本 API: 在较新的 Unity 版本中,可以通过 AssetBundle.GetTypeTree() 和相关的 TypeTree API 以编程方式访问,但这主要用于高级工具开发。

2. 构建设置中的 TypeTree 选项:

在 Build AssetBundles 时,有一个关键选项:TypeTree (在 AssetBundle 构建设置的高级设置中)。

  • 启用(默认):将完整的 TypeTree 信息嵌入到 AssetBundle 中。这保证了最好的跨版本兼容性,但会略微增加文件大小。禁用:不将 TypeTree 信息嵌入 AssetBundle。这会使文件更小,但带来了严格的限制:
  • 加载环境必须与构建环境完全一致:即必须使用完全相同的 Unity 版本、完全相同版本的引擎 DLL 和所有相关的自定义脚本 DLL。任何细微差别都会导致反序列化失败。禁用 Stripping:不能使用 Managed Stripping Level,否则代码剥离可能会移除序列化所需的类,导致在设备上加载失败。

通常,除非你有极端的包体大小要求并且能严格控制构建和运行环境(例如,同一个游戏客户端内的热更新),否则强烈建议保持 TypeTree 启用。

总结

特性描述本质描述序列化数据结构的元数据(Schema)。目的1. 版本兼容:让不同版本的 Unity 能够互相读写资源。

2. 脚本支持:使序列化/反序列化自定义 MonoBehaviour 成为可能。结构由多个节点组成的树,以深度优先顺序描述每个字段的名称、类型、大小和层次关系。重要性AssetBundle 跨版本兼容性的基石。没有它,资源格式将非常脆弱。实践构建 AB 时通常不应禁用 TypeTree,除非你非常清楚由此带来的风险和限制。


理解 TypeTree 有助于你更好地处理资源加载错误、进行高级调试和优化包体大小,是深入掌握 Unity 资源管理的关键一步。


免责声明:本文系网络转载或改编,未找到原创作者,版权归原作者所有。如涉及版权,请联系删

相关文章
技术文档
QR Code
微信扫一扫,欢迎咨询~
customer

online

联系我们
武汉格发信息技术有限公司
湖北省武汉市经开区科技园西路6号103孵化器
电话:155-2731-8020 座机:027-59821821
邮件:tanzw@gofarlic.com
Copyright © 2023 Gofarsoft Co.,Ltd. 保留所有权利
遇到许可问题?该如何解决!?
评估许可证实际采购量? 
不清楚软件许可证使用数据? 
收到软件厂商律师函!?  
想要少购买点许可证,节省费用? 
收到软件厂商侵权通告!?  
有正版license,但许可证不够用,需要新购? 
联系方式 board-phone 155-2731-8020
close1
预留信息,一起解决您的问题
* 姓名:
* 手机:

* 公司名称:

姓名不为空

姓名不为空

姓名不为空
手机不正确

手机不正确

手机不正确
公司不为空

公司不为空

公司不为空