三亩地 三亩地SAN MU DI · CODE DIARY
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天,欢迎挑你感兴趣的翻一翻。

DOTween动画:TweenManager深度解析

DOTween动画:TweenManager深度解析

TweenManager是 DOTween 动画引擎最核心的数据中枢与底层调度器

TweenManager是控制所有动画生命周期、内存池、帧更新与批量操作的“大脑”。它采用全静态架构,通过原生数组与自定义算法实现了极致的零 GC(垃圾回收)和高效的内存复用。

以下是对TweenManager源码的核心机制与架构设计的深度拆解:

一、 核心数据结构与内存管理

TweenManager放弃了大部分 C# 动态容器(如List<T>),转而采用原生固定长度数组来管理活动与池化的动画对象,避免频繁扩容带来的内存碎片

  1. _activeTweens(Tween[]):存储当前所有正在运行的 Tween 的主数组,初始容量 250。

  2. _pooledTweeners(Tween[]):Tweener 对象池数组。

  3. _PooledSequences(Stack<Tween>):Sequence 容器池(采用栈存储)。

  4. _KillList(List<Tween>):专门用于在帧更新循环末尾进行批量延迟销毁的缓存列表。

  5. _TweenLinks(Dictionary<Tween, TweenLink>):存储通过.SetLink()与 UnityGameObject绑定的生命周期映射表。

二、 对象池与类型匹配机制 (GetTweener&GetSequence)

为了避免运行时产生 GC Alloc,DOTween 在创建动画时会优先尝试从对象池获取对象。

1. 泛型 Tweener 的精确类型匹配 (GetTweener<T1, T2, TPlugOptions>)

在 C# 中,TweenerCore<Vector3, Vector3, VectorOptions>TweenerCore<float, float, FloatOptions>是完全不同的类型。

  • 扫描与匹配GetTweener_maxPooledTweenerId倒序扫描_pooledTweeners数组。通过比较typeofT1typeofT2以及typeofTPlugOptions类型指针,精准取出完全符合泛型签名的空闲 Tweener 实例。

  • 自动扩容:若池中没有可复用的 Tweener,且总数已达到上限(maxTweeners),系统会自动触发IncreaseCapacities,按1.5 倍动态扩容数组。

2. 对象回收 (Despawn)

当 Tween 被 Kill 或播放完毕时:

  1. 触发t.onKill回调。

  2. t.isRecyclable == true,将 Tweener 放回_pooledTweeners数组,或将 Sequence 压入_PooledSequences栈。如果是 Sequence,还会递归回收其内部包含的所有子 Tween。

  3. 执行t.Reset()清空所有状态与回调,等待下次复用。

三、 延迟整理算法(Lazy Array Compaction)

在频繁创建和销毁动画时,如果直接从_activeTweens数组中移除元素(即整块向前平移),开销为 O(N)。TweenManager使用了延迟整理(Lazy Reorganization)策略:

1. 标记置空 (RemoveActiveTween)

  • 当一个 Tween 销毁时,系统仅将其在_activeTweens中的位置标记为null,设置t.activeId = -1

  • 记录最小断层起始位置_reorganizeFromId,并标记标志位_requiresActiveReorganization = true

2. 批量平移整理 (ReorganizeActiveTweens)

在下一帧的UpdateValidate或查询接口执行前,若_requiresActiveReorganizationtrue,系统会触发单次 O(N) 遍历:

// 源码逻辑简化:通过双指针一次性将非空元素左移,填补 null 破洞 for (int index = TweenManager._reorganizeFromId + 1; index < num2; ++index) { Tween activeTween = TweenManager._activeTweens[index]; if (activeTween == null) { ++num1; // 记录破洞数量 } else { activeTween.activeId = TweenManager._maxActiveLookupId = index - num1; TweenManager._activeTweens[index - num1] = activeTween; // 左移覆盖 TweenManager._activeTweens[index] = null; } }

这种设计将多次删除的平移开销合并为单次批量平移,大幅降低了 CPU 消耗。

四、 帧更新与双阶段销毁管线 (Update)

TweenManager.Update是驱动动画逐帧演进的核心函数,采用了双阶段处理机制,防止在遍历更新过程中修改数组导致索引异常。

Phase 1: 状态推进 (Update) ┌──────────────────────────────────┐ │ 遍历 _activeTweens │ │ ├── 评估 TweenLink (GameObject) │ │ ├── 计算 延迟 (Delay) │ │ ├── 计算 步进位置 (DoGoto) │ │ └── 若已结束/失效 ───────┐ │ └──────────────────────────┼───────┘ │ MarkForKilling ▼ ┌──────────────────┐ │ _KillList │ └──────────────────┘ │ Phase 2: 批量回收 (Despawn) ┌──────────────────────────┴───────┐ │ 遍历 _KillList │ │ └── 执行 Despawn() & 清空 _KillList│ └──────────────────────────────────┘

第一阶段:更新与步进

  1. 标记isUpdateLoop = true

  2. 线性遍历_activeTweens中对应UpdateType(Normal、Late、Fixed)的动画。

  3. 调用单体Update(Tween t, ...)

    • 处理TweenLink关联对象的activeInHierarchy状态。

    • 计算受timeScaleindependentTime修正后的实际增量时间。

    • 处理 Delay 延迟计时。

    • 调用Tween.DoGoto计算动画曲线、Ease 缓动与目标值赋权。

第二阶段:批量回收 (DespawnActiveTweens)

  • 当动画播放完毕(且autoKill == true)或中途被标记杀死时,不会直接从数组内拔除,而是放入_KillList

  • 主更新循环结束后,集中调用DespawnActiveTweens(_KillList)进行统一回收。

五、 统一批量操作接口 (FilteredOperation)

开发者常调用的 API(如DOTween.KillAll()DOTween.Pause(target)DOTween.Complete(id))在底层全部汇聚到了FilteredOperation函数中。

  1. 多维度过滤器 (FilterType)

    • All:作用于全局所有 Active 动画。

    • TargetOrId/TargetAndId:通过stringint或对象引用匹配目标(适配intIdstringIdtarget属性)。

    • AllExceptTargetsOrIds:排除指定目标后的反向过滤。

  2. 高效逆序遍历:通过从_maxActiveLookupId逆序遍历_activeTweens,确保在批量 Kill 或 Complete 时能以最快速度完成筛选和状态转换。

六、 GameObject 生命周期联动 (EvaluateTweenLink)

在 DOTween 中,通过.SetLink(gameObject, LinkBehaviour)可以将动画与 Unity GameObject 绑定。TweenManager并没有为每个绑定对象挂载额外的 MonoBehaviour,而是统一通过EvaluateTweenLink在帧更新时进行轮询检测:

bool activeInHierarchy = tweenLink.target.activeInHierarchy; bool flag1 = !tweenLink.lastSeenActive & activeInHierarchy; // OnEnable 瞬间 bool flag2 = tweenLink.lastSeenActive && !activeInHierarchy; // OnDisable 瞬间

根据不同的LinkBehaviour策略:

  • PauseOnDisable:当物体隐藏时自动 Pause。

  • KillOnDisable:当物体隐藏或销毁时直接 Kill。

  • RestartOnEnable:当物体重新激活时自动 Restart。

  • 空指针防护:当检测到tweenLink.target == null(GameObject 已被 Destroy)时,会自动将t.active = false移出更新管线,彻底消除了手动管理动画生命周期的负担和空指针风险。

总结

TweenManager展现了极高水平的性能优化考量:

  1. 零 GC 设计:通过全类型强匹配的对象池 (_pooledTweeners/_PooledSequences) 和预分配数组,保障了运行期间的零内存分配。

  2. 高性能集合管理:通过延迟整理(Lazy Reorganization)避免了 $O(N)$ 频发删除消耗。

  3. 两阶段更新安全机制:更新(Evaluation)与销毁(Despawn)解耦,彻底消除了动画遍历期间迭代器失效和集合修改冲突问题。

← 返回列表