SuperAPI AI 工具集

pixijs-environments

编程与开发

查看项目

更新于 10-16 03:42

技能介绍

用途:让 PixiJS v8 脱离标准浏览器运行,覆盖 Web Worker、OffscreenCanvas、Node/SSR 以及禁止 unsafe-eval 的 CSP 环境。DOMAdapter 把 PixiJS 的所有 DOM 访问(创建 canvas、加载 Image、fetch、XML 解析)抽象出来,从而可在非浏览器上下文运行。

主要能力与用法:

  1. Web Worker + OffscreenCanvas。主线程通过 canvas.transferControlToOffscreen() 取得 OffscreenCanvas 并 postMessage 给 worker;worker 中先 DOMAdapter.set(WebWorkerAdapter),再 new Application() 并 app.init({ canvas, width, height })。设置适配器必须早于应用初始化。
  2. 环境子路径导入:import "pixi.js/browser" 与 import "pixi.js/webworker";后者有意省略 accessibility、dom、events。
  3. loadEnvironmentExtensions(skip):skip 为 false 加载默认扩展,true 跳过;取代已弃用的 autoDetectEnvironment(自 8.1.6)。
  4. CSP:在阻止 unsafe-eval 的环境中先 import "pixi.js/unsafe-eval",再做渲染器初始化。该导入并非启用 eval,而是用静态 polyfill 取代基于 eval 的代码生成(着色器同步、UBO 同步、uniform 同步、粒子缓冲更新)。
  5. 自定义适配器:实现 Adapter 接口的 createCanvas、createImage、getCanvasRenderingContext2D、getWebGLRenderingContext、getNavigator、getBaseUrl、getFontFaceSet、fetch、parseXML,再 DOMAdapter.set(...)。可用 DOMAdapter.get() 读取当前适配器。

限制:Web Worker 中无 DOM 访问,DOMContainer、AccessibilitySystem 以及基于 Font Loading API 的字体加载不可用,需改用预转换位图字体。旧版 settings.ADAPTER 在 v8 已移除,改用 DOMAdapter.set();代码中不要直接使用 document 或 Image,应经 DOMAdapter.get() 访问。