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 都有轨道名称和关键帧数据。按以下顺序定位:
- 选中出现漂移的动作,查看
clip.tracks.map(t => t.name);重点检查以.position结尾的轨道,例如MotionRoot.position或Hips.position。实际名称以导出的 GLB 为准。 - 用
gltf.scene.getObjectByName('MotionRoot')定位目标节点;确保它处于传给new THREE.AnimationMixer(gltf.scene)的层级中。暂停业务位移,只播放一遍动作,比较首尾 X、Z 位置。 - 暂停动画、只执行移动逻辑,再比较相同时间里的实际距离。如果单独运行各移动一次,合起来却移动过量,就已确认存在双重驱动。
用可运行示例去掉水平根运动
准备 Node.js 20 或更新版本,在空目录执行 npm install three。将以下内容保存为 root-motion-demo.mjs,运行 node root-motion-demo.mjs。示例不依赖外部 GLB,使用真实的 Three.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`);预期输出:
重复驱动:3.0 m
原地动作:1.0 mmakeInPlace() 只锁定该专用运动根节点的 X、Z 关键帧,保留 Y 分量及其他骨骼轨道。实际使用时先核对轨道名称、初始位置和模型朝向;这段处理不适合直接套在含复杂骨盆侧摆、旋转根运动或混合提取需求的动作上。
让一个系统拥有世界位移
| 方案 | 谁修改角色世界位置 | 动画如何处理 | 适用场景 |
|---|---|---|---|
| 逻辑驱动的原地动作 | 输入、导航或物理控制器移动 Actor |
去掉专用运动根节点的累计 X/Z 位移,保留肢体动作 | 玩家控制、网络同步、碰撞移动 |
| 动画驱动的 Root Motion | 提取相邻动画采样的位移增量,经碰撞检测后应用到 Actor |
将已提取的平面位移从视觉根节点抵消,避免再次叠加 | 翻越、突进、精确对位的交互动作 |
采用动画驱动时,不能简单地每帧读取根节点当前位置后直接加给角色:需要计算本次与上次采样的差值,把局部增量转换到角色朝向,并处理动画循环边界。尤其从片段末尾跳回开头时,直接相减会出现负向瞬移。使用碰撞控制器时,还要以实际允许的移动量同步模型,而不是让画面穿过墙体。
验证循环、转向与动作切换
- 原地动作连续循环 10 次,关闭业务移动,检查专用
MotionRoot相对起点的 X、Z 偏移是否始终接近 0;可以把误差不超过0.01米作为本项目的检查阈值。 - 打开业务移动,以 1 米/秒走 5 秒,应由
Actor前进约 5 米;分别在 30 FPS、60 FPS 下检查,移动量应按真实deltaSeconds计算,而不是每帧固定加 1。 - 测试
Idle → Walk → Run → Idle的交叉淡入淡出、角色旋转 90° 后行走、遇到障碍物时停止。若只在切换瞬间跳位置,检查是否混入了仍带根位移的动作;若碰撞体停下但身体继续前进,检查视觉根节点是否仍被动画平移。
最后再观察脚底是否打滑:即使消除了重复位移,动作步幅与实际移动速度不匹配仍会产生滑步。先保证世界位移由单一系统控制,再校准播放速度与步态。