@starcried/starlite-vrm 0.1.0-alpha.1 → 0.1.0-alpha.2

package/README.md

@@ -29,7 +29,7 @@ const controller = await mountModelWidget(host, {
 });
 ```
 
-上例不需要另备动作文件。运行时自动使用模型名为 `Idle` 的动作，否则采用程序唯一内置的 `StarLiteIdle`（基础站姿与轻呼吸）。可通过 `animations: [{name: "Wave", url: "/Wave.vrma"}]` 添加自己的外部动作，或用 `ambient` 和 `neutralAnimation` 指定基础循环与站姿。不附带模型或其他动作库。显式 `ambient: {animations: []}` 可停用基础循环。眨眼需要有效的标准 Blink 表达，眼球跟随需要正确的 VRM lookAt 映射。模型必须自包含，不接受外部纹理或 buffer 引用。
+上例不需要另备动作文件。运行时自动使用模型名为 `Idle` 的动作，否则采用程序唯一内置的 `StarLiteIdle`（基础站姿与轻呼吸）。可通过 `animations: [{name: "Wave", url: "/Wave.vrma"}]` 添加自己的外部动作，或用 `ambient` 和 `neutralAnimation` 指定基础循环与站姿。不附带模型或其他动作库。显式 `ambient: {animations: []}` 可停用基础循环。眨眼为可选能力：需要有效的标准 Blink 表达，或完整的左右 Blink 表达；缺少时模型仍可使用，只停用自动眨眼。眼球跟随需要正确的 VRM lookAt 映射。模型必须自包含，不接受外部纹理或 buffer 引用。
 
 `inspectVrm(bytes).animations` 返回模型内嵌动作的名称和时长；将名称列表传入 `embeddedAnimations`，即可在 `ambient`、点击与气泡配置中引用。实际加载后 `getAnimations()` 自动列出内嵌动作和外部 VRMA。未命名动作按顺序显示为 `Animation_1` 等；内嵌动作、外部动作名称不得重复，`StarLiteIdle` 为默认 Idle 保留名。角色配置也可放在模型 JSON 的 `extras.starlite.profile`，内容须符合数据型角色配置规范。
 

package/dist/character.d.ts

@@ -1,4 +1,4 @@
-import type { VRM } from "@pixiv/three-vrm";
+import { type VRM } from "@pixiv/three-vrm";
 import type { CharacterProfile } from "./types.js";
 export declare function sampleCurve(curve: readonly (readonly [number, number])[], time: number): number;
 export declare class CharacterBehavior {

package/dist/character.js

@@ -1,4 +1,5 @@
 import { Quaternion, Vector3 } from "three";
+import { VRMExpressionMorphTargetBind } from "@pixiv/three-vrm";
 export function sampleCurve(curve, time) {
     for (let i = 1; i < curve.length; i++) {
         const a = curve[i - 1], b = curve[i];
@@ -10,6 +11,7 @@ export function sampleCurve(curve, time) {
 export class CharacterBehavior {
     #vrm;
     #profile;
+    #blinkExpressions;
     #morphs = new Map();
     #earBones = new Map();
     #baseEar = new Map();
@@ -20,6 +22,12 @@ export class CharacterBehavior {
     constructor(vrm, profile) {
         this.#vrm = vrm;
         this.#profile = profile;
+        const usable = (name) => vrm.expressionManager?.getExpression(name)?.binds.some(bind => bind instanceof VRMExpressionMorphTargetBind && bind.weight > 0
+            && bind.primitives.some(mesh => mesh.morphTargetInfluences?.[bind.index] !== undefined)) ?? false;
+        // Prefer a combined Blink. A complete left/right pair is equivalent; a
+        // lone eyelid must not turn an ordinary blink into an unintended wink.
+        this.#blinkExpressions = usable("blink") ? ["blink"]
+            : usable("blinkLeft") && usable("blinkRight") ? ["blinkLeft", "blinkRight"] : [];
         if (!profile)
             return;
         vrm.scene.traverse((object) => {
@@ -61,9 +69,12 @@ export class CharacterBehavior {
         // Each custom correction closes its expression's share of the eyelids.
         // Ordinary blink must still close the remaining Basis share during fades.
         const curve = this.#profile?.blink.curve ?? [[0, 0], [3.4, 0], [3.48, 1], [3.52, 1], [3.65, 0], [4.7, 0]];
-        this.#authoredBlink = authoredBlink ? manager?.getValue("blink") ?? 0 : undefined;
-        this.#blinkAmount = this.#authoredBlink ?? sampleCurve(curve, this.#time % (this.#profile?.blink.period ?? 4.7));
-        manager?.setValue("blink", Math.max(0, 1 - total) * this.#blinkAmount);
+        this.#authoredBlink = authoredBlink ? new Map(this.#blinkExpressions.map(name => [name, manager?.getValue(name) ?? 0])) : undefined;
+        this.#blinkAmount = this.#authoredBlink ? Math.max(0, ...this.#authoredBlink.values()) : sampleCurve(curve, this.#time % (this.#profile?.blink.period ?? 4.7));
+        for (const name of this.#blinkExpressions) {
+            const amount = this.#authoredBlink?.get(name) ?? this.#blinkAmount;
+            manager?.setValue(name, Math.max(0, 1 - total) * amount);
+        }
     }
     afterExpressions() {
         const profile = this.#profile;
@@ -120,8 +131,8 @@ export class CharacterBehavior {
         }
         // Only the applied neutral share changes; the animation's sampled value
         // remains available to the next authored frame or captured-pose transition.
-        if (this.#authoredBlink !== undefined)
-            this.#vrm.expressionManager?.setValue("blink", this.#authoredBlink);
+        for (const [name, value] of this.#authoredBlink ?? [])
+            this.#vrm.expressionManager?.setValue(name, value);
         this.#authoredBlink = undefined;
     }
     reset() { this.#time = 0; this.#weights = ""; this.#blinkAmount = 0; this.#authoredBlink = undefined; }