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/ 导入路径。先在终端执行:

bash
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。

js
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):

text
实例数量: 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();等最后一个使用者释放后再统一清理。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 SkeletonUtils 克隆蒙皮角色

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

登录哪都通