1. 项目概述为什么我们需要自定义Authoring类如果你已经开始接触Unity的DOTSData-Oriented Technology Stack并且尝试过将一些简单的GameObject转换为Entity那么你一定用过ConvertToEntity组件。这个组件很方便但它更像是一个“黑盒”把整个GameObject及其子物体一股脑地转换成一个或多个Entity。对于快速原型或者简单的对象这没问题。但当我们开始构建一个稍微复杂点的系统比如一个RTS游戏里的士兵单位或者一个模拟城市里的建筑时问题就来了。这个士兵单位可能包含一个用于渲染的Mesh、一个用于碰撞的物理体、一个代表生命值的组件、一个代表所属阵营的标签、一个存储当前攻击目标的引用以及一堆用于行为树或状态机的数据。如果只用ConvertToEntity这些数据要么散落在不同的MonoBehaviour里转换逻辑混杂不清要么你不得不写一个庞大而复杂的IConvertGameObjectToEntity实现里面充满了if-else和GetComponent调用难以维护更违背了DOTS数据驱动、清晰分离的初衷。这就是自定义Authoring类登场的时刻。它不是一个高深莫测的黑魔法而是DOTS工作流中连接我们熟悉的面向对象编辑器世界GameObject, MonoBehaviour与高效的面向数据运行时世界Entity, ComponentData的设计桥梁。简单说它允许你为特定的、复杂的游戏对象类型定义一个专属的、可视化的、在Inspector里友好配置的“转换蓝图”。想象一下你有一个“炮塔”预制体。通过自定义Authoring类TurretAuthoring你可以在Inspector里直接设置炮塔的伤害值、攻击范围、炮弹预制体引用和开火速率。点击播放后TurretAuthoring会负责将这些配置值高效、准确地填充到一个包含TurretComponentData存储数值和TurretPrefabReference存储Entity引用的纯净Entity中。这比在运行时用GetComponent去一个个查找要高效和清晰得多。所以掌握自定义Authoring类核心是掌握一种设计模式。它让你能以一种可控、可预测的方式将编辑器中的设计意图翻译成DOTS运行时能高效处理的数据结构。这是从“能用DOTS”到“善用DOTS”的关键一步。2. 核心概念与设计思路拆解在动手写代码之前我们必须把几个关键概念和它们之间的关系理清楚。DOTS的转换流程看似复杂但一旦理解了其设计哲学就会变得非常直观。2.1 Authoring、Runtime Data与Conversion的世界DOTS架构明确区分了“编辑时”和“运行时”。Authoring创作期这就是我们在Unity编辑器中操作的阶段。我们使用GameObject、MonoBehaviour和预制体来搭建场景、配置参数。自定义的Authoring类本质上就是一个特殊的MonoBehaviour它挂载在GameObject上唯一目的就是持有数据并告诉Unity“嘿我这个对象需要被转换成Entity转换规则在我这里定义”。Runtime Data运行时数据这是SubsystemECS系统直接操作的对象。它们必须是IComponentData接口的结构体或Blob Asset、Dynamic Buffer等特点是纯数据、没有方法、尽可能简单以利于CPU缓存和并行处理。例如struct HealthComponent : IComponentData { public float Value; }。Conversion转换期这是连接上述两个世界的桥梁发生在进入Play模式或烘焙Baking时。转换系统会扫描场景中所有挂载了Authoring组件的GameObject并执行其定义的转换逻辑生成对应的Entity和ComponentData。自定义Authoring类的核心工作就是在Conversion阶段读取自身及关联GameObject上的配置数据然后创建或配置目标Entity为其添加或设置相应的Runtime Data。2.2 转换工作流的三种模式Unity提供了不同粒度和控制级别的转换方式理解它们的区别至关重要自动转换ConvertToEntity最简单。挂上这个组件Unity会尝试自动将GameObject及其子物体转换为Entity。它会为每个GameObject生成一个Entity并自动转换Transform、MeshRenderer等常见组件。控制力最弱适合简单对象或快速起步。基于接口的转换IConvertGameObjectToEntity在Authoring类中实现这个接口。它提供了一个Convert方法让你可以编写自定义逻辑来操作转换生成的Entity。这是自定义Authoring类最常用的方式。它给予你对单个GameObject如何转换为其对应Entity的完全控制权。基于系统的转换GameObjectConversionSystem最强大、最灵活。你可以创建自己的ConversionSystem在整个转换过程中对所有GameObject进行扫描和处理。它可以实现跨GameObject的依赖处理、批量操作、生成额外的管理Entity等复杂逻辑。控制力最强但复杂度也最高通常用于处理整个子系统或机制的转换如导航网格、场景光照数据的转换。对于大多数自定义游戏对象类型模式2IConvertGameObjectToEntity是我们的最佳选择。它平衡了控制力与复杂度让我们能专注于定义“我这个类型的对象应该包含什么数据”。2.3 设计一个自定义Authoring类的思考过程假设我们要为一个“收集品”比如金币创建Authoring类。设计思路应该是自顶向下的定义运行时需要什么数据Runtime Data一个收集品Entity需要什么一个CollectibleTag用于系统筛选一个RotationSpeed旋转速度一个PickupEffectPrefab拾取特效的Entity预制体引用先定义好这些IComponentData结构体。设计编辑时的配置界面Authoring创建一个CollectibleAuthoring : MonoBehaviour, IConvertGameObjectToEntity。它应该有哪些可配置的公共字段float RotationSpeed在Inspector里用滑块控制、GameObject PickupEffectPrefab拖拽一个预制体进来。这些字段就是为了方便设计师配置。实现转换逻辑Conversion在Convert方法里将RotationSpeed赋值给Entity的RotationSpeedComponent将PickupEffectPrefab通过GetEntity转换成一个EntityPrefabReference并附加给Entity。这个思考过程确保了我们的设计是数据驱动的Authoring类仅仅是一个友好的数据输入界面。3. 手把手创建第一个自定义Authoring类理论说再多不如动手做一遍。我们来创建一个经典的例子一个会上下漂浮、自身旋转的“能量晶体”。3.1 步骤一定义运行时组件首先我们定义这个晶体在运行时所需要的数据。在Runtime文件夹建议的代码组织方式下创建两个组件。// FloatComponent.cs - 用于上下漂浮 using Unity.Entities; public struct FloatComponent : IComponentData { public float Amplitude; // 浮动幅度 public float Frequency; // 浮动频率 public float InitialY; // 初始Y轴位置用于计算偏移 } // RotateComponent.cs - 用于自身旋转 using Unity.Entities; public struct RotateComponent : IComponentData { public float Speed; // 旋转速度度/秒 }这两个是纯粹的标签数据不包含任何逻辑。3.2 步骤二创建Authoring类并实现转换接下来创建Authoring类。我习惯把它放在Authoring文件夹下以明确其职责。// CrystalAuthoring.cs using UnityEngine; using Unity.Entities; public class CrystalAuthoring : MonoBehaviour, IConvertGameObjectToEntity { // 在Inspector中可配置的参数 public float floatAmplitude 0.5f; public float floatFrequency 1.0f; public float rotateSpeed 90.0f; public void Convert(Entity entity, EntityManager dstManager, GameObjectConversionSystem conversionSystem) { // 1. 添加浮动组件并设置数据 dstManager.AddComponentData(entity, new FloatComponent { Amplitude floatAmplitude, Frequency floatFrequency, InitialY transform.position.y // 记录转换时的初始高度 }); // 2. 添加旋转组件并设置数据 dstManager.AddComponentData(entity, new RotateComponent { Speed rotateSpeed }); // 注意这里我们没有处理Transform。因为ConvertToEntity或默认转换系统 // 会自动为带有Transform的GameObject生成LocalToWorld等Transform组件。 // 我们的FloatSystem和RotateSystem会去读写这些组件。 } }关键点解析IConvertGameObjectToEntity接口强制实现Convert方法。这是转换的核心。Convert方法参数entity: 这个GameObject将要转换成的目标Entity。系统已经为我们创建好了。dstManager:目标世界的EntityManager用于对目标Entity进行添加/移除组件、设置数据等操作。conversionSystem: 转换系统本身可以用来查询其他对象的转换结果例如通过GetPrimaryEntity获取另一个GameObject对应的Entity。AddComponentData: 这是为Entity添加组件并同时设置其初始值的标准方法。transform.position.y: 我们在转换时捕获了GameObject的初始世界Y坐标。这是一个非常重要的技巧。因为转换后GameObject的Transform数据会被处理成ECS的LocalToWorld等组件其值可能会被重置或基于父Entity重新计算。如果我们的浮动逻辑需要基于原始位置就必须在转换时把这个“初始状态”保存到自定义组件里。3.3 步骤三创建对应的ECS系统数据有了需要系统来驱动它们。创建两个简单的Job System。// FloatSystem.cs using Unity.Entities; using Unity.Jobs; using Unity.Mathematics; using Unity.Transforms; public partial class FloatSystem : SystemBase { protected override void OnUpdate() { float elapsedTime (float)Time.ElapsedTime; Entities .ForEach((ref LocalToWorld transform, in FloatComponent floatData) { // 计算新的Y轴位置初始位置 正弦波偏移 float newY floatData.InitialY math.sin(elapsedTime * floatData.Frequency) * floatData.Amplitude; // 获取当前的位置和旋转 float3 position transform.Position; quaternion rotation transform.Rotation; // 构造新的LocalToWorld矩阵 transform.Value float4x4.TRS( new float3(position.x, newY, position.z), rotation, new float3(1.0f, 1.0f, 1.0f) ); }).ScheduleParallel(); } } // RotateSystem.cs using Unity.Entities; using Unity.Jobs; using Unity.Mathematics; using Unity.Transforms; public partial class RotateSystem : SystemBase { protected override void OnUpdate() { float deltaTime Time.DeltaTime; Entities .ForEach((ref Rotation rotation, in RotateComponent rotateData) { // 绕Y轴旋转 quaternion deltaRotation quaternion.EulerXYZ(new float3(0, rotateData.Speed * deltaTime * math.PI / 180f, 0)); rotation.Value math.mul(rotation.Value, deltaRotation); }).ScheduleParallel(); } }3.4 步骤四在场景中测试在场景中创建一个Cube或Sphere命名为“EnergyCrystal”。移除默认的MeshRenderer和MeshFilter如果你用了其他渲染方案如Hybrid Renderer则按需处理。挂载ConvertToEntity组件这是触发转换的开关。挂载我们刚写好的CrystalAuthoring组件。在Inspector中调整floatAmplitude、floatFrequency和rotateSpeed参数。点击播放你应该能看到这个晶体一边旋转一边上下漂浮。至此你已经完成了第一个功能完整的自定义Authoring类。它成功地将编辑器中的配置参数转换成了ECS世界里驱动行为的纯净数据。4. 处理复杂依赖与引用现实项目中的对象很少是孤立的。一个炮塔需要引用炮弹预制体一个技能需要引用特效一个生产建筑需要引用它产出的单位。在DOTS中这些“引用”不再是GameObject或MonoBehaviour而是Entity或BlobAssetReference。处理这些依赖是自定义Authoring类的进阶课题。4.1 引用其他预制体Prefab Reference这是最常见的需求。我们希望Authoring类里能拖拽一个Prefab然后在运行时实例化它。错误做法在Convert方法里直接保存GameObject或Prefab的引用。这行不通因为转换后GameObject世界不存在了。正确做法使用转换系统GameObjectConversionSystem提供的GetPrimaryEntity方法将Prefab也转换成一个Entity并获取其引用。这个引用是一个Entity但它代表的是预制体模板。// TurretAuthoring.cs using UnityEngine; using Unity.Entities; public class TurretAuthoring : MonoBehaviour, IConvertGameObjectToEntity { public GameObject projectilePrefab; // 在Inspector中拖拽炮弹预制体 public void Convert(Entity entity, EntityManager dstManager, GameObjectConversionSystem conversionSystem) { // 关键步骤将GameObject预制体转换为Entity预制体引用 Entity projectileEntityPrefab conversionSystem.GetPrimaryEntity(projectilePrefab); // 将Entity引用存储到一个组件中 dstManager.AddComponentData(entity, new TurretShootingComponent { ProjectilePrefab projectileEntityPrefab, Cooldown 1.0f, Damage 10.0f }); } } // TurretShootingComponent.cs using Unity.Entities; public struct TurretShootingComponent : IComponentData { public Entity ProjectilePrefab; // 这里存储的是Entity引用 public float Cooldown; public float Damage; public float CurrentCooldown; }在炮塔的射击系统里你可以使用EntityManager.Instantiate(ProjectilePrefab)来创建炮弹Entity。重要提示GetPrimaryEntity方法要求被引用的Prefab也参与到转换流程中。通常这意味着它也需要挂载ConvertToEntity组件或者通过其他方式如放在Subscene中确保它被转换。如果引用的Prefab没有被转换GetPrimaryEntity可能会返回Entity.Null导致运行时错误。4.2 引用场景中的其他对象非预制体有时你需要引用场景中另一个特定的GameObject比如一个目标点、一个出生点。处理方式类似但需要确保被引用的对象先于引用它的对象完成转换。这通常不是问题因为转换顺序默认是基于场景层级或依赖关系的但为了安全你可以使用DeclareReferencedPrefab或依赖GameObjectConversionSystem的Dependency属性来处理。更简单的做法是如果这个引用是静态的比如场景装饰物之间的关联可以在Authoring中记录对方的GameObject然后在Convert中通过conversionSystem.GetPrimaryEntity(targetGameObject)来获取其Entity。同样要确保targetGameObject也被转换。4.3 处理Blob Asset引用复杂共享数据对于更复杂的、只读的共享数据如武器属性表、技能配置、AI行为树BlobAsset是比IComponentData更高效的选择。Authoring类也可以参与BlobAsset的创建。流程通常是在Authoring类中定义配置数据结构使用GameObject和普通字段。在Convert方法中使用BlobAssetBuilder来构造BlobAsset数据。通过conversionSystem.BlobAssetStore.AddUniqueBlobAsset来注册这个BlobAsset并获取一个BlobAssetReferenceT。将这个引用存储到目标Entity的某个组件中。由于BlobAsset的创建涉及非托管内存和序列化代码稍复杂但它对于共享只读数据的性能提升是巨大的。一个典型的例子是为所有同类型敌人共享一套属性// 1. 定义Blob数据结构 public struct EnemyStatsBlob { public float MaxHealth; public float MoveSpeed; public float AttackDamage; public BlobString Name; } // 2. 在Authoring的Convert中创建 public void Convert(Entity entity, EntityManager dstManager, GameObjectConversionSystem conversionSystem) { var builder new BlobBuilder(Allocator.Temp); ref EnemyStatsBlob stats ref builder.ConstructRootEnemyStatsBlob(); stats.MaxHealth maxHealth; stats.MoveSpeed moveSpeed; stats.AttackDamage attackDamage; builder.AllocateString(ref stats.Name, enemyName); var blobReference builder.CreateBlobAssetReferenceEnemyStatsBlob(Allocator.Persistent); builder.Dispose(); // 存储引用 dstManager.AddComponentData(entity, new EnemyStatsReference { Value blobReference }); }5. 高级技巧与最佳实践当你熟悉了基础操作后下面这些技巧能让你的Authoring类更健壮、更高效。5.1 利用[GenerateAuthoringComponent]属性简化流程对于非常简单的组件其Authoring类可能只是几个公共字段加上一个Convert方法。Unity提供了一个便捷属性[GenerateAuthoringComponent]可以自动为你生成这个Authoring类。// 在你的IComponentData结构体上添加这个属性 [GenerateAuthoringComponent] public struct HealthComponent : IComponentData { public float Value; }编译后Unity会自动生成一个名为HealthComponentAuthoring的MonoBehaviour它包含一个float Value字段并自动实现转换逻辑。你只需要把这个生成的组件挂到GameObject上即可。这极大地简化了简单组件的创建工作流。注意事项自动生成的Authoring类功能有限。它只能处理简单的字段类型float, int, Entity等无法处理复杂逻辑如引用其他Prefab、创建BlobAsset。对于复杂组件仍需手动编写Authoring类。5.2 转换中的依赖管理与执行顺序当你的转换逻辑依赖于其他GameObject的转换结果时比如上面获取其他Entity的引用执行顺序就变得重要。IConvertGameObjectToEntity的Convert方法调用顺序是不确定的。解决方案使用GameObjectConversionSystem。你可以创建自己的ConversionSystem并覆写OnUpdate方法。在这个系统里你可以通过Dependency属性确保所有IConvertGameObjectToEntity都执行完毕后再执行你的逻辑或者通过Entities.ForEach遍历所有具有特定Authoring组件的Entity来进行后处理。例如你需要在所有“队伍”对象转换完成后为每个“士兵”对象分配其所属队伍的Entity引用。这需要在ConversionSystem中分两步完成。5.3 调试转换过程Debug.Log与Entity Debugger转换过程在编辑模式下进行Debug.Log是可以正常工作的。在Convert方法中添加日志可以帮助你理解转换的触发时机和顺序。更强大的工具是Unity编辑器的Entity Debugger(Window Analysis Entity Debugger)。在播放模式下你可以查看所有存在的Entity、它们的组件数据。通过对比转换前后你可以清晰地看到你的Authoring类是否正确地为Entity添加了预期的组件和数据。这是调试DOTS转换问题的首选工具。5.4 性能考量与常见陷阱避免在Convert中进行昂贵操作Convert方法在进入播放模式时运行虽然不直接影响运行时帧率但过长的转换时间会影响测试迭代速度。避免在这里进行复杂的计算、同步加载资源等。谨慎使用GetComponent在Convert方法中如果需要获取同一GameObject上其他MonoBehaviour的数据使用GetComponent是可行的。但频繁调用或在不必要的对象上调用会影响转换性能。尽量将配置数据集中在一个Authoring类中。处理好Null引用Inspector中配置的字段可能为空。在Convert方法中务必对可能的null引用进行检查提供默认值或跳过某些逻辑避免运行时崩溃。Subscene与Live Conversion对于大型场景使用Subscene进行分批转换和流式加载是推荐做法。自定义Authoring类在Subscene中工作方式相同。注意开启“Live Conversion”时对Authoring组件属性的修改会实时触发部分转换这可能带来一些复杂性但也是强大的迭代工具。6. 实战案例构建一个简单的RTS单位让我们综合运用所学为一个极简的RTS游戏创建一个“士兵”单位的完整Authoring方案。这个士兵需要视觉表现、生命值、移动速度、攻击力、以及所属队伍的标识。6.1 定义运行时组件// Runtime/Components/UnitComponents.cs using Unity.Entities; // 生命值 public struct Health : IComponentData { public float Value; public float MaxValue; } // 移动属性 public struct MoveSpeed : IComponentData { public float Value; } // 攻击属性 public struct AttackDamage : IComponentData { public float Value; } // 队伍归属使用SharedComponent便于按队伍筛选 public struct Team : ISharedComponentData { public int Id; }6.2 创建士兵的Authoring类// Authoring/UnitAuthoring.cs using UnityEngine; using Unity.Entities; public class UnitAuthoring : MonoBehaviour, IConvertGameObjectToEntity { [Header(Basic Stats)] public float maxHealth 100f; public float moveSpeed 5f; public float attackDamage 10f; [Header(Team)] public int teamId 0; [Header(Visuals (Optional))] public GameObject selectionRingPrefab; // 选中时的光环效果预制体 public void Convert(Entity entity, EntityManager dstManager, GameObjectConversionSystem conversionSystem) { // 添加基础属性组件 dstManager.AddComponentData(entity, new Health { Value maxHealth, MaxValue maxHealth }); dstManager.AddComponentData(entity, new MoveSpeed { Value moveSpeed }); dstManager.AddComponentData(entity, new AttackDamage { Value attackDamage }); // 添加共享组件注意频繁改变SharedComponent会影响性能这里假设队伍不变 dstManager.AddSharedComponentData(entity, new Team { Id teamId }); // 处理可选视觉效果引用 if (selectionRingPrefab ! null) { Entity ringPrefabEntity conversionSystem.GetPrimaryEntity(selectionRingPrefab); if (ringPrefabEntity ! Entity.Null) { dstManager.AddComponentData(entity, new SelectionRingPrefab { Value ringPrefabEntity }); } else { Debug.LogWarning($Selection ring prefab for {gameObject.name} is not a convertible GameObject. Reference ignored., this); } } // 可以添加一个标签组件方便系统查询“所有士兵单位” dstManager.AddComponentUnitTag(entity); } } // 标签组件和预制体引用组件 public struct UnitTag : IComponentData {} public struct SelectionRingPrefab : IComponentData { public Entity Value; }6.3 创建对应的系统示例移动系统// Systems/UnitMoveSystem.cs using Unity.Entities; using Unity.Jobs; using Unity.Mathematics; using Unity.Transforms; public partial class UnitMoveSystem : SystemBase { protected override void OnUpdate() { float deltaTime Time.DeltaTime; Entities .WithName(MoveUnits) .ForEach((ref Translation translation, in MoveSpeed speed, in UnitMoveTarget target) { // 简单的向目标点移动逻辑 float3 direction target.Value - translation.Value; float distance math.length(direction); if (distance 0.1f) { direction math.normalize(direction); translation.Value direction * speed.Value * deltaTime; } }).ScheduleParallel(); } } // 移动目标组件可由其他系统如玩家输入系统设置 public struct UnitMoveTarget : IComponentData { public float3 Value; }6.4 在编辑器中配置与测试创建一个士兵的预制体例如一个胶囊体加上颜色材质。为预制体根节点添加ConvertToEntity组件。添加UnitAuthoring组件。在Inspector中配置maxHealth、moveSpeed、attackDamage和teamId。可选创建一个表示选中光环的简单圆形预制体拖拽到selectionRingPrefab字段。将预制体拖入场景点击播放。通过Entity Debugger你可以看到这个士兵Entity已经拥有了Health、MoveSpeed、AttackDamage、Team、UnitTag等所有组件。这个案例展示了一个中等复杂度的自定义Authoring类如何将设计师友好的编辑器配置系统地、结构化地转换为一套高效的ECS运行时数据为后续实现移动、攻击、选择等游戏逻辑打下了坚实的基础。通过这种方式即使是非常复杂的游戏对象其转换逻辑也能保持清晰和可维护。