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。

准备项目与动画资产
以下示例适用于 Three.js r183 及之后的版本,使用 Vite 运行。准备一个至少包含一条动画轨道、已在 glTF 查看器验证能播放的角色 GLB,存为 public/models/character.glb。Vite 会把 public 内的文件映射到网站根路径,因此加载地址是 /models/character.glb,不是 /public/models/character.glb。
在空项目目录运行以下命令,前提是已安装与当前 Vite 兼容的 Node.js:
npm init -y
npm install three
npm install --save-dev vite预期结果:命令成功结束,项目中生成 package.json 和 node_modules/;具体安装日志及依赖版本随环境不同。
在项目根目录创建 index.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 个世界单位且位于原点附近;如果实际模型大小或原点不同,需要调整相机位置。
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 存在且包含有效动画时,浏览器控制台):
动作已启动预期页面效果:模型出现在画面中,第一个动画片段循环播放。setLoop(THREE.LoopRepeat, Infinity) 指定无限循环;如果动画片段本身不改变可见属性,应换成确有可见变换的片段再检查。
验证时间与处理异常
启动开发服务器:
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())。若只是模型看不见,应先调整相机,而不要误判为动画未运行。