@seayoo-web/pixi-live2d 0.0.2 → 0.0.3

package/dist/index.js

@@ -21707,9 +21707,23 @@ class Th {
    * @param group - 动作分组名称
    * @param no - 动作编号
    * @param priority - 动作优先级，默认值为 1
+   * @param startTime - 动作开始时间（秒），默认值为 0
+   * @returns Promise，动作开始播放后 resolve
    */
-  startMotion(e, r, i = 1) {
-    return this.model?.motion(e, r, i);
+  async startMotion(e, r, i = 1, n = 0) {
+    if (!this.model) return !1;
+    const s = await this.model.motion(e, r, i);
+    if (s && n > 0) {
+      const a = this.model.internalModel.motionManager.queueManager;
+      if (a) {
+        const o = a._motions;
+        if (o && o.length > 0) {
+          const h = o[o.length - 1];
+          h && h.isAvailable() && h._motion?.setOffsetTime(n);
+        }
+      }
+    }
+    return s;
   }
   /**
    * 播放指定表情
@@ -21729,6 +21743,30 @@ class Th {
       this.model.internalModel.motionManager.on("motionFinish", r);
     });
   }
+  /**
+   * 启用动作循环播放模式
+   * 从第 startTime 秒开始循环播放，直到动画结束
+   * @param startTime - 循环开始时间（秒），默认为 2 秒
+   * @returns 停止循环的函数
+   */
+  loop(e = 2) {
+    if (!this.model)
+      return () => {
+      };
+    let r = !0;
+    const i = this.model.internalModel.motionManager, n = () => {
+      if (!r || !this.model) return;
+      const a = i.queueManager;
+      if (!a) return;
+      const o = a._motions;
+      if (!(!o || o.length === 0))
+        for (const h of o)
+          h && h.isAvailable() && !h.isFinished() && h.getStateTime() >= e && h.setState(e, h.getStateWeight());
+    }, s = this.app.ticker;
+    return s.add(n), () => {
+      r = !1, s.remove(n);
+    };
+  }
   /** 销毁实例，清理资源和监听器 */
   destroy() {
     this.options.autoResize !== !1 && window.removeEventListener("resize", this.handleResize), this.app.destroy(!0);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@seayoo-web/pixi-live2d",
   "description": "pixi-live2d viewer",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -42,8 +42,8 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.1",
-    "@seayoo-web/utils": "^4.4.1",
-    "@seayoo-web/tsconfig": "^1.0.6"
+    "@seayoo-web/tsconfig": "^1.0.6",
+    "@seayoo-web/utils": "^4.4.1"
   },
   "scripts": {
     "build": "vite build && tsc --build --force --emitDeclarationOnly",

package/types/index.d.ts

@@ -73,8 +73,10 @@ export declare class Live2DViewer {
      * @param group - 动作分组名称
      * @param no - 动作编号
      * @param priority - 动作优先级，默认值为 1
+     * @param startTime - 动作开始时间（秒），默认值为 0
+     * @returns Promise，动作开始播放后 resolve
      */
-    startMotion(group: string, no: number, priority?: MotionPriority): Promise<boolean> | undefined;
+    startMotion(group: string, no: number, priority?: MotionPriority, startTime?: number): Promise<boolean>;
     /**
      * 播放指定表情
      * @param name - 表情名称或索引
@@ -82,6 +84,13 @@ export declare class Live2DViewer {
     expression(name: string | number): Promise<boolean> | undefined;
     /** 等待当前动作播放结束 */
     waitForMotionFinish(): Promise<boolean>;
+    /**
+     * 启用动作循环播放模式
+     * 从第 startTime 秒开始循环播放，直到动画结束
+     * @param startTime - 循环开始时间（秒），默认为 2 秒
+     * @returns 停止循环的函数
+     */
+    loop(startTime?: number): () => void;
     /** 销毁实例，清理资源和监听器 */
     destroy(): void;
 }