Web 图形与 3D / 系统课时

缓存模型加载结果避免重复请求

缓存模型加载结果避免重复请求

多个相同角色容易触发重复下载与解析;直接共用场景根节点,又会让变换和动画相互干扰。这里用规范化 URL 缓存 GLTFLoader 的 Promise,合并并发加载,同时为每个角色创建独立实例,并处理失败后的重试。

学习目标

  • 以规范化资源 URL 为键,复用进行中和已完成的 glTF 加载任务。
  • 在并发调用与加载失败时正确命中、清理和重试缓存。
  • 区分共享网格资源与每个角色独立的节点、骨骼和动画控制器。

区分缓存内容与实例状态

假设关卡里有 20 个 NPC 都使用 /models/character.glb。缓存保存 GLTFLoader 解析得到的 gltf,包括 scene 和 animations;即使浏览器已经缓存下载内容,再调用加载器也不等于复用解析结果。THREE.Cache 主要服务于底层 FileLoader,不能代替这里的解析结果缓存。

一个缓存键始终指向同一个 Promise:请求尚未结束时,第二个调用者直接等待它;请求成功后,后续调用者从已兑现的 Promise 得到同一个 gltf。但是不能把同一个 gltf.scene 同时当作两个角色的根节点,也不能让他们共用 AnimationMixer。

相同 GLB 的并发缓存与角色实例隔离

规范化 URL 并复用 Promise

以下示例适用于使用 ES 模块的 Three.js 和 Vite 工程。先在工程内安装 three,将无需额外 Draco/KTX2 解码器的有效 GLB 放在 public/models/character.glb,并确保页面以 src/main.js 作为入口。模型可以没有动画片段。安装命令是 npm install three;成功后启动现有 Vite 开发服务器。

将以下完整代码写入 src/main.js。new URL() 使相对与绝对地址采用同一键;去掉不会随 HTTP 请求发送的 hash,但保留用于区分版本的查询参数,例如 ?v=2。

js
import { AnimationMixer } from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import * as SkeletonUtils from 'three/addons/utils/SkeletonUtils.js';

const loader = new GLTFLoader();
const modelCache = new Map();

function cacheKey(path) {
  const url = new URL(path, document.baseURI);
  url.hash = ''; // hash 不影响文件内容;保留 ?v= 等版本参数
  return url.href;
}

function loadGLTF(path) {
  const key = cacheKey(path);
  const cached = modelCache.get(key);
  if (cached) return cached;

  // 立即保存进行中的 Promise,合并同一时刻的请求
  const pending = loader.loadAsync(key).catch((error) => {
    if (modelCache.get(key) === pending) modelCache.delete(key);
    throw error; // 不把失败结果长期留在缓存中
  });
  modelCache.set(key, pending);
  return pending;
}

async function createCharacter(path) {
  const gltf = await loadGLTF(path);
  // 克隆节点与骨骼,几何体、材质、动画剪辑仍能共享
  const root = SkeletonUtils.clone(gltf.scene);
  return {
    root,
    mixer: new AnimationMixer(root),
    clips: gltf.animations
  };
}

async function main() {
  const relative = '/models/character.glb';
  const absolute = new URL(relative, document.baseURI).href;
  const [a, b] = await Promise.all([
    createCharacter(relative),
    createCharacter(absolute)
  ]);

  console.log('缓存项:', modelCache.size);
  console.log('根节点独立:', a.root !== b.root);
  console.log('Mixer 独立:', a.mixer !== b.mixer);
  console.log('动画剪辑共享:', a.clips === b.clips);
}

main().catch(console.error);

预期输出(浏览器开发者工具 Console,模型加载成功时):

text
缓存项: 1
根节点独立: true
Mixer 独立: true
动画剪辑共享: true

验证命中、失败清理和重试

打开浏览器开发者工具的 Network 面板,过滤 character.glb,禁用浏览器缓存后刷新。两个 createCharacter() 在 Promise.all() 内并发执行,但只应看到一次该 GLB 的网络请求;modelCache.size 也应为 1。如模型有外部贴图或二进制依赖,额外资源请求不计入这次 GLB 请求数。

失败测试可以暂时把代码中的 relative 改成 /models/missing.glb,刷新后会看到 404 和 main().catch(console.error) 打印的错误。失败处理会把对应键从 Map 删除;之后在相同地址放入有效 GLB,再触发 loadGLTF() 就会重新发起请求,而不是立刻得到上一次的拒绝结果。测试完成后恢复原路径。

这里的规范化只统一相对地址、绝对地址及 hash,不会自动合并不同查询字符串。/models/character.glb?v=1 与 ?v=2 应视为不同版本;如果加载器的解码配置或认证上下文不同,也不应无条件共用同一缓存。

管理共享修改与生命周期

SkeletonUtils.clone(gltf.scene) 会为带骨骼角色复制节点与骨骼绑定,但默认仍引用相同的 geometry、material,而 gltf.animations 可以作为只读剪辑共享。实际场景把每个 root 分别添加到 THREE.Scene,给各自 Mixer 创建 clipAction(),并在每帧以秒为单位分别调用 mixer.update(delta)。

如果两个 NPC 要换不同衣服颜色,直接修改共享材质会让两者一起变化;需要先对该 NPC 的目标材质调用 material.clone() 再修改。动画时间、权重、位置、可见性等实例状态则应保存在各自的根节点、Mixer 或业务对象中,不能写回缓存的原始 gltf.scene。

移除角色时,先停止其动画并清掉 Mixer 对根节点的绑定:mixer.stopAllAction()、mixer.uncacheRoot(root)、root.removeFromParent()。如果该实例有独立骨骼 GPU 资源,可在确认不再使用后释放其 skeleton;但不能对仍被缓存或其他角色引用的共享几何体、材质和纹理调用 dispose()。只有最后一个使用者释放、缓存项也被淘汰后,才由资源管理器统一销毁这些共享资源;单纯 modelCache.delete(key) 不会自动释放 GPU 内存。

可参考 GLTFLoader 接口、SkeletonUtils 克隆行为 和 Three.js 资源释放说明。

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

目录与阅读设置

阅读设置

17

记录一个想法

缓存模型加载结果避免重复请求

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

登录哪都通