Web 图形与 3D / 系统课时

用 AnimationMixer 驱动动作

用 AnimationMixer 驱动动作

把带动画的 GLB 加进场景后,角色可能仍保持静止,因为导入关键帧并不会自动播放。本篇将动作片段绑定到角色,通过 AnimationAction 启动播放,并在每帧用正确的时间增量更新混合器,让动作按正常速度持续运行。

学习目标

  • 区分 AnimationClip、AnimationMixer 和 AnimationAction 的职责。
  • 使用 GLTFLoader 加载角色并播放第一个动画片段。
  • 检查逐帧更新是否正确,识别毫秒与秒混用的问题。

动作播放的对象关系

GLTFLoader 返回的 gltf.scene 是角色节点层级,gltf.animations 是 AnimationClip 数组。片段只保存关键帧轨道,不负责计时。new THREE.AnimationMixer(gltf.scene) 将播放系统关联到角色根节点;mixer.clipAction(clip) 获取对应的 AnimationAction,由它控制播放、暂停、循环和速度。

action.play() 会激活动作,但要真正改变姿态,还须每帧先调用 mixer.update(deltaSeconds),让关键帧轨道更新节点变换、骨骼或形变权重,再调用 renderer.render()。同一个角色的多个片段通常共用一个 Mixer;不同角色独立播放时各用一个 Mixer。

AnimationClip、AnimationMixer、AnimationAction 与逐帧更新的数据关系

准备项目与动画资产

以下示例适用于 Three.js r183 及之后的版本,使用 Vite 运行。准备一个至少包含一条动画轨道、已在 glTF 查看器验证能播放的角色 GLB,存为 public/models/character.glb。Vite 会把 public 内的文件映射到网站根路径,因此加载地址是 /models/character.glb,不是 /public/models/character.glb。

在空项目目录运行以下命令,前提是已安装与当前 Vite 兼容的 Node.js:

bash
npm init -y
npm install three
npm install --save-dev vite

预期结果:命令成功结束,项目中生成 package.json 和 node_modules/;具体安装日志及依赖版本随环境不同。

在项目根目录创建 index.html:

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>角色动画预览</title>
</head>
<body style="margin:0">
  <script type="module" src="/main.js"></script>
</body>
</html>

该页面仅负责加载入口脚本,保存后可通过浏览器开发者工具的 Network 面板确认 main.js 请求成功。

完整的动作播放示例

在项目根目录创建 main.js。示例假设角色以 Y 轴向上、身高约 2 个世界单位且位于原点附近;如果实际模型大小或原点不同,需要调整相机位置。

js
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';

const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf4f7f8);

const camera = new THREE.PerspectiveCamera(
  45, window.innerWidth / window.innerHeight, 0.1, 100
);
camera.position.set(0, 1.4, 4.5);
camera.lookAt(0, 1, 0);

const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.setSize(window.innerWidth, window.innerHeight);
document.body.appendChild(renderer.domElement);

scene.add(new THREE.HemisphereLight(0xffffff, 0x8899aa, 2));
const light = new THREE.DirectionalLight(0xffffff, 3);
light.position.set(3, 5, 2);
scene.add(light);

let mixer = null;
const loader = new GLTFLoader();

loader.load('/models/character.glb', (gltf) => {
  scene.add(gltf.scene);

  // 动画数据与场景树分开存放;无片段时不能创建可用动作。
  if (gltf.animations.length === 0) {
    console.warn('GLB 不包含动画片段');
    return;
  }

  mixer = new THREE.AnimationMixer(gltf.scene);
  const action = mixer.clipAction(gltf.animations[0]);
  action.setLoop(THREE.LoopRepeat, Infinity);
  action.play();
  console.log('动作已启动');
}, undefined, (error) => console.error('GLB 加载失败', error));

// r183+ 使用 Timer;每帧先更新计时器,再以秒推进 Mixer。
const timer = new THREE.Timer();
renderer.setAnimationLoop((timestamp) => {
  timer.update(timestamp);
  if (mixer) mixer.update(timer.getDelta());
  renderer.render(scene, camera);
});

window.addEventListener('resize', () => {
  camera.aspect = window.innerWidth / window.innerHeight;
  camera.updateProjectionMatrix();
  renderer.setSize(window.innerWidth, window.innerHeight);
});

预期输出(GLB 存在且包含有效动画时,浏览器控制台):

text
动作已启动

预期页面效果:模型出现在画面中,第一个动画片段循环播放。setLoop(THREE.LoopRepeat, Infinity) 指定无限循环;如果动画片段本身不改变可见属性,应换成确有可见变换的片段再检查。

验证时间与处理异常

启动开发服务器:

bash
npx vite

预期结果:终端显示包含 Local: http://localhost:<PORT>/ 的本地地址,实际端口可能不同。打开该地址,查看浏览器控制台与角色动作,并在 Network 面板确认 /models/character.glb 返回成功。

renderer.setAnimationLoop() 的回调时间戳是毫秒,而 timer.getDelta() 返回的是秒。在约 60 FPS 下,每帧增量通常接近 0.0167 秒。一个时长 2 秒、timeScale=1 的循环动作约每 2 秒播放一遍;不能把 16.7 这样的毫秒数直接传给 mixer.update(),否则播放进度会快约 1000 倍。也不要每帧传累计总时长,否则越播越快。

如果画面静止,按顺序排查:先看 GLB 是否请求失败;再看 gltf.animations.length 是否为零;然后核实 AnimationMixer 的根节点是否覆盖轨道所指向的骨骼或网格;最后确认每帧都调用了 mixer.update(timer.getDelta())。若只是模型看不见,应先调整相机,而不要误判为动画未运行。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 AnimationMixer 驱动动作

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

登录哪都通