文档

Unity 引擎

Unity 引擎

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>
    描述了类型
    T
    的字段和 Properties。Unity 会生属性,以便System可以枚举您类型的Properties。
  • 访客:您可以使用
    Visit<TContainer, TValue>
    之类的回调实现访问者。该框架遍历容器的Properties并根据属性调用逻辑。
  • 适配器:用于自定义访问或转换指定类型的方式的钩子(例如,对
    Vector3
    、枚举、Collections的特殊处理)。
  • 属性路径和遍历:支持通过具有受控 Depth 和选项的路径嵌套容器、数组、字典和寻址值。
有关使用这些功能的更多 Detailed 示例,请参阅使用
PropertyVisitor
创建属性访问者
和使用低关卡 API 创建属性访问者。

其他资源