@taole/giftstage 0.1.22 → 0.1.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +21 -0
  2. package/dist/gift-stage.cjs.js +5128 -4132
  3. package/dist/gift-stage.es.js +11803 -9438
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -149,6 +149,27 @@ await stage.addGift({
149
149
  资源下载 / 解析 / 图像解码的并发数。
150
150
  不传时自动跟随 `navigator.hardwareConcurrency`。
151
151
 
152
+ - `svgaAtlasFrameBudgetMs?: number`
153
+ SVGA atlas 在主线程组合或逐页上传时的单帧时间片上限，默认 `12ms`。
154
+ 实际时间片会按当前刷新周期的一半动态调整，避免高刷新率设备上的加载任务挤占渲染帧。
155
+
156
+ - `svgaLoadFrameBudgetMs?: number`
157
+ SVGA 主线程加载任务的共享时间片上限，默认 `12ms`。图片 fallback、atlas、clip、音频、slot 纹理和二进制缓存共用同一帧预算。
158
+
159
+ - `svgaWorkerFrameBudgetMs?: number`
160
+ SVGA Worker 连续执行 JS 循环的时间片上限，默认 `4ms`，范围 `1-8ms`。单次 WASM protobuf 调用和单次原生 API 调用仍不可抢占。
161
+
162
+ - `svgaWorkerTaskConcurrency?: number`
163
+ parser、图片解码、atlas 和 clip 等 CPU 密集 Worker 的全局并发上限，默认 `1`。Atlas 首帧页面可提前返回，但后台 PNG 编码完成前仍持有该名额，避免与其他重载 Worker 叠加。
164
+
165
+ - `svgaWorkerImageDecodeConcurrency?: number`
166
+ 图片解码 Worker 内 `createImageBitmap` 并发上限，默认 `2`。运行时可按批次耗时收缩并发，负载恢复后回升，但不会超过该上限。
167
+
168
+ - `svgaParseProfile?: boolean`
169
+ 是否输出 `[GiftStage:SVGA:Profile]` 结构化解析日志，默认 `false`。日志包含 `DecompressionStream` 格式尝试、输入/输出 chunk、解压耗时以及 protobuf/payload 构建耗时；WASM payload 路径还会拆分 `prostDecodeMs`、`metadataAndImagesMs`、`frameTableMs`、`finalizeMs` 和 WASM 边界复制耗时。缓存命中不输出。
170
+
171
+ SVGA 礼物在加载阶段被 `destroy()` / `removeGift()` 时，会取消排队任务并终止正在执行的 parser、图片解码、atlas 或 clip Worker。相同 URL 的共享加载按消费者计数，单个礼物取消不会中断其他仍在等待的礼物。
172
+
152
173
  - `onError?: (error: Error) => void`
153
174
  统一错误回调。
154
175