@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_compressionbufferView解码钩子,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.