@seayoo-web/pixi-live2d 0.0.2 → 0.0.4

package/dist/index.js

@@ -21673,7 +21673,7 @@ class Th {
   }
   /** 设置点击交互 */
   setupInteraction() {
-    this.model && (this.model.interactive = !0, this.model.on("pointertap", () => {
+    this.model && (this.model.interactive = this.options.enableMouseTracking !== !1, this.model.on("pointertap", () => {
       this.model?.motion("TapBody");
     }));
   }
@@ -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.4",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -20,6 +20,15 @@
   "engines": {
     "node": ">=22"
   },
+  "scripts": {
+    "build": "vite build && tsc --build --force --emitDeclarationOnly",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint ./**/*.ts",
+    "lint:fix": "eslint ./**/*.ts --fix",
+    "prepublish": "pnpm lint:fix && pnpm build",
+    "test": "vitest --dom",
+    "coverage": "vitest run --coverage"
+  },
   "keywords": [
     "pixi-live2d"
   ],
@@ -41,17 +50,8 @@
     "pixi.js": "6.5.2"
   },
   "devDependencies": {
-    "@types/node": "^22.13.1",
-    "@seayoo-web/utils": "^4.4.1",
-    "@seayoo-web/tsconfig": "^1.0.6"
-  },
-  "scripts": {
-    "build": "vite build && tsc --build --force --emitDeclarationOnly",
-    "type-check": "tsc --noEmit",
-    "lint": "eslint ./**/*.ts",
-    "lint:fix": "eslint ./**/*.ts --fix",
-    "prepublish": "pnpm lint:fix && pnpm build",
-    "test": "vitest --dom",
-    "coverage": "vitest run --coverage"
+    "@seayoo-web/tsconfig": "workspace:^",
+    "@seayoo-web/utils": "workspace:^",
+    "@types/node": "^22.13.1"
   }
-}
+}

package/types/index.d.ts

@@ -23,12 +23,14 @@ export interface Live2DViewerOptions {
     designHeight?: number;
     /** Cubism Core 库的加载 URL */
     cubismCoreUrl?: string;
+    /** 是否响应鼠标/触摸移动进行跟随动画，默认为 true */
+    enableMouseTracking?: boolean;
     /** 模型加载完成后的回调函数 */
     onModelLoaded?: (model: Live2DModel<InternalModel>) => void;
     /** 模型加载失败的回调函数 */
     onModelError?: (error: Error) => void;
 }
-export { MotionPriority };
+export { MotionPriority } from "pixi-live2d-display/cubism4";
 export declare class Live2DViewer {
     /** 引擎加载状态 Promise，用于确保全局只加载一次 Core 库 */
     private static coreLoadingPromise;
@@ -73,8 +75,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 +86,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;
 }