Root Motion 委托化解耦接入
传统 Root Motion 的痛点
在 Unity 默认机制中,开启 Animator.applyRootMotion 后,动画的根骨骼位移会直接暴力修改角色的 Transform.position。这在以下场景会引发严重灾难:
- 碰撞穿墙与悬空:直接修改 Transform 会绕过
CharacterController或Rigidbody的物理碰撞体 sweep 测试,导致角色冲刺穿墙、悬空踏步或卡进地形。 - 重力与位移冲突:动作自带轻微的 Y 轴颠簸,极易覆盖游戏自定义的重力下落速度。
- 网络同步困难:服务端无法在纯物理层进行位移校验与回滚。
CwcMontage 的委托解耦方案
CwcMontage 采用**“捕获 -> 掩码过滤 -> 委托派发”**的无侵入管道设计:
mermaid
flowchart TD
A[Playables 动画输出根骨骼 Delta] --> B[MontageCoordinator 捕获 OnAnimatorMove]
B --> C{掩码过滤\nPositionMask & RotationMask}
C -->|水平分量 XZ| D[抛出 OnRootMotionDelta]
C -->|丢弃或分离垂直分量 Y| D
D --> E[实现 IMontageRootMotionReceiver 的外部移动控制器]
E --> F[通过 CharacterController.Move 执行带碰撞的物理位移]- 蒙太奇播放器自身绝不直接修改角色位置。
- 将位移量($\Delta \text{Position}$)与旋转量($\Delta \text{Rotation}$)包装为精确的当帧增量,交由外部移动组件按自己的物理逻辑应用。
接入实战:对接 CharacterController
1. 方式一:实现 IMontageRootMotionReceiver 接口(零 GC 推荐)
在你的角色移动控制脚本中实现该接口:
csharp
using UnityEngine;
using Cwcbb.Tools.CwcMontage;
[RequireComponent(typeof(CharacterController))]
public class PlayerMovementController : MonoBehaviour, IMontageRootMotionReceiver
{
private CharacterController _characterController;
private float _verticalVelocity;
private void Awake()
{
_characterController = GetComponent<CharacterController>();
}
/// <summary>
/// 当 Montage 产生 Root Motion 增量时由 MontageCoordinator 自动直接回调
/// </summary>
public void OnMontageRootMotion(Vector3 deltaPosition, Quaternion deltaRotation)
{
// 1. 应用旋转增量
transform.rotation = deltaRotation * transform.rotation;
// 2. 将蒙太奇位移增量与角色重力合并
Vector3 finalMove = deltaPosition;
if (!_characterController.isGrounded)
{
_verticalVelocity += Physics.gravity.y * Time.deltaTime;
finalMove.y += _verticalVelocity * Time.deltaTime;
}
else
{
_verticalVelocity = -1.0f; // 贴地微小下压力
}
// 3. 安全执行物理移动(带有完整的碰撞与滑移检测)
_characterController.Move(finalMove);
}
}2. 方式二:通过 C# 事件监听
如果你不想实现接口,也可以直接在 MontageCoordinator 上订阅事件:
csharp
[SerializeField] private MontageCoordinator _coordinator;
private void OnEnable()
{
_coordinator.OnRootMotionDelta += HandleRootMotionDelta;
}
private void OnDisable()
{
_coordinator.OnRootMotionDelta -= HandleRootMotionDelta;
}
private void HandleRootMotionDelta(Vector3 deltaPos, Quaternion deltaRot)
{
_characterController.Move(deltaPos);
}通过这种解耦设计,美术可以自由使用带有真实位移的高品质 Root Motion 动作,而程序端完全拥有物理运动的绝对掌控权。
