Web 图形与 3D / 系统课时
按权重混合多个动画动作
按权重混合多个动画动作
角色从走路切换到跑步,如果直接停掉旧动作再播放新动作,骨骼姿态可能突然跳变。这里用可运行的 Three.js 数值实验演示普通混合、交叉淡化和 Additive 叠加,最后给出迁移到 GLB 角色时的检查方法。
学习目标
- 用
setEffectiveWeight()配出两个普通动作的混合比例,并解释同属性轨道的结果。 - 使用
crossFadeTo()、fadeIn()和fadeOut()做连续过渡。 - 将叠加动作转换为 Additive 片段,识别参考姿态和权重叠加的风险。
普通混合按属性合成
AnimationMixer 把多个 AnimationAction 中指向同一属性的轨道合成;没有共同属性的轨道不会彼此争夺权重。比如 Walk 和 Run 都驱动 .position[x],Walk 取值为 0、权重 0.75,Run 取值为 2、权重 0.25,最终 X 为 0 × 0.75 + 2 × 0.25 = 0.50。
对普通数值轨道,应区分三种情况:
| 同属性普通动作的权重总和 | 结果 |
|---|---|
| 等于 1 | 按各动作权重混合,例如 0.75 与 0.25 |
| 小于 1 | 剩余比例混入该属性被动画接管前保存的原始值 |
| 大于 1 | Three.js 对普通混合进行归一化,不会简单把位移乘大 |
这种算术演示适用于数值轨道;骨骼四元数旋转使用专门的插值方式,不能直接把旋转角按上式相加。实际角色中两个步态的动作相位若不一致,即使权重合计为 1,仍可能出现脚滑。

用可运行代码核对混合结果
以下示例适用于 Node.js 18+ 与 three@0.180.0。在空目录执行 npm install three@0.180.0,将代码保存为 blend.mjs,再执行 node blend.mjs。示例不依赖 WebGL:用一个 Object3D 的 X 坐标代替角色骨骼上的单个数值属性,方便精确检查每次混合。
import * as THREE from 'three';
const actor = new THREE.Object3D();
const mixer = new THREE.AnimationMixer(actor);
const constantClip = (name, x) => new THREE.AnimationClip(name, 1, [
new THREE.NumberKeyframeTrack('.position[x]', [0, 1], [x, x])
]);
const walk = mixer.clipAction(constantClip('Walk', 0));
const run = mixer.clipAction(constantClip('Run', 2));
walk.play().setEffectiveWeight(0.75);
run.play().setEffectiveWeight(0.25);
mixer.update(0.5);
console.log(`普通混合 x=${actor.position.x.toFixed(2)}`);
const swaySource = new THREE.AnimationClip('Sway', 1, [
new THREE.NumberKeyframeTrack('.position[x]', [0, 0.5, 1], [0, 1, 0])
]);
// 以第 0 帧为参考,将绝对轨道值转换为相对增量
const swayClip = THREE.AnimationUtils.makeClipAdditive(swaySource.clone(), 0);
const sway = mixer.clipAction(swayClip).play().setEffectiveWeight(0.4);
mixer.update(0.5);
console.log(`叠加后 x=${actor.position.x.toFixed(2)}`);
sway.stop();
// 交叉淡化控制有效权重,因此先恢复两动作的基础权重
walk.setEffectiveWeight(1);
run.setEffectiveWeight(1);
walk.crossFadeTo(run, 0.4, false);
mixer.update(0.2);
console.log(`交叉淡化中 x=${actor.position.x.toFixed(2)}`);预期输出:
普通混合 x=0.50
叠加后 x=0.90
交叉淡化中 x=1.00第一行是普通动作 0.75/0.25 的混合;第二行把 Sway 在 0.5 秒时的相对增量 1 × 0.4 = 0.4 加到 0.50 上;第三行停止叠加后,让 Walk 和 Run 在 0.4 秒的交叉淡化中走到中点,因此 X 为 1.00。演示中普通动作的轨道值固定,避免把关键帧随时间变化与权重变化混在一起。
正确调度淡入淡出
setEffectiveWeight(0.3) 适合直接设定当前混合比例,但调用它也会取消该动作正在进行的淡入淡出。fadeIn(0.4) 和 fadeOut(0.4) 则让权重在 0.4 秒内变化;walk.crossFadeTo(run, 0.4, false) 同时让旧动作淡出、新动作淡入,第三个参数 false 表示不额外调整播放速度。
真实 GLB 中,先对 gltf.scene 创建 AnimationMixer,再从 gltf.animations 中按名称找 Walk、Run 创建动作。确保目标动作已经 play(),仅在状态切换发生时调用一次 crossFadeTo();每个渲染帧以秒为单位执行 mixer.update(clock.getDelta())。可通过 getEffectiveWeight() 检查中途实际权重。若希望切换中点恰好各为 0.5,淡化前两动作的基础权重应为 1,不能把目标动作基础权重长期锁为 0。
普通动作权重变成 0 不等于执行了 stop();反复切换时,应管理已结束动作,避免不需要的动作持续更新。走跑切换可先试 0.2~0.4 秒,再依据动作相位和角色速度调整。
Additive 必须使用相对参考姿态
普通混合用于 Walk 与 Run 这种互相替代的完整动作;Additive 更适合在基础动作上叠加轻微呼吸、抬头或受击偏移。AnimationUtils.makeClipAdditive(clip.clone(), 0) 以第 0 帧为参考,把轨道转换成相对变化,并设置片段的 Additive 混合模式。示例中的 Sway 在第 0 帧增量为 0,在 0.5 秒增量为 1,因此权重 0.4 带来额外的 0.4 位移。
转换会修改传入的片段,使用 clone() 是为了保留原片段。第 0 帧不一定是角色的中性姿态:如果呼吸动画从一个已经弯腰的姿势开始,需要改用与骨骼绑定一致的参考片段和正确参考帧,否则叠加后可能持续偏斜。
实际项目先将叠加层限制在胸腔、头部或上半身对应的轨道,并从 0.1~0.3 的权重开始调试。Additive 的偏移不会像普通动作权重那样共同归一化,多个大幅度叠加层作用到同一骨骼时,异常姿态尤其明显。
从异常姿态反查原因
| 观察到的现象 | 优先检查和修正 |
|---|---|
| 淡化中突然闪回静止姿态 | 同属性普通权重总和是否短暂小于 1;检查目标动作是否已 play(),是否又调用 setEffectiveWeight(0) |
| 走跑交接时脚掌滑动 | 两段步态的脚触地相位是否接近;必要时先对齐动作时间再执行 0.3 秒交叉淡化 |
| 叠加呼吸后全身前倾 | 参考帧是否为预期中性姿态;检查是否错误地将完整全身动画转换为 Additive |
| 连续切换时权重跳变 | 是否每帧重复调用 crossFadeTo(),或在淡化期间反复设置权重 |
验收时分别只开 Walk、只开 Run、再开两者 0.75/0.25 混合,最后单独添加 Additive。每次检查轨道绑定、getEffectiveWeight() 和实际姿态,能把权重设置错误与素材本身的动作相位问题区分开。