Unity Properties 简介
了解 Unity Properties API 的基础知识和用法。
阅读时间3 分钟最后更新于 6 天前
Unity Properties System允许您在运行时时探索和修改 C# 类型的Properties。它使用访问者样式 API,以可预测、可控的方式遍历Object图的 Properties。
您可以使用 Unity Properties 对 C# 类型进行通用读取或写入,只需进行最少的指定类型处理。这允许您使用自定义、用户定义的 C# 类型,例如验证它们,或在不同表示形式之间进行转换。
Unity Properties 可以避免或最大限度减少反射,因为反射相对较慢,会分配内存(会增加垃圾回收器开销),并且 Support 有限,尤其是在需要使用 IL2CPP 进行提前 (AOT) 编译的 ON 平台上。
Unity Properties 可用于以下常见情况:
-
数据验证和处理:
- 遍历Object图以验证范围、 null、引用或强制执行约束。
- Properties性计算差异、哈希或Change检测。
-
复制、克隆和修补:
- 通过访问和复制指定的 Properties 来深度复制容器或 Apply 补丁。
-
创作到运行时数据转化:
- 例如,通过属性历将 ScriptableObject 配置数据转换为运行时时structs)。
基本Features
Unity Properties 框架具有以下基本Features,可使用于通用手柄 C# 类型数据:
- 属性包:描述了类型
IPropertyBag<T>的字段和 Properties。Unity 会生属性,以便System可以枚举您类型的Properties。T - 访客:您可以使用 之类的回调实现访问者。该框架遍历容器的Properties并根据属性调用逻辑。
Visit<TContainer, TValue> - 适配器:用于自定义访问或转换指定类型的方式的钩子(例如,对、枚举、Collections的特殊处理)。
Vector3 - 属性路径和遍历:支持通过具有受控 Depth 和选项的路径嵌套容器、数组、字典和寻址值。
有关使用这些功能的更多 Detailed 示例,请参阅使用创建属性访问者和使用低关卡 API 创建属性访问者。
PropertyVisitor