Web 图形与 3D / 系统课时

处理 Root Motion 位移冲突

处理 Root Motion 位移冲突

角色播放行走动画时,如果动画根节点前进 2 米,而业务逻辑又把角色推了 1 米,画面中的角色可能实际前进 3 米。本篇用 Three.js 复现位移叠加,定位 GLB 动画轨道,并让世界位置只有一个控制者。

学习目标

  • 区分角色容器、模型节点与动画根节点的位置。
  • 找到导致重复移动的 position 轨道,并制作原地动作。
  • 根据碰撞、导航与动作需求选择位移控制方案,验证循环和切换效果。

为什么会出现双重位移

推荐把角色分成两层:业务控制 Actor(外层 Group)的世界移动,gltf.scene 作为其子节点负责模型显示,AnimationMixer 驱动模型中的骨骼或动画根节点。轨道中的 MotionRoot.position 是相对于父节点的局部位移,不是直接设置角色的世界坐标。

在父节点没有旋转和缩放的简化场景里,一秒内 Actor.position.x 增加 1 米、MotionRoot.position.x 增加 2 米,根节点的世界 X 位置就增加 3 米。这是父子变换叠加;如果动画和代码同时写同一个节点的同一属性,则可能被后执行的 mixer.update() 覆盖,表现为抖动或回弹。

业务位移与动画根位移叠加及去重示意

在 GLB 中查出根运动

用 GLTFLoader 加载后,动作保存在 gltf.animations,每个 AnimationClip 的 tracks 都有轨道名称和关键帧数据。按以下顺序定位:

  1. 选中出现漂移的动作,查看 clip.tracks.map(t => t.name);重点检查以 .position 结尾的轨道,例如 MotionRoot.position 或 Hips.position。实际名称以导出的 GLB 为准。
  2. 用 gltf.scene.getObjectByName('MotionRoot') 定位目标节点;确保它处于传给 new THREE.AnimationMixer(gltf.scene) 的层级中。暂停业务位移,只播放一遍动作,比较首尾 X、Z 位置。
  3. 暂停动画、只执行移动逻辑,再比较相同时间里的实际距离。如果单独运行各移动一次,合起来却移动过量,就已确认存在双重驱动。

用可运行示例去掉水平根运动

准备 Node.js 20 或更新版本,在空目录执行 npm install three。将以下内容保存为 root-motion-demo.mjs,运行 node root-motion-demo.mjs。示例不依赖外部 GLB,使用真实的 Three.js 关键帧与混合器模拟相同结构。

js
import * as THREE from 'three';

const original = new THREE.AnimationClip('Walk', 1, [
  new THREE.VectorKeyframeTrack(
    'MotionRoot.position', [0, 1], [0, 0, 0, 2, 0, 0]
  )
]);

function makeInPlace(source) {
  const clip = source.clone(); // 不修改可能被其他角色共用的原片段
  const track = clip.tracks.find(t => t.name === 'MotionRoot.position');
  if (!(track instanceof THREE.VectorKeyframeTrack)) {
    throw new Error('找不到 MotionRoot 的位置轨道');
  }
  const startX = track.values[0];
  const startZ = track.values[2];
  // VectorKeyframeTrack 每个关键帧依次存放 x、y、z
  for (let i = 0; i < track.values.length; i += 3) {
    track.values[i] = startX;
    track.values[i + 2] = startZ;
  }
  return clip;
}

function measure(clip) {
  const actor = new THREE.Group();
  const model = new THREE.Group();
  const motionRoot = new THREE.Group();
  motionRoot.name = 'MotionRoot';
  actor.add(model);
  model.add(motionRoot);

  const mixer = new THREE.AnimationMixer(model);
  const action = mixer.clipAction(clip);
  action.setLoop(THREE.LoopOnce, 1);
  action.clampWhenFinished = true;
  action.play();

  actor.position.x = 1; // 业务逻辑一秒内推进 1 米
  mixer.update(1); // 动画增量的单位是秒
  actor.updateMatrixWorld(true);
  return motionRoot.getWorldPosition(new THREE.Vector3()).x;
}

console.log(`重复驱动:${measure(original).toFixed(1)} m`);
console.log(`原地动作:${measure(makeInPlace(original)).toFixed(1)} m`);

预期输出:

text
重复驱动:3.0 m
原地动作:1.0 m

makeInPlace() 只锁定该专用运动根节点的 X、Z 关键帧,保留 Y 分量及其他骨骼轨道。实际使用时先核对轨道名称、初始位置和模型朝向;这段处理不适合直接套在含复杂骨盆侧摆、旋转根运动或混合提取需求的动作上。

让一个系统拥有世界位移

方案 谁修改角色世界位置 动画如何处理 适用场景
逻辑驱动的原地动作 输入、导航或物理控制器移动 Actor 去掉专用运动根节点的累计 X/Z 位移,保留肢体动作 玩家控制、网络同步、碰撞移动
动画驱动的 Root Motion 提取相邻动画采样的位移增量,经碰撞检测后应用到 Actor 将已提取的平面位移从视觉根节点抵消,避免再次叠加 翻越、突进、精确对位的交互动作

采用动画驱动时,不能简单地每帧读取根节点当前位置后直接加给角色:需要计算本次与上次采样的差值,把局部增量转换到角色朝向,并处理动画循环边界。尤其从片段末尾跳回开头时,直接相减会出现负向瞬移。使用碰撞控制器时,还要以实际允许的移动量同步模型,而不是让画面穿过墙体。

验证循环、转向与动作切换

  1. 原地动作连续循环 10 次,关闭业务移动,检查专用 MotionRoot 相对起点的 X、Z 偏移是否始终接近 0;可以把误差不超过 0.01 米作为本项目的检查阈值。
  2. 打开业务移动,以 1 米/秒走 5 秒,应由 Actor 前进约 5 米;分别在 30 FPS、60 FPS 下检查,移动量应按真实 deltaSeconds 计算,而不是每帧固定加 1。
  3. 测试 Idle → Walk → Run → Idle 的交叉淡入淡出、角色旋转 90° 后行走、遇到障碍物时停止。若只在切换瞬间跳位置,检查是否混入了仍带根位移的动作;若碰撞体停下但身体继续前进,检查视觉根节点是否仍被动画平移。

最后再观察脚底是否打滑:即使消除了重复位移,动作步幅与实际移动速度不匹配仍会产生滑步。先保证世界位移由单一系统控制,再校准播放速度与步态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理 Root Motion 位移冲突

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通