sa2kit 1.0.9 → 1.1.0

package/dist/mmd/index.d.mts

@@ -264,7 +264,7 @@ declare const MMDPlayerBase: React__default.FC<MMDPlayerBaseProps>;
  * 支持通过 resources 和 stage 配置快速使用
  * 所有资源均从 public 目录加载，无需额外配置
  */
-declare const MMDPlayerEnhanced: React__default.FC<MMDPlayerEnhancedProps>;
+declare const MMDPlayerEnhanced: React__default.ForwardRefExoticComponent<MMDPlayerEnhancedProps & React__default.RefAttributes<any>>;
 
 /**
  * MMD 播放列表组件（预加载版本）

package/dist/mmd/index.d.ts

@@ -264,7 +264,7 @@ declare const MMDPlayerBase: React__default.FC<MMDPlayerBaseProps>;
  * 支持通过 resources 和 stage 配置快速使用
  * 所有资源均从 public 目录加载，无需额外配置
  */
-declare const MMDPlayerEnhanced: React__default.FC<MMDPlayerEnhancedProps>;
+declare const MMDPlayerEnhanced: React__default.ForwardRefExoticComponent<MMDPlayerEnhancedProps & React__default.RefAttributes<any>>;
 
 /**
  * MMD 播放列表组件（预加载版本）

package/dist/mmd/index.js

@@ -298,7 +298,7 @@ var MMDPlayerBase = ({
     } }, error)
   );
 };
-var MMDPlayerEnhanced = ({
+var MMDPlayerEnhanced = React2.forwardRef(({
   resources,
   resourcesList,
   defaultResourceId,
@@ -315,82 +315,8 @@ var MMDPlayerEnhanced = ({
   onSelectionChange,
   onAudioEnded,
   onAnimationEnded
-}) => {
+}, ref) => {
   console.log("\u{1F3A8} [MMDPlayerEnhanced] \u7EC4\u4EF6\u521D\u59CB\u5316");
-  React2.useEffect(() => {
-    return () => {
-      console.log("\u{1F9F9} [MMDPlayerEnhanced] \u7EC4\u4EF6\u5378\u8F7D\uFF0C\u6267\u884C\u5B8C\u6574\u6E05\u7406");
-      if (animationIdRef.current) {
-        cancelAnimationFrame(animationIdRef.current);
-        animationIdRef.current = null;
-      }
-      if (audioRef.current) {
-        audioRef.current.pause();
-        audioRef.current.src = "";
-        audioRef.current.load();
-        audioRef.current = null;
-      }
-      if (helperRef.current) {
-        try {
-          helperRef.current.enable("animation", false);
-          helperRef.current.enable("ik", false);
-          helperRef.current.enable("grant", false);
-          helperRef.current.enable("physics", false);
-          const helperObjects = helperRef.current.objects;
-          if (helperObjects && Array.isArray(helperObjects)) {
-            const physicsWorldsToDestroy = /* @__PURE__ */ new Set();
-            helperObjects.forEach((obj) => {
-              if (obj.physics) {
-                const physics = obj.physics;
-                if (physics.world) physicsWorldsToDestroy.add(physics.world);
-                if (physics.bodies) physics.bodies.length = 0;
-                if (physics.constraints) physics.constraints.length = 0;
-                obj.physics = null;
-              }
-            });
-            physicsWorldsToDestroy.forEach((world) => {
-              try {
-                while (world.getNumCollisionObjects() > 0) {
-                  const obj = world.getCollisionObjectArray().at(0);
-                  world.removeCollisionObject(obj);
-                  if (obj && obj.destroy) obj.destroy();
-                }
-                if (world.destroy) world.destroy();
-              } catch (e) {
-              }
-            });
-            helperObjects.length = 0;
-          }
-        } catch (e) {
-        }
-        helperRef.current = null;
-      }
-      if (sceneRef.current) {
-        sceneRef.current.clear();
-        sceneRef.current = null;
-      }
-      if (rendererRef.current) {
-        rendererRef.current.dispose();
-        rendererRef.current = null;
-      }
-      if (controlsRef.current) {
-        controlsRef.current.dispose();
-        controlsRef.current = null;
-      }
-      cameraRef.current = null;
-      if (clockRef.current) {
-        clockRef.current = new THREE2__namespace.Clock();
-      }
-      vmdDataRef.current = null;
-      if (window.gc) {
-        try {
-          window.gc();
-        } catch (e) {
-        }
-      }
-      console.log("\u2705 [MMDPlayerEnhanced] \u7EC4\u4EF6\u5378\u8F7D\u6E05\u7406\u5B8C\u6210");
-    };
-  }, []);
   const [selectedResourceId, setSelectedResourceId] = React2.useState(
     defaultResourceId || resourcesList?.[0]?.id || ""
   );
@@ -482,6 +408,55 @@ var MMDPlayerEnhanced = ({
   const [isInitialized, setIsInitialized] = React2.useState(false);
   const [reloadTrigger, setReloadTrigger] = React2.useState(0);
   const [needReset, setNeedReset] = React2.useState(false);
+  React2.useImperativeHandle(ref, () => ({
+    clearResources: () => {
+      console.log("\u{1F9F9} [MMDPlayerEnhanced] \u5916\u90E8\u89E6\u53D1\u8D44\u6E90\u6E05\u7406");
+      clearOldResources();
+    },
+    getIsPlaying: () => isPlayingRef.current,
+    getIsLoaded: () => isLoadedRef.current,
+    stopCompletely: () => {
+      console.log("\u23F9\uFE0F [MMDPlayerEnhanced] \u5B8C\u5168\u505C\u6B62");
+      stopCompletely();
+    }
+  }));
+  const stopCompletely = () => {
+    isPlayingRef.current = false;
+    setIsPlaying(false);
+    if (audioRef.current) {
+      audioRef.current.pause();
+      audioRef.current.currentTime = 0;
+    }
+    if (helperRef.current) {
+      helperRef.current.enable("physics", false);
+    }
+    animationEndedFiredRef.current = false;
+    lastAnimationTimeRef.current = 0;
+    animationStoppedCountRef.current = 0;
+    console.log("\u2705 [MMDPlayerEnhanced] \u5B8C\u5168\u505C\u6B62\u5B8C\u6210");
+  };
+  React2.useEffect(() => {
+    const container = containerRef.current;
+    if (!container) return;
+    const handleCleanupResources = () => {
+      console.log("\u{1F9F9} [MMDPlayerEnhanced] \u6536\u5230\u6E05\u7406\u8D44\u6E90\u4E8B\u4EF6");
+      if (!isPlayingRef.current) {
+        clearOldResources();
+      } else {
+        console.warn("\u26A0\uFE0F [MMDPlayerEnhanced] \u64AD\u653E\u4E2D\uFF0C\u8DF3\u8FC7\u8D44\u6E90\u6E05\u7406");
+      }
+    };
+    const handleStopCompletely = () => {
+      console.log("\u23F9\uFE0F [MMDPlayerEnhanced] \u6536\u5230\u5B8C\u5168\u505C\u6B62\u4E8B\u4EF6");
+      stopCompletely();
+    };
+    container.addEventListener("cleanupResources", handleCleanupResources);
+    container.addEventListener("stopCompletely", handleStopCompletely);
+    return () => {
+      container.removeEventListener("cleanupResources", handleCleanupResources);
+      container.removeEventListener("stopCompletely", handleStopCompletely);
+    };
+  }, []);
   React2.useEffect(() => {
     console.log("\u{1F3D7}\uFE0F [MMDPlayerEnhanced] \u573A\u666F\u521D\u59CB\u5316 useEffect \u89E6\u53D1");
     if (!containerRef.current) {
@@ -747,7 +722,6 @@ var MMDPlayerEnhanced = ({
     if (window.gc) {
       try {
         window.gc();
-        console.log("\u267B\uFE0F \u5DF2\u89E6\u53D1\u5783\u573E\u56DE\u6536");
       } catch (e) {
       }
     }
@@ -916,75 +890,13 @@ var MMDPlayerEnhanced = ({
     loadMMD();
   }, [currentResources, stage?.enablePhysics, autoPlay, loop, onLoad, onError, reloadTrigger]);
   const play = () => {
+    if (!helperRef.current && !needReset) return;
     if (needReset && vmdDataRef.current && sceneRef.current && cameraRef.current) {
-      console.log("\u{1F504} \u68C0\u6D4B\u5230\u9700\u8981\u91CD\u7F6E\uFF0C\u5F00\u59CB\u5F3A\u5236\u6E05\u7406...");
-      if (animationIdRef.current) {
-        cancelAnimationFrame(animationIdRef.current);
-        animationIdRef.current = null;
-      }
+      const { mesh, vmd, cameraVmd } = vmdDataRef.current;
       if (helperRef.current) {
         try {
-          helperRef.current.enable("animation", false);
-          helperRef.current.enable("ik", false);
-          helperRef.current.enable("grant", false);
-          helperRef.current.enable("physics", false);
           const helperObjects = helperRef.current.objects;
           if (helperObjects && Array.isArray(helperObjects)) {
-            const physicsWorldsToDestroy = /* @__PURE__ */ new Set();
-            helperObjects.forEach((obj) => {
-              if (obj.physics) {
-                try {
-                  const physics = obj.physics;
-                  if (physics.world) {
-                    physicsWorldsToDestroy.add(physics.world);
-                  }
-                  if (physics.bodies && Array.isArray(physics.bodies)) {
-                    physics.bodies.forEach((body) => {
-                      if (physics.world && body) {
-                        try {
-                          physics.world.removeRigidBody(body);
-                          if (window.Ammo && body.destroy) {
-                            body.destroy();
-                          }
-                        } catch (e) {
-                        }
-                      }
-                    });
-                    physics.bodies.length = 0;
-                    physics.bodies = null;
-                  }
-                  if (physics.constraints && Array.isArray(physics.constraints)) {
-                    physics.constraints.forEach((constraint) => {
-                      if (physics.world && constraint) {
-                        try {
-                          physics.world.removeConstraint(constraint);
-                          if (window.Ammo && constraint.destroy) {
-                            constraint.destroy();
-                          }
-                        } catch (e) {
-                        }
-                      }
-                    });
-                    physics.constraints.length = 0;
-                    physics.constraints = null;
-                  }
-                  physics.world = null;
-                  obj.physics = null;
-                } catch (e) {
-                }
-              }
-            });
-            physicsWorldsToDestroy.forEach((world) => {
-              try {
-                while (world.getNumCollisionObjects() > 0) {
-                  const obj = world.getCollisionObjectArray().at(0);
-                  world.removeCollisionObject(obj);
-                  if (obj && obj.destroy) obj.destroy();
-                }
-                if (world.destroy) world.destroy();
-              } catch (e) {
-              }
-            });
             helperObjects.length = 0;
           }
         } catch (error2) {
@@ -993,7 +905,6 @@ var MMDPlayerEnhanced = ({
       const newHelper = new threeStdlib.MMDAnimationHelper();
       helperRef.current = newHelper;
       clockRef.current = new THREE2__namespace.Clock();
-      const { mesh, vmd, cameraVmd } = vmdDataRef.current;
       if (vmd && typeof vmd === "object") {
         try {
           newHelper.add(mesh, {
@@ -1022,7 +933,6 @@ var MMDPlayerEnhanced = ({
         audioRef.current.currentTime = 0;
       }
       setNeedReset(false);
-      console.log("\u2705 \u5F3A\u5236\u6E05\u7406\u5B8C\u6210\uFF0C\u5F00\u59CB\u64AD\u653E");
     }
     if (!helperRef.current) {
       console.error("\u274C [play] helper \u4E0D\u5B58\u5728\uFF0C\u65E0\u6CD5\u64AD\u653E");
@@ -1057,7 +967,6 @@ var MMDPlayerEnhanced = ({
   };
   const stop = () => {
     if (!helperRef.current || !sceneRef.current) return;
-    console.log("\u23F9\uFE0F \u505C\u6B62\u64AD\u653E\uFF0C\u5F00\u59CB\u6E05\u7406\u7269\u7406\u7CFB\u7EDF...");
     isPlayingRef.current = false;
     setIsPlaying(false);
     if (audioRef.current) {
@@ -1066,73 +975,6 @@ var MMDPlayerEnhanced = ({
     }
     clockRef.current.stop();
     clockRef.current = new THREE2__namespace.Clock();
-    try {
-      helperRef.current.enable("animation", false);
-      helperRef.current.enable("ik", false);
-      helperRef.current.enable("grant", false);
-      helperRef.current.enable("physics", false);
-      const helperObjects = helperRef.current.objects;
-      if (helperObjects && Array.isArray(helperObjects)) {
-        const physicsWorldsToDestroy = /* @__PURE__ */ new Set();
-        helperObjects.forEach((obj) => {
-          if (obj.physics) {
-            try {
-              const physics = obj.physics;
-              if (physics.world) {
-                physicsWorldsToDestroy.add(physics.world);
-              }
-              if (physics.bodies && Array.isArray(physics.bodies)) {
-                physics.bodies.forEach((body) => {
-                  if (physics.world && body) {
-                    try {
-                      physics.world.removeRigidBody(body);
-                      if (window.Ammo && body.destroy) {
-                        body.destroy();
-                      }
-                    } catch (e) {
-                    }
-                  }
-                });
-                physics.bodies.length = 0;
-                physics.bodies = null;
-              }
-              if (physics.constraints && Array.isArray(physics.constraints)) {
-                physics.constraints.forEach((constraint) => {
-                  if (physics.world && constraint) {
-                    try {
-                      physics.world.removeConstraint(constraint);
-                      if (window.Ammo && constraint.destroy) {
-                        constraint.destroy();
-                      }
-                    } catch (e) {
-                    }
-                  }
-                });
-                physics.constraints.length = 0;
-                physics.constraints = null;
-              }
-              physics.world = null;
-              obj.physics = null;
-            } catch (e) {
-            }
-          }
-        });
-        physicsWorldsToDestroy.forEach((world) => {
-          try {
-            while (world.getNumCollisionObjects() > 0) {
-              const obj = world.getCollisionObjectArray().at(0);
-              world.removeCollisionObject(obj);
-              if (obj && obj.destroy) obj.destroy();
-            }
-            if (world.destroy) world.destroy();
-          } catch (e) {
-          }
-        });
-        helperObjects.length = 0;
-      }
-    } catch (error2) {
-      console.warn("\u505C\u6B62\u65F6\u6E05\u7406\u7269\u7406\u7CFB\u7EDF\u5931\u8D25:", error2);
-    }
     const mesh = sceneRef.current.children.find(
       (child) => child.type === "SkinnedMesh" || child.isSkinnedMesh
     );
@@ -1151,7 +993,7 @@ var MMDPlayerEnhanced = ({
       }
     }
     setNeedReset(true);
-    console.log("\u2705 \u505C\u6B62\u64AD\u653E\u5E76\u6E05\u7406\u5B8C\u6210\uFF0CneedReset = true");
+    console.log("\u23F9\uFE0F \u505C\u6B62\u64AD\u653E\u5E76\u91CD\u7F6E\u5230\u521D\u59CB\u72B6\u6001\uFF0CneedReset = true");
   };
   const handleResourceChange = (resourceId) => {
     console.log("\u{1F504} [MMDPlayerEnhanced] \u5207\u6362\u8D44\u6E90:", resourceId);
@@ -1432,7 +1274,8 @@ var MMDPlayerEnhanced = ({
     },
     background.name
   )))))));
-};
+});
+MMDPlayerEnhanced.displayName = "MMDPlayerEnhanced";
 var MMDPlaylist = ({
   playlist,
   stage,
@@ -1455,6 +1298,8 @@ var MMDPlaylist = ({
   const currentNodeIndexRef = React2.useRef(defaultNodeIndex);
   const isAutoSwitchRef = React2.useRef(false);
   const playerRefsMap = React2.useRef(/* @__PURE__ */ new Map());
+  const playerComponentRefs = React2.useRef(/* @__PURE__ */ new Map());
+  const [memoryUsage, setMemoryUsage] = React2.useState(0);
   React2.useEffect(() => {
     currentNodeIndexRef.current = currentNodeIndex;
   }, [currentNodeIndex]);
@@ -1465,24 +1310,62 @@ var MMDPlaylist = ({
   }
   console.log("\u{1F3AF} [MMDPlaylist] \u5F53\u524D\u8282\u70B9:", currentNode.name, "\u7D22\u5F15:", currentNodeIndex);
   const stopNode = (nodeIndex) => {
-    const playerElement = playerRefsMap.current.get(nodeIndex);
-    if (!playerElement) return;
-    console.log(`\u23F9\uFE0F [MMDPlaylist] \u505C\u6B62\u8282\u70B9 ${nodeIndex}`);
-    const audioElement = playerElement.querySelector("audio");
-    if (audioElement) {
-      audioElement.pause();
-      audioElement.currentTime = 0;
-      console.log(`  \u{1F507} \u505C\u6B62\u97F3\u9891`);
+    const playerComponent = playerComponentRefs.current.get(nodeIndex);
+    if (playerComponent && playerComponent.stopCompletely) {
+      console.log(`\u23F9\uFE0F [MMDPlaylist] \u505C\u6B62\u8282\u70B9 ${nodeIndex}`);
+      playerComponent.stopCompletely();
+    } else {
+      const playerElement = playerRefsMap.current.get(nodeIndex);
+      if (!playerElement) return;
+      console.log(`\u23F9\uFE0F [MMDPlaylist] \u505C\u6B62\u8282\u70B9 ${nodeIndex} (DOM\u65B9\u5F0F)`);
+      const audioElement = playerElement.querySelector("audio");
+      if (audioElement) {
+        audioElement.pause();
+        audioElement.currentTime = 0;
+        console.log(`  \u{1F507} \u505C\u6B62\u97F3\u9891`);
+      }
+      const stopEvent = new CustomEvent("stopCompletely");
+      playerElement.dispatchEvent(stopEvent);
+      console.log(`  \u{1F4E1} \u53D1\u9001\u505C\u6B62\u4E8B\u4EF6`);
     }
-    const stopButton = playerElement.querySelector('button[title="\u505C\u6B62"]');
-    if (stopButton) {
-      stopButton.click();
-      console.log(`  \u23F9\uFE0F \u70B9\u51FB\u505C\u6B62\u6309\u94AE`);
+  };
+  const clearNodeResources = (nodeIndex, excludeCurrent = true) => {
+    if (excludeCurrent && nodeIndex === currentNodeIndex) {
+      console.log(`\u26A0\uFE0F [MMDPlaylist] \u8DF3\u8FC7\u6E05\u7406\u5F53\u524D\u64AD\u653E\u8282\u70B9 ${nodeIndex}`);
+      return;
+    }
+    const playerComponent = playerComponentRefs.current.get(nodeIndex);
+    if (playerComponent && playerComponent.clearResources) {
+      console.log(`\u{1F9F9} [MMDPlaylist] \u6E05\u7406\u8282\u70B9 ${nodeIndex} \u8D44\u6E90`);
+      playerComponent.clearResources();
     } else {
-      const pauseButton = playerElement.querySelector('button[title="\u6682\u505C"]');
-      if (pauseButton) {
-        pauseButton.click();
-        console.log(`  \u23F8\uFE0F \u70B9\u51FB\u6682\u505C\u6309\u94AE`);
+      const playerElement = playerRefsMap.current.get(nodeIndex);
+      if (playerElement) {
+        const cleanupEvent = new CustomEvent("cleanupResources");
+        playerElement.dispatchEvent(cleanupEvent);
+      }
+    }
+  };
+  const emergencyMemoryCleanup = () => {
+    if (window.performance?.memory) {
+      const memInfo = window.performance.memory;
+      const usage = memInfo.usedJSHeapSize / memInfo.totalJSHeapSize;
+      if (usage > 0.9) {
+        console.error(`\u{1F6A8} [MMDPlaylist] \u5185\u5B58\u4F7F\u7528\u4E25\u91CD\u8FC7\u9AD8 (${(usage * 100).toFixed(1)}%)\uFF0C\u7D27\u6025\u6E05\u7406`);
+        const nodesToClean = editableNodes.map((_, index) => ({
+          index,
+          distance: Math.abs(index - currentNodeIndex)
+        })).filter((node) => node.distance > 2).sort((a, b) => b.distance - a.distance).slice(0, 2);
+        nodesToClean.forEach(({ index }) => {
+          console.warn(`\u{1F9F9} [MMDPlaylist] \u7D27\u6025\u6E05\u7406\u8282\u70B9 ${index}`);
+          clearNodeResources(index, false);
+        });
+        if (window.gc) {
+          try {
+            window.gc();
+          } catch (e) {
+          }
+        }
       }
     }
   };
@@ -1493,6 +1376,19 @@ var MMDPlaylist = ({
         stopNode(index);
       }
     });
+    const nodesToKeep = /* @__PURE__ */ new Set();
+    nodesToKeep.add(currentNodeIndex);
+    if (playlist.loop && currentNodeIndex > 0) {
+      nodesToKeep.add(currentNodeIndex - 1);
+    }
+    if (currentNodeIndex < editableNodes.length - 1) {
+      nodesToKeep.add(currentNodeIndex + 1);
+    }
+    editableNodes.forEach((_, index) => {
+      if (!nodesToKeep.has(index)) {
+        clearNodeResources(index, false);
+      }
+    });
     onNodeChange?.(currentNodeIndex, currentNode);
     if (!isPreloading && (isAutoSwitchRef.current || playlist.autoPlay)) {
       console.log(`\u25B6\uFE0F [MMDPlaylist] \u51C6\u5907\u64AD\u653E\u8282\u70B9 ${currentNodeIndex}`);
@@ -1515,7 +1411,7 @@ var MMDPlaylist = ({
         }
       });
     }
-  }, [currentNodeIndex, currentNode, onNodeChange, isPreloading, playlist.autoPlay, preloadedNodes, editableNodes]);
+  }, [currentNodeIndex, currentNode, onNodeChange, isPreloading, playlist.autoPlay, playlist.loop, preloadedNodes, editableNodes]);
   const handleNodePreloaded = (nodeIndex) => {
     console.log(`\u2705 [MMDPlaylist] \u8282\u70B9 ${nodeIndex} \u9884\u52A0\u8F7D\u5B8C\u6210`);
     setPreloadedNodes((prev) => {
@@ -1534,6 +1430,20 @@ var MMDPlaylist = ({
       setPreloadProgress(progress);
     }
   }, [preloadedNodes, editableNodes.length, onLoad]);
+  React2.useEffect(() => {
+    const checkMemory = () => {
+      if (window.performance?.memory) {
+        const memInfo = window.performance.memory;
+        const usage = memInfo.usedJSHeapSize / memInfo.totalJSHeapSize;
+        setMemoryUsage(usage);
+        if (usage > 0.9) {
+          emergencyMemoryCleanup();
+        }
+      }
+    };
+    const interval = setInterval(checkMemory, 15e3);
+    return () => clearInterval(interval);
+  }, [currentNodeIndex, editableNodes]);
   const handlePlaybackEnded = (nodeIndex) => {
     console.log(`\u{1F3B5} [MMDPlaylist] \u8282\u70B9 ${nodeIndex} \u64AD\u653E\u5B8C\u6210`);
     if (nodeIndex !== currentNodeIndexRef.current) {
@@ -1643,6 +1553,11 @@ var MMDPlaylist = ({
       /* @__PURE__ */ React2__default.default.createElement(
         MMDPlayerEnhanced,
         {
+          ref: (componentRef) => {
+            if (componentRef) {
+              playerComponentRefs.current.set(index, componentRef);
+            }
+          },
           resources: node.resources,
           stage,
           autoPlay: index === currentNodeIndex && shouldAutoPlayInitial,