Appearance
统一资源加载队列
系统概览
跨资源类型的统一加载入口,串行化 actor、stage、prop、VMD、音频和相机 VMD 请求,避免不同底层 loader 同时工作造成竞态。通过动态 import 降低与 scene 模块的循环依赖。
对外 API(节选)
loadManager.load(req, signal?)— 入队并返回ResourceHandle | null。loadManager.current— 兼容旧调用的当前请求快照。loadManager.getCurrentLoad()— 返回loadId、phase和请求详情。LoadRequest— 描述资源类型、路径、模型关联和 zip 缓存上下文。LibraryLoadError— 带loadId/phase/cause的结构化加载错误。
不变量
- 请求按入队顺序执行,后续请求不能绕过当前请求。
AbortSignal必须透传到底层 loader。- 错误包装不能丢失原始异常和请求上下文。
验证入口
- 测试:当前缺少专属单元测试,后续应优先覆盖串行队列、取消和错误包装。