Web 图形与 3D / 系统课时
用 SkeletonUtils 克隆蒙皮角色
用 SkeletonUtils 克隆蒙皮角色
当同一套 GLB 角色需要同时出现多次时,普通 Object3D.clone() 可能让新网格仍引用原角色的骨骼。本课用 SkeletonUtils.clone() 创建三个实例,分别驱动动画,并检查骨骼是否独立、几何体与材质是否按预期共享。
学习目标
- 区分普通克隆和蒙皮安全克隆的骨骼绑定结果。
- 用
SkeletonUtils.clone()创建多个可分别播放动画的角色。 - 验证骨骼独立性和共享资源的修改边界。
普通克隆为什么会串骨骼
SkinnedMesh 不只是一个网格:它通过 skeleton.bones 引用一组 Bone,顶点的蒙皮权重再决定骨骼如何影响网格。普通 Object3D.clone(true) 虽会递归复制子节点,却不保证克隆后的 SkinnedMesh.skeleton.bones 改指向这些新骨骼。结果可能是两个角色共用原骨骼姿态,或动作错位。
SkeletonUtils.clone(source) 会克隆层级并重新关联骨骼。传入的 source 必须同时包含蒙皮网格及其使用的全部骨骼;对常见 glTF 资产,应传 gltf.scene,不要只传其中一个 SkinnedMesh。

准备可验证的 GLB
以下使用 Vite 的原生 JavaScript 模板及 Three.js 的 three/addons/ 导入路径。先在终端执行:
npm create vite@latest skeleton-clone-demo -- --template vanilla
cd skeleton-clone-demo
npm install
npm install three预期结果:项目内有 src/main.js,package.json 中安装了 three 依赖;命令输出里的版本和安装耗时因环境而异。
准备一个包含 SkinnedMesh、其骨骼层级和至少一个动画片段的角色 GLB,保存为 public/models/character.glb。示例按角色约 1~2 米高、朝向摄像机设计,模型尺寸不同可调整相机距离及实例间距。普通静态 GLB 不适用于这个验证。
克隆角色并分别播放动画
用下列完整内容替换 Vite 项目的 src/main.js。每个克隆对象拥有自己的 AnimationMixer;三个实例复用同一个 AnimationClip,但播放速度分别为 0.65、1 和 1.35。
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import * as SkeletonUtils from 'three/addons/utils/SkeletonUtils.js';
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf4f7fa);
const camera = new THREE.PerspectiveCamera(45, innerWidth / innerHeight, 0.1, 100);
camera.position.set(0, 1.5, 10);
camera.lookAt(0, 1, 0);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(innerWidth, innerHeight);
document.body.style.margin = '0';
document.body.appendChild(renderer.domElement);
scene.add(new THREE.HemisphereLight(0xffffff, 0x999999, 2));
const light = new THREE.DirectionalLight(0xffffff, 2);
light.position.set(3, 6, 5);
scene.add(light);
function findSkinnedMesh(root) {
let found = null;
root.traverse((node) => {
if (!found && node.isSkinnedMesh) found = node;
});
return found;
}
async function main() {
const gltf = await new GLTFLoader().loadAsync('/models/character.glb');
const sourceMesh = findSkinnedMesh(gltf.scene);
if (!sourceMesh || gltf.animations.length === 0) {
throw new Error('GLB 必须包含蒙皮网格和动画片段');
}
// 克隆范围必须覆盖网格和所引用的全部 Bone。
const allBonesInside = sourceMesh.skeleton.bones.every(
(bone) => gltf.scene.getObjectById(bone.id) === bone
);
if (!allBonesInside) throw new Error('骨骼不在克隆根节点之下');
const speeds = [0.65, 1, 1.35];
const actors = speeds.map((speed, index) => {
const root = SkeletonUtils.clone(gltf.scene);
root.position.x += (index - 1) * 2.5;
scene.add(root);
const mixer = new THREE.AnimationMixer(root);
const action = mixer.clipAction(gltf.animations[0]);
action.timeScale = speed;
action.play();
return { root, mixer };
});
const [meshA, meshB] = actors.map(({ root }) => findSkinnedMesh(root));
console.log('实例数量:', actors.length);
console.log('骨骼独立:', meshA.skeleton.bones.every(
(bone, i) => bone !== meshB.skeleton.bones[i]
));
console.log('几何体共享:', meshA.geometry === meshB.geometry);
console.log('材质共享:', meshA.material === meshB.material);
// 所有 Mixer 使用同一帧时长推进,但各自管理播放状态。
const clock = new THREE.Clock();
function animate() {
requestAnimationFrame(animate);
const delta = clock.getDelta();
actors.forEach(({ mixer }) => mixer.update(delta));
renderer.render(scene, camera);
}
animate();
}
main().catch(console.error);预期输出(浏览器开发者工具 Console):
实例数量: 3
骨骼独立: true
几何体共享: true
材质共享: true执行 npm run dev 并打开终端提示的本地地址。预期页面显示三个并排角色;如果所选动画有明显关节运动,三者会以不同速度播放。终端地址中的端口可能不同,依实际提示访问。
检查资源共享与独立变形
日志中的 骨骼独立: true 表示对应骨骼不是同一个对象;几何体共享: true 与 材质共享: true 则是预期的内存复用。SkeletonUtils.clone() 负责修正蒙皮骨骼引用,不会自动为每个实例复制 Geometry、Material 或 Texture。
检查动画独立性时,可把三种 timeScale 临时改成 0、1、2:第一个角色保持初始动作时间,另两个以不同速率推进。再次加载页面,确认只有后两者在运动。若 GLB 的首个片段是几乎静止的 Idle,改选有明显骨骼变化的片段再观察。
给单个角色换色前,应先克隆该角色的材质,例如单材质网格执行 meshA.material = meshA.material.clone(),然后才修改 meshA.material.color。如果直接修改共享材质,其他角色也会一起变色。多材质网格需逐个克隆材质;克隆材质后其贴图对象仍可能共享。
常见失败及修正
| 现象 | 常见原因 | 处理办法 |
|---|---|---|
| 骨骼扭曲或克隆异常 | 只克隆 SkinnedMesh,骨骼在外层 Armature 中 |
改为克隆包含网格与骨骼的共同根节点,通常为 gltf.scene |
| 三个角色都不动 | GLB 没有动画,或忘记更新 AnimationMixer |
检查 gltf.animations.length,每帧执行各自的 mixer.update(delta) |
| 改一个角色颜色,全部改变 | 克隆实例默认共享材质 | 仅为需要单独修改的实例克隆材质 |
| 角色重叠或跑出画面 | 模型尺寸、根节点偏移与示例假设不符 | 调整 root.position.x 的间距及 camera.position |
实例移除时,先停止对应动作并清除该 AnimationMixer 的绑定,再从场景移除根节点。共享的几何体、材质和贴图不要因销毁一个实例就立即 dispose();等最后一个使用者释放后再统一清理。