PixiJS v8 资源加载与缓存管理：用 Assets…

在 PixiJS v8 中需要加载、缓存、分组、后台预载或卸载纹理、视频、字体、图集等资源时使用 Assets API。

适用场景

解决思路

1. 用 Assets.init({ basePath, texturePreference, manifest }) 做可选但推荐的初始化，设置基础路径、纹理偏好或清单。
2. 用 Assets.load() 加载单个 URL、别名、数组或 UnresolvedAsset 对象；解析后的资源会被缓存，之后用 Assets.get() 重新获取。
3. 用 Assets.load({ alias, src }) 形式为资源指定别名，再用 new Sprite(Assets.get('logo')) 取用。
4. 按文件类型选择解析器：纹理 .png/.jpg/.jpeg/.webp/.avif 用 texture；.svg 用 svg；视频 .mp4/.m4v/.webm/.ogg/.ogv/.h264/.avi/.mov 用 video；图集 .json 用 spritesheet；位图字体 .fnt/.xml 用 bitmap-font；Web 字体 .ttf/.otf/.woff/.woff2 用 web-font；JSON 用 json；文本 .txt 用 text；压缩纹理 .basis/.dds/.ktx/.ktx2 用 basis/dds/ktx/ktx2；GIF 用 gif（需引入 'pixi.js/gif'，返回 GifSource）。
5. 当 URL 没有扩展名（签名 CDN URL、blob URL、API 端点、内容哈希路径）时，在资源描述符顶层设置 parser 字段强制指定加载器，例如 { src: 'https://cdn.example.com/signed/abc123?token=xyz', parser: 'texture' }。
6. parser 字段放在资源描述符顶层（与 src、data 同级），不要放进 data；可用值包括 'texture'、'svg'、'video'、'json'、'text'、'web-font'、'bitmap-font'、'spritesheet'、'gif'、'basis'、'dds'、'ktx'、'ktx2'。
7. 无扩展名字体 URL 用 { parser: 'web-font', data: { family: 'Hero', weights: ['400','700'] } }；无扩展名视频流用 { parser: 'video', data: { mime: 'video/mp4', muted: true, playsinline: true } }。
8. URL 有扩展名时不要设置 parser，交给自动检测。
9. 用 parser 替代已废弃的 loadParser 字段（loadParser 仍可用但会发出弃用警告）。
10. 按主题查阅参考文件：图集与动画看 references/spritesheet.md；视频纹理看 references/video.md；Web 与位图字体看 references/fonts.md；GIF 看 references/gif.md；按功能分组资源看 references/bundles.md；清单声明看 references/manifests.md；缓存查询与清理看 references/caching.md；后台预载看 references/background.md；加载进度看 references/progress.md；GPU 压缩格式看 references/compressed-textures.md；SVG 矢量与栅格看 references/svg.md；Retina 与格式检测看 references/resolution.md。
11. 按决策指南选择方案：单张图片用 Assets.load(url)；按关卡/场景分组用 bundle；构建期已知全部资源用 manifest 配合 Assets.init；需要加载条给 Assets.load 传进度回调；关卡间平滑过渡用后台加载下一关；内存预算紧张用压缩纹理并在切屏时 Assets.unload；需要任意尺寸清晰 SVG 图标按 Graphics 加载；Retina 加 WebP/AVIF 配置 texturePreference 并使用格式模式。
12. 区分两种选项：LoadOptions 是 Assets.load/loadBundle 的第二个参数，控制整次加载的错误恢复、重试、进度与完成回调；data 是每个资源描述符上的字段，向该资源的具体加载器转发解析器专属选项。
13. 用 LoadOptions 配置 onProgress(progress)（[0,1]）、onError(error, url)（url 为 string | ResolvedAsset，读取 .src 前先判断类型）、strategy（'throw' 默认 | 'skip' | 'retry'）、retryCount（默认 3）、retryDelay（默认 250ms）。
14. 全局默认放在 Loader.defaultOptions，或通过 Assets.init() 的 loadOptions 传入。
15. 按资源类型设置 data：纹理用 TextureSourceOptions（resolution、scaleMode、alphaMode、autoGenerateMipmaps、antialias、addressMode）；SVG 用 { parseAsGraphicsContext?, resolution? }；视频用 VideoSourceOptions（autoPlay、loop、muted、playsinline、preload、updateFPS、crossorigin、mime）；Web 字体用 LoadFontData（family、weights、style、display、unicodeRange、featureSettings）；位图字体自动配置（距离场检测会设置缩放模式与 mipmap）；图集用 { texture?, imageFilename?, ignoreMultiPack?, textureOptions?, cachePrefix? }；GIF 用 GifBufferOptions（fps、scaleMode、resolution、autoGenerateMipmaps）；压缩纹理用 TextureSourceOptions；JSON/文本原样返回。
16. 在 manifest 或 bundle 中每个条目都可携带自己的 data，例如 { alias: 'tiles', src: 'tiles.png', data: { scaleMode: 'nearest' } }。
17. 用 Assets.init 的运行时配置：defaultSearchParams（附加到每个解析 URL，用于缓存失效）、skipDetections（跳过浏览器格式检测以加快初始化，需显式 texturePreference.format）、bundleIdentifier（自定义 bundle 键解析，使同一别名可存在于多个 bundle）、loadOptions（设置后续所有 Assets.load 的默认 strategy/retryCount/retryDelay/回调）、preferences（crossOrigin、preferWorkers、preferCreateImageBitmap、parseAsGraphicsContext）。
18. 初始化后用 Assets.setPreferences(preferences) 推送新偏好到所有支持的解析器；用 Assets.detections 查看已注册的 FormatDetectionParser 列表；用 Assets.reset() 做内部完整重置（resolver + loader + cache），主要用于测试以便重新执行 Assets.init。
19. 避免用 Texture.from(url) 加载：v8 中它只读缓存不发起网络请求，应先用 await Assets.load(url)，返回值即纹理本身。
20. 避免使用位置参数形式的 Assets.add(key, url)：v8 已移除，改用 Assets.add({ alias, src })。
21. 关卡或屏幕有独立资源集时，切换时调用 Assets.unloadBundle() 释放 GPU 内存，因为 Assets.load() 会无限期缓存纹理。
22. 需要加载进度条时给 Assets.load 传进度回调（见 references/progress.md）。
23. 需要关卡间平滑过渡时后台加载下一关（见 references/background.md）。

适用边界 · 注意事项

• URL 已带扩展名时不要设置 parser，应让自动检测生效。
• 不要用 Texture.from(url) 从 URL 加载资源，它只读缓存。
• 不要使用 v8 已移除的位置参数形式 Assets.add(key, url)。