@aura3d/assets

中文文档
4.7.0发布于 2026/10/31MITTypeScriptES Module

Aura3D的资产标识、加载、缓存、依赖跟踪、导入管道、工作作业边界和GLB/glTF运行时加载器。

中文使用文档

@aura3d /资产

@aura3d/assets 拥有资产标识、加载、缓存、依赖跟踪、导入管道、工作作业边界,以及用于运行时数据的内置加载器。

公共API

  • AssetManager, AssetRegistry, AssetCache, AssetHandle:资产注册、加载请求、缓存保留、请求取消、瞬态重试恢复、进度报告、发布和处置。
  • AssetLoader, AssetLoadRequest, AssetLoadError, LoadContext:类型加载器契约、URL解析、中止处理和可恢复的加载失败。
  • AssetDependencyGraph确定性的依赖关系所有权和发布顺序。
  • ImportPipeline, ImportStage, createMeshOptimizationStage, createTextureMipGenerationStage:源资源的显式导入阶段执行,包括确定性索引网格优化和RGBA8纹理mip链生成挂钩。
  • GLTFLoader: JSON glTF和二进制GLB加载网格,流外部缓冲区,命名场景选择,材料,纹理,常见的PBR材料扩展, EXT_meshopt_compression bufferView解码钩子, KHR_draco_mesh_compression 原始解码钩子、皮肤、动画剪辑、确定性序列化和释放后的处置状态强制。
  • ImageLoader, TextureLoader, MaterialLoader, ShaderLoader, AudioLoader, SceneLoader:用于常见引擎资产类型的内置加载器。材质描述符可以实例化验证过的渲染器 PBRMaterial 和 UnlitMaterial 实例。
  • WorkerAssetJobs: cpu端资产工作的工人-作业调度边界,具有工人和回退管道执行的中止处理。

验证

资产缓存/释放行为、依赖图、加载失败重试、飞行中取消、进度报告、流化外部glTF缓冲区、着色器/材料加载器、材料描述符到渲染器材料创建、导入管道网格优化和纹理mip生成阶段、worker作业中止、本地场景加载、glTF/GLB解析、命名glTF场景选择、meshopt bufferView解码钩子验证、Draco原始解码钩子验证、glTF资产处置、PBR材料 扩展验证/绑定、皮肤/动画导入、确定性序列化和浏览器纹理上传 tests/unit/workstream5-runtime.test.ts 和 tests/browser/asset-texture-browser.spec.ts. 导出和导入一致性由 pnpm verify:exports 和 pnpm verify:imports.

版本与发布记录

@aura3d/assets 共发布 47 个版本,首次发布于 2026/06/06;过去 12 个月发布了 47 个版本。

版本发布日期距今
4.7.0latest2026/10/312 天前
4.6.22026/10/304 天前
4.6.12026/10/304 天前
4.6.02026/10/304 天前
4.5.02026/10/295 天前
4.3.72026/10/286 天前

关于 @aura3d/assets 的常见问题

@aura3d/assets 是什么?

Aura3D的资产标识、加载、缓存、依赖跟踪、导入管道、工作作业边界和GLB/glTF运行时加载器。

如何安装 @aura3d/assets?

在项目目录运行 npm install @aura3d/assets,或使用 pnpm add / yarn add / bun add。

@aura3d/assets 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aura3d/assets 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@aura3d/assets 可以商用吗?

@aura3d/assets 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@aura3d/assets 还在维护吗?

最新版本 4.7.0 发布于 2026/10/31(2 天前);至今共发布 47 个版本,其中过去 12 个月发布了 47 个;首次发布于 2026/06/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。