@realsee/dnalogel 3.81.10 → 3.81.11-alpha.1

package/libs/DigitalPerformancePlugin/controller/index.js

@@ -1,71 +1,74 @@
-var D = Object.defineProperty, k = Object.defineProperties;
+var S = Object.defineProperty, k = Object.defineProperties;
 var H = Object.getOwnPropertyDescriptors;
-var S = Object.getOwnPropertySymbols;
-var I = Object.prototype.hasOwnProperty, U = Object.prototype.propertyIsEnumerable;
-var v = (d, t, e) => t in d ? D(d, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : d[t] = e, E = (d, t) => {
+var D = Object.getOwnPropertySymbols;
+var I = Object.prototype.hasOwnProperty, R = Object.prototype.propertyIsEnumerable;
+var v = (f, t, e) => t in f ? S(f, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : f[t] = e, E = (f, t) => {
   for (var e in t || (t = {}))
-    I.call(t, e) && v(d, e, t[e]);
-  if (S)
-    for (var e of S(t))
-      U.call(t, e) && v(d, e, t[e]);
-  return d;
-}, x = (d, t) => k(d, H(t));
-var P = (d, t, e) => (v(d, typeof t != "symbol" ? t + "" : t, e), e);
-var m = (d, t, e) => new Promise((i, s) => {
-  var o = (a) => {
+    I.call(t, e) && v(f, e, t[e]);
+  if (D)
+    for (var e of D(t))
+      R.call(t, e) && v(f, e, t[e]);
+  return f;
+}, x = (f, t) => k(f, H(t));
+var d = (f, t, e) => (v(f, typeof t != "symbol" ? t + "" : t, e), e);
+var m = (f, t, e) => new Promise((i, a) => {
+  var r = (n) => {
     try {
-      n(e.next(a));
+      o(e.next(n));
     } catch (l) {
-      s(l);
+      a(l);
     }
-  }, r = (a) => {
+  }, s = (n) => {
     try {
-      n(e.throw(a));
+      o(e.throw(n));
     } catch (l) {
-      s(l);
+      a(l);
     }
-  }, n = (a) => a.done ? i(a.value) : Promise.resolve(a.value).then(o, r);
-  n((e = e.apply(d, t)).next());
+  }, o = (n) => n.done ? i(n.value) : Promise.resolve(n.value).then(r, s);
+  o((e = e.apply(f, t)).next());
 });
-import { DigitalPlayground as R } from "../core/DigitalPlayground.js";
-import { Vector3 as w } from "three";
+import { DigitalPlayground as U } from "../core/DigitalPlayground.js";
+import { Vector3 as $ } from "three";
 import { convertMockToPlayer as z } from "../mock.js";
-import { transformPosition as N } from "../../shared-utils/five/transformPosition.js";
+import { transformPosition as w } from "../../shared-utils/five/transformPosition.js";
+import { DigitalPerformanceNameplate as G, normalizeDigitalPerformanceName as L } from "../core/DigitalPerformanceNameplate.js";
 import "@realsee/five/gltf-loader";
 import "../core/DigitalHuman.js";
 import "../core/DigitalStateMachine.js";
 import "../core/Trace.js";
 import "@realsee/five";
-const G = "Dnalogel-DigitalPerformancePlugin";
-class Q {
+const B = "Dnalogel-DigitalPerformancePlugin";
+class Y {
   constructor(t, e = {}) {
-    P(this, "five");
-    P(this, "playground");
-    P(this, "config");
-    P(this, "state");
-    P(this, "NAME");
+    d(this, "five");
+    d(this, "playground");
+    d(this, "config");
+    d(this, "state");
+    d(this, "NAME");
     // 全局进度条相关属性
-    P(this, "totalDurationCache", null);
-    P(this, "chapterTimeMapCache", null);
-    P(this, "progressListeners", /* @__PURE__ */ new Set());
-    P(this, "progressUpdateInterval", 100);
+    d(this, "totalDurationCache", null);
+    d(this, "chapterTimeMapCache", null);
+    d(this, "progressListeners", /* @__PURE__ */ new Set());
+    d(this, "progressUpdateInterval", 100);
     // 默认100ms更新一次
-    P(this, "progressUpdateTimer", null);
-    P(this, "_autoPlayOnNaturalEnd", !1);
+    d(this, "progressUpdateTimer", null);
+    d(this, "_autoPlayOnNaturalEnd", !1);
     // 新增：playing-players-changed 事件监听集合
-    P(this, "playingPlayersListeners", /* @__PURE__ */ new Set());
+    d(this, "playingPlayersListeners", /* @__PURE__ */ new Set());
+    d(this, "nameplate");
+    d(this, "onNameplateRender", () => this.nameplate.update());
     this.five = t, this.config = E({
       autoPlay: !1,
       loop: !1,
       debug: !1
-    }, e), this.playground = new R(this.config.debug), this.state = {
+    }, e), this.playground = new U(this.config.debug), this.nameplate = new G(t), this.five.on("renderFrame", this.onNameplateRender), this.five.on("cameraUpdate", this.onNameplateRender), this.state = {
       enabled: !0,
       playing: !1,
       currentChapter: null,
       currentScript: null,
       continuousPlaying: !1,
       playMode: "single"
-    }, this.NAME = G, this.config.debug, this.init();
+    }, this.NAME = B, this.config.debug, this.init();
   }
   /**
    * 加载剧本数据
@@ -73,14 +76,14 @@ class Q {
   loadScript(t) {
     return m(this, null, function* () {
       try {
-        if (this.state.currentScript = t, this.playground.setScript(t), this.clearProgressCache(), this.config.debug, yield this.preloadResources(t), this.five && this.five.scene) {
+        if (this.state.currentScript = t, this.nameplate.setBindings([]), this.playground.setScript(t), this.clearProgressCache(), this.config.debug, yield this.preloadResources(t), this.five && this.five.scene) {
           yield new Promise((i) => requestAnimationFrame(i));
           let e = 0;
           if (t.chapters.forEach((i) => {
-            i.players.forEach((s) => {
-              if (s.type === "model") {
-                const o = this.getDigitalHuman(s.model, s.id);
-                o != null && o.model && (this.five.scene.add(o.model), e++);
+            i.players.forEach((a) => {
+              if (a.type === "model") {
+                const r = this.getDigitalHuman(a.model, a.id);
+                r != null && r.model && (this.five.scene.add(r.model), e++);
               }
             });
           }), e === 0)
@@ -99,13 +102,13 @@ class Q {
    */
   preloadResources(t) {
     return m(this, null, function* () {
-      const e = [], i = [], s = /* @__PURE__ */ new Set(), o = [], r = /* @__PURE__ */ new Map();
-      t.chapters.forEach((n) => {
-        n.players.forEach((a) => {
-          if (a.type === "model") {
-            const l = a;
-            e.push(l.model), i.push(a.id), l.keyframes.forEach((u) => {
-              u.animation && (s.add(u.animation.url), u.animation.item && (o.push(u.animation.item.url), r.set(u.animation.item.url, {
+      const e = [], i = [], a = /* @__PURE__ */ new Set(), r = [], s = /* @__PURE__ */ new Map();
+      t.chapters.forEach((o) => {
+        o.players.forEach((n) => {
+          if (n.type === "model") {
+            const l = n;
+            e.push(l.model), i.push(n.id), l.keyframes.forEach((u) => {
+              u.animation && (a.add(u.animation.url), u.animation.item && (r.push(u.animation.item.url), s.set(u.animation.item.url, {
                 position: u.animation.item.position,
                 rotation: u.animation.item.rotation
               })));
@@ -114,8 +117,8 @@ class Q {
         });
       }), yield Promise.all([
         this.playground.loadModels(e, i),
-        this.playground.loadItems(o, r),
-        this.playground.loadAnimations(Array.from(s))
+        this.playground.loadItems(r, s),
+        this.playground.loadAnimations(Array.from(a))
       ]), this.config.debug;
     });
   }
@@ -126,7 +129,7 @@ class Q {
     return m(this, null, function* () {
       this.emitPlayingPlayersChanged();
       try {
-        this.state.currentChapter = t, this.state.playing = !0, this.state.playMode = "single", this.config.debug, yield this.playground.playByChapter(t), this.state.playing = !1, this.config.debug;
+        this.state.currentChapter = t, this.syncNameplates(t), this.state.playing = !0, this.state.playMode = "single", this.config.debug, yield this.playground.playByChapter(t), this.state.playing = !1, this.config.debug;
       } catch (e) {
         throw console.error(`${this.NAME} failed to play chapter:`, e), this.state.playing = !1, e;
       }
@@ -139,7 +142,7 @@ class Q {
     return m(this, null, function* () {
       this.emitPlayingPlayersChanged();
       try {
-        this.state.currentChapter = t, this.state.playing = !0, this.config.debug, yield this.playground.playByChapter(t), this.state.continuousPlaying && (this.state.playing = !0), yield new Promise((e) => setTimeout(e, 100)), this.config.debug;
+        this.state.currentChapter = t, this.syncNameplates(t), this.state.playing = !0, this.config.debug, yield this.playground.playByChapter(t), this.state.continuousPlaying && (this.state.playing = !0), yield new Promise((e) => setTimeout(e, 100)), this.config.debug;
       } catch (e) {
         throw console.error(`${this.NAME} failed to play chapter for continuous:`, e), this.state.playing = !1, e;
       }
@@ -196,77 +199,77 @@ class Q {
         this.config.debug;
         let i = this.getProgress();
         console.log(`${this.NAME} [continueAllRemaining] current progress:`, i), this.emitPlayingPlayersChanged();
-        const s = i && i.currentTime >= 26e3 && i.currentTime <= 27e3, o = i && i.currentTime >= i.totalTime;
+        const a = i && i.currentTime >= 26e3 && i.currentTime <= 27e3, r = i && i.currentTime >= i.totalTime;
         console.log(`${this.NAME} [continueAllRemaining] pause analysis:`, {
           currentTime: i == null ? void 0 : i.currentTime,
           totalTime: i == null ? void 0 : i.totalTime,
-          isCompleted: o,
-          isNearHardcodedPause: s
-        }), o ? (console.log(`${this.NAME} [continueAllRemaining] chapter already completed, restarting`), yield this.playChapterForContinuous(this.state.currentChapter), i = this.getProgress(), console.log(`${this.NAME} [continueAllRemaining] progress after restart:`, i)) : s ? (console.log(`${this.NAME} [continueAllRemaining] detected hardcoded pause, skipping to 27500ms`), this.state.currentChapter.players.filter((n) => n.type === "model").forEach((n) => {
-          const a = this.playground.getDigitalHuman(n.model, n.id);
-          a && (a.state.currentTime = 27500);
-        }), this.state.currentChapter.players.forEach((n) => {
-          if (n.type === "model") {
-            const a = this.playground.getDigitalHuman(n.model, n.id);
-            a && a.continueAnimation();
-          }
-        }), this.state.playing = !0, console.log(`${this.NAME} [continueAllRemaining] after hardcoded pause skip - playing:`, this.state.playing)) : (console.log(`${this.NAME} [continueAllRemaining] continuing from paused position`), this.state.currentChapter.players.forEach((r) => {
-          if (r.type === "model") {
-            const n = this.playground.getDigitalHuman(r.model, r.id);
+          isCompleted: r,
+          isNearHardcodedPause: a
+        }), r ? (console.log(`${this.NAME} [continueAllRemaining] chapter already completed, restarting`), yield this.playChapterForContinuous(this.state.currentChapter), i = this.getProgress(), console.log(`${this.NAME} [continueAllRemaining] progress after restart:`, i)) : a ? (console.log(`${this.NAME} [continueAllRemaining] detected hardcoded pause, skipping to 27500ms`), this.state.currentChapter.players.filter((o) => o.type === "model").forEach((o) => {
+          const n = this.playground.getDigitalHuman(o.model, o.id);
+          n && (n.state.currentTime = 27500);
+        }), this.state.currentChapter.players.forEach((o) => {
+          if (o.type === "model") {
+            const n = this.playground.getDigitalHuman(o.model, o.id);
             n && n.continueAnimation();
           }
-        }), this.state.playing = !0, console.log(`${this.NAME} [continueAllRemaining] after continue - playing:`, this.state.playing)), i = this.getProgress(), console.log(`${this.NAME} [continueAllRemaining] updated progress before wait:`, i, "playing:", this.state.playing), i && i.currentTime < i.totalTime ? yield new Promise((r) => {
-          let n = (i == null ? void 0 : i.currentTime) || 0, a = 0;
+        }), this.state.playing = !0, console.log(`${this.NAME} [continueAllRemaining] after hardcoded pause skip - playing:`, this.state.playing)) : (console.log(`${this.NAME} [continueAllRemaining] continuing from paused position`), this.state.currentChapter.players.forEach((s) => {
+          if (s.type === "model") {
+            const o = this.playground.getDigitalHuman(s.model, s.id);
+            o && o.continueAnimation();
+          }
+        }), this.state.playing = !0, console.log(`${this.NAME} [continueAllRemaining] after continue - playing:`, this.state.playing)), i = this.getProgress(), console.log(`${this.NAME} [continueAllRemaining] updated progress before wait:`, i, "playing:", this.state.playing), i && i.currentTime < i.totalTime ? yield new Promise((s) => {
+          let o = (i == null ? void 0 : i.currentTime) || 0, n = 0;
           const l = 15, u = () => {
-            var p;
-            if (!((p = this.state) != null && p.continuousPlaying)) {
-              console.log(`${this.NAME} [continueAllRemaining] stopped by user`), r();
+            var g;
+            if (!((g = this.state) != null && g.continuousPlaying)) {
+              console.log(`${this.NAME} [continueAllRemaining] stopped by user`), s();
               return;
             }
             const h = this.getProgress();
             if (this.config.debug, h && h.currentTime >= h.totalTime) {
-              r();
+              s();
               return;
             }
             if (h && h.currentTime < 0) {
-              console.warn(`${this.NAME} [continueAllRemaining] detected negative time, skipping wait`), r();
+              console.warn(`${this.NAME} [continueAllRemaining] detected negative time, skipping wait`), s();
               return;
             }
-            if (h && h.currentTime === n) {
-              if (a++, a >= l) {
-                console.warn(`${this.NAME} [continueAllRemaining] progress stagnant for 3s, assuming chapter completed`), r();
+            if (h && h.currentTime === o) {
+              if (n++, n >= l) {
+                console.warn(`${this.NAME} [continueAllRemaining] progress stagnant for 3s, assuming chapter completed`), s();
                 return;
               }
             } else
-              a = 0, n = (h == null ? void 0 : h.currentTime) || 0;
+              n = 0, o = (h == null ? void 0 : h.currentTime) || 0;
             setTimeout(u, 200);
           };
           u();
         }) : console.log(`${this.NAME} [continueAllRemaining] chapter already completed or restarted, skipping wait`), console.log(
           `${this.NAME} [continueAllRemaining] starting to play remaining chapters from index ${e + 1} to ${t.length - 1}`
         ), this.emitPlayingPlayersChanged();
-        for (let r = e + 1; r < t.length; r++) {
+        for (let s = e + 1; s < t.length; s++) {
           if (!this.state.continuousPlaying) {
-            this.config.debug && console.log(`${this.NAME} continuous playback stopped by user at chapter ${r + 1}`);
+            this.config.debug && console.log(`${this.NAME} continuous playback stopped by user at chapter ${s + 1}`);
             break;
           }
-          const n = t[r];
+          const o = t[s];
           this.config.debug;
           try {
-            n.players.filter((h) => h.type === "model").forEach((h) => {
-              const p = this.playground.getDigitalHuman(h.model, h.id);
-              p && (p.state.currentTime = 0);
+            o.players.filter((h) => h.type === "model").forEach((h) => {
+              const g = this.playground.getDigitalHuman(h.model, h.id);
+              g && (g.state.currentTime = 0);
             });
             const l = Date.now();
-            yield this.playChapterForContinuous(n);
+            yield this.playChapterForContinuous(o);
             const u = Date.now() - l;
             if (this.config.debug, !this.state.continuousPlaying) {
-              this.config.debug && console.log(`${this.NAME} continuous playback stopped after chapter ${r + 1}`);
+              this.config.debug && console.log(`${this.NAME} continuous playback stopped after chapter ${s + 1}`);
               break;
             }
-            r < t.length - 1 && (yield new Promise((h) => setTimeout(h, 1e3)));
-          } catch (a) {
-            console.error(`${this.NAME} failed to play chapter ${n.name}:`, a), this.state.continuousPlaying = !1;
+            s < t.length - 1 && (yield new Promise((h) => setTimeout(h, 1e3)));
+          } catch (n) {
+            console.error(`${this.NAME} failed to play chapter ${o.name}:`, n), this.state.continuousPlaying = !1;
             break;
           }
         }
@@ -292,17 +295,17 @@ class Q {
       this.state.currentChapter && (e = t.findIndex((i) => i.name === this.state.currentChapter.name), e === -1 && (e = 0)), this.state.continuousPlaying = !0, this.state.playMode = "continuous";
       try {
         this.config.debug;
-        const i = !this.state.playing && this.state.currentChapter !== null, s = this.getProgress();
+        const i = !this.state.playing && this.state.currentChapter !== null, a = this.getProgress();
         if (i) {
-          const o = s && s.currentTime >= 26e3 && s.currentTime <= 27e3, r = s && s.totalTime > 0 && s.currentTime >= s.totalTime;
+          const r = a && a.currentTime >= 26e3 && a.currentTime <= 27e3, s = a && a.totalTime > 0 && a.currentTime >= a.totalTime;
           if (console.log(`${this.NAME} [playAllRemaining] pause analysis:`, {
-            hasProgress: !!s,
-            currentTime: s == null ? void 0 : s.currentTime,
-            totalTime: s == null ? void 0 : s.totalTime,
-            isCompleted: r,
-            isNearHardcodedPause: o,
-            shouldContinueFromPause: !r || o
-          }), this.emitPlayingPlayersChanged(), !r || o) {
+            hasProgress: !!a,
+            currentTime: a == null ? void 0 : a.currentTime,
+            totalTime: a == null ? void 0 : a.totalTime,
+            isCompleted: s,
+            isNearHardcodedPause: r,
+            shouldContinueFromPause: !s || r
+          }), this.emitPlayingPlayersChanged(), !s || r) {
             this.config.debug, yield this.continue();
             return;
           } else if (this.config.debug, e += 1, e >= t.length) {
@@ -310,40 +313,40 @@ class Q {
             return;
           }
         }
-        for (let o = e; o < t.length; o++) {
+        for (let r = e; r < t.length; r++) {
           if (!this.state.continuousPlaying) {
-            this.config.debug && console.log(`${this.NAME} continuous playback stopped by user at chapter ${o + 1}`), this.emitPlayingPlayersChanged();
+            this.config.debug && console.log(`${this.NAME} continuous playback stopped by user at chapter ${r + 1}`), this.emitPlayingPlayersChanged();
             break;
           }
-          const r = t[o];
+          const s = t[r];
           this.config.debug;
           try {
-            const n = this.state.currentChapter && this.state.currentChapter.name === r.name, a = i && n && o === e;
-            if (!n || a) {
-              const h = r.players.filter((p) => p.type === "model");
-              if (a) {
-                const p = this.getProgress();
-                p && p.currentTime >= 26e3 && p.currentTime <= 27e3 ? (h.forEach((b) => {
-                  const M = this.playground.getDigitalHuman(b.model);
+            const o = this.state.currentChapter && this.state.currentChapter.name === s.name, n = i && o && r === e;
+            if (!o || n) {
+              const h = s.players.filter((g) => g.type === "model");
+              if (n) {
+                const g = this.getProgress();
+                g && g.currentTime >= 26e3 && g.currentTime <= 27e3 ? (h.forEach((A) => {
+                  const M = this.playground.getDigitalHuman(A.model);
                   M && (M.state.currentTime = 27500);
-                }), this.config.debug && console.log(`${this.NAME} skipped hardcoded pause for chapter: ${r.name}`)) : this.config.debug && console.log(`${this.NAME} continuing current chapter from existing position: ${r.name}`);
+                }), this.config.debug && console.log(`${this.NAME} skipped hardcoded pause for chapter: ${s.name}`)) : this.config.debug && console.log(`${this.NAME} continuing current chapter from existing position: ${s.name}`);
               } else
-                h.forEach((p) => {
-                  const T = this.playground.getDigitalHuman(p.model, p.id);
+                h.forEach((g) => {
+                  const T = this.playground.getDigitalHuman(g.model, g.id);
                   T && (T.state.currentTime = 0);
-                }), this.config.debug && console.log(`${this.NAME} reset time for new chapter: ${r.name}`);
+                }), this.config.debug && console.log(`${this.NAME} reset time for new chapter: ${s.name}`);
             } else
               this.config.debug;
             const l = Date.now();
-            yield this.playChapterForContinuous(r);
+            yield this.playChapterForContinuous(s);
             const u = Date.now() - l;
             if (this.config.debug, this.state.continuousPlaying && !this.state.playing && (console.warn(`${this.NAME} [playAllRemaining] chapter completed but playing state is false, fixing...`), this.state.playing = !0), !this.state.continuousPlaying) {
-              this.config.debug && console.log(`${this.NAME} continuous playback stopped after chapter ${o + 1}`), this.emitPlayingPlayersChanged();
+              this.config.debug && console.log(`${this.NAME} continuous playback stopped after chapter ${r + 1}`), this.emitPlayingPlayersChanged();
               break;
             }
-            o < t.length - 1, o < t.length - 1 && (yield new Promise((h) => setTimeout(h, 1e3)));
-          } catch (n) {
-            console.error(`${this.NAME} failed to play chapter ${r.name}:`, n), this.emitPlayingPlayersChanged(), this.state.continuousPlaying = !1;
+            r < t.length - 1, r < t.length - 1 && (yield new Promise((h) => setTimeout(h, 1e3)));
+          } catch (o) {
+            console.error(`${this.NAME} failed to play chapter ${s.name}:`, o), this.emitPlayingPlayersChanged(), this.state.continuousPlaying = !1;
             break;
           }
         }
@@ -359,7 +362,7 @@ class Q {
    * 重置播放
    */
   reset() {
-    this.playground.reset(), this.state.playing = !1, this.state.continuousPlaying = !1, this.state.currentChapter = null, this.state.playMode = "single", this.config.debug && console.log(`${this.NAME} reset`);
+    this.playground.reset(), this.state.playing = !1, this.state.continuousPlaying = !1, this.state.currentChapter = null, this.state.playMode = "single", this.nameplate.setBindings([]), this.config.debug && console.log(`${this.NAME} reset`);
   }
   /**
    * 设置时间线
@@ -371,19 +374,19 @@ class Q {
    * 启用插件
    */
   enable() {
-    this.state.enabled = !0, this.config.debug && console.log(`${this.NAME} enabled`);
+    this.state.enabled = !0, this.nameplate.setEnabled(!0), this.config.debug && console.log(`${this.NAME} enabled`);
   }
   /**
    * 禁用插件
    */
   disable() {
-    this.state.enabled = !1, this.pause(), this.config.debug && console.log(`${this.NAME} disabled`);
+    this.state.enabled = !1, this.nameplate.setEnabled(!1), this.pause(), this.config.debug && console.log(`${this.NAME} disabled`);
   }
   /**
    * 重置并清理（完全重置插件状态，包括对 five 的操作和 DigitalHuman）
    */
   resetAndCleanup() {
-    this.stopAllPlayers(), this.playground && (typeof this.playground.dispose == "function" && this.playground.dispose(), this.playground = new this.playground.constructor(this.config.debug || !1)), this.state.playing = !1, this.state.continuousPlaying = !1, this.state.currentChapter = null, this.state.currentScript = null, this.state.enabled = !1, this.state.playMode = "single", this.stopProgressUpdateTimer(), this.clearProgressCache(), this.totalDurationCache = null, this.chapterTimeMapCache = null, this.five && (this.five.models.filter((e) => e.name && (e.name.includes("animation") || e.name.includes("digital"))).forEach((e) => {
+    this.stopAllPlayers(), this.playground && (typeof this.playground.dispose == "function" && this.playground.dispose(), this.playground = new this.playground.constructor(this.config.debug || !1)), this.state.playing = !1, this.state.continuousPlaying = !1, this.state.currentChapter = null, this.state.currentScript = null, this.state.enabled = !1, this.nameplate.setBindings([]), this.state.playMode = "single", this.stopProgressUpdateTimer(), this.clearProgressCache(), this.totalDurationCache = null, this.chapterTimeMapCache = null, this.five && (this.five.models.filter((e) => e.name && (e.name.includes("animation") || e.name.includes("digital"))).forEach((e) => {
       this.five.scene.remove(e);
     }), this.five.refresh(), this.five.getCurrentState && this.five.getCurrentState()), this._autoPlayOnNaturalEnd = !1, this.config.debug && console.log(`${this.NAME} resetAndCleanup - 完全重置完成（包括 DigitalHuman）`);
   }
@@ -391,7 +394,7 @@ class Q {
    * 销毁插件（彻底释放资源）
    */
   dispose() {
-    this.resetAndCleanup(), this.playground && typeof this.playground.dispose == "function" && this.playground.dispose(), this.playingPlayersListeners.clear(), this.state = void 0, this.playground = void 0, this.five = void 0, this.config = void 0, typeof window != "undefined" && window.console && console.log(`${this.NAME} disposed (彻底销毁)`);
+    this.five.off("renderFrame", this.onNameplateRender), this.five.off("cameraUpdate", this.onNameplateRender), this.nameplate.dispose(), this.resetAndCleanup(), this.playground && typeof this.playground.dispose == "function" && this.playground.dispose(), this.playingPlayersListeners.clear(), this.state = void 0, this.playground = void 0, this.five = void 0, this.config = void 0, typeof window != "undefined" && window.console && console.log(`${this.NAME} disposed (彻底销毁)`);
   }
   /**
    * 获取当前状态
@@ -412,6 +415,44 @@ class Q {
   getDigitalHuman(t, e) {
     return this.playground.getDigitalHuman(t, e);
   }
+  /**
+   * 挂载模型头顶 2D 气泡名牌。编辑端和 C 端都可以传入自己的全屏 overlay 容器和 DOM 渲染逻辑。
+   * 名牌会按当前章节的 player.id 绑定到对应 DigitalHuman，不会因复用同一模型资源而串名。
+   */
+  mountNameplates(t, e) {
+    this.nameplate.mount(t, e), this.syncNameplates();
+  }
+  unmountNameplates() {
+    this.nameplate.unmount();
+  }
+  setNameplatesEnabled(t) {
+    this.nameplate.setEnabled(t);
+  }
+  /** 调试：显示/隐藏名牌绑定模型的世界包围盒（核对名牌锚点用）。 */
+  setNameplateBoundingBoxVisible(t) {
+    this.nameplate.setBoundingBoxVisible(t);
+  }
+  /** 实时修改角色名牌；不重新加载模型和动画资源。 */
+  updateModelName(t, e) {
+    var a;
+    const i = L(e);
+    (a = this.state.currentScript) == null || a.chapters.forEach((r) => {
+      r.players.forEach((s) => {
+        s.type === "model" && s.id === t && (s.name = i);
+      });
+    }), this.nameplate.updateName(t, i);
+  }
+  syncNameplates(t = this.state.currentChapter) {
+    if (!t) {
+      this.nameplate.setBindings([]);
+      return;
+    }
+    const e = t.players.filter((i) => i.type === "model").map((i) => {
+      const a = this.playground.getDigitalHuman(i.model, i.id);
+      return a ? { id: i.id, player: i, model: a.model } : null;
+    }).filter((i) => i !== null);
+    this.nameplate.setBindings(e);
+  }
   /**
    * 获取当前播放进度信息
    */
@@ -421,10 +462,10 @@ class Q {
     let t = 0, e = 0;
     return this.state.currentChapter.players.forEach((i) => {
       if (i.type === "model") {
-        const s = i, o = s.keyframes[s.keyframes.length - 1];
-        o && (t = Math.max(t, o.timeStamp));
-        const r = this.playground.getDigitalHuman(s.model, s.id);
-        r && (e = Math.max(e, r.state.currentTime || 0));
+        const a = i, r = a.keyframes[a.keyframes.length - 1];
+        r && (t = Math.max(t, r.timeStamp));
+        const s = this.playground.getDigitalHuman(a.model, a.id);
+        s && (e = Math.max(e, s.state.currentTime || 0));
       }
     }), { currentTime: e, totalTime: t };
   }
@@ -435,62 +476,62 @@ class Q {
    * @param totalDelay 可选，默认0
    */
   transformScriptData(t, e, i = 0) {
-    var n, a;
+    var o, n;
     if (!t || !t.players || !Array.isArray(t.players))
       return t;
-    const s = (n = t.players[0]) != null && n.fiveState ? E({}, t.players[0].fiveState) : void 0;
-    if (s && s.offset && e) {
-      const l = new w(s.offset.x, s.offset.y, s.offset.z), u = N(l, e == null ? void 0 : e.transform);
-      s.offset = { x: u.x, y: u.y, z: u.z };
+    const a = (o = t.players[0]) != null && o.fiveState ? E({}, t.players[0].fiveState) : void 0;
+    if (a && a.offset && e) {
+      const l = new $(a.offset.x, a.offset.y, a.offset.z), u = w(l, e == null ? void 0 : e.transform);
+      a.offset = { x: u.x, y: u.y, z: u.z };
     }
-    const o = [
+    const r = [
       {
         id: 0,
-        name: ((a = t.players[0]) == null ? void 0 : a.chapterName) || "Chapter 1",
+        name: ((n = t.players[0]) == null ? void 0 : n.chapterName) || "Chapter 1",
         players: []
       }
     ];
-    let r = 0;
+    let s = 0;
     return t.players.forEach((l, u) => {
-      var T, b, M;
+      var T, A, M;
       let h = E({}, l);
-      if (e && ((T = h.track) != null && T.path && Array.isArray(h.track.path) && (h.track.path = h.track.path.map((y) => {
-        const f = N(new w(y.x, y.y, y.z), e == null ? void 0 : e.transform);
+      if (e && ((T = h.track) != null && T.path && Array.isArray(h.track.path) && (h.track.path = h.track.path.map((P) => {
+        const y = w(new $(P.x, P.y, P.z), e == null ? void 0 : e.transform);
         return {
-          x: f.x,
-          y: f.y,
-          z: f.z
+          x: y.x,
+          y: y.y,
+          z: y.z
         };
-      })), (b = h.track) != null && b.points && Array.isArray(h.track.points) && (h.track.points = h.track.points.map((y) => {
-        if (y.point) {
-          const f = N(
-            new w(y.point.x, y.point.y, y.point.z),
+      })), (A = h.track) != null && A.points && Array.isArray(h.track.points) && (h.track.points = h.track.points.map((P) => {
+        if (P.point) {
+          const y = w(
+            new $(P.point.x, P.point.y, P.point.z),
             e == null ? void 0 : e.transform
           );
-          return x(E({}, y), {
+          return x(E({}, P), {
             point: {
-              x: f.x,
-              y: f.y,
-              z: f.z
+              x: y.x,
+              y: y.y,
+              z: y.z
             }
           });
         }
-        return y;
+        return P;
       })), h.matrix && Array.isArray(h.matrix) && h.matrix.length >= 16)) {
-        const y = new w(h.matrix[12], h.matrix[13], h.matrix[14]), f = N(y, e == null ? void 0 : e.transform);
-        h.matrix[12] = f.x, h.matrix[13] = f.y, h.matrix[14] = f.z;
+        const P = new $(h.matrix[12], h.matrix[13], h.matrix[14]), y = w(P, e == null ? void 0 : e.transform);
+        h.matrix[12] = y.x, h.matrix[13] = y.y, h.matrix[14] = y.z;
       }
-      const p = z(h, i);
-      ((M = l.config) == null ? void 0 : M.type) === "simultaneous" || u > 0 && r++, o[r] || o.push({
-        id: r,
-        name: l.chapterName || `Chapter ${r + 1}`,
+      const g = z(h, i);
+      ((M = l.config) == null ? void 0 : M.type) === "simultaneous" || u > 0 && s++, r[s] || r.push({
+        id: s,
+        name: l.chapterName || `Chapter ${s + 1}`,
         players: []
-      }), o[r].players.push(p);
+      }), r[s].players.push(g);
     }), {
       id: t.id,
       name: t.name,
-      fiveState: s,
-      chapters: o
+      fiveState: a,
+      chapters: r
     };
   }
   // ===================== 全局进度条功能 =====================
@@ -507,8 +548,8 @@ class Q {
     let e = 0;
     return t.players.forEach((i) => {
       if (i.type === "model") {
-        const s = i, o = s.keyframes[s.keyframes.length - 1];
-        o && (e = Math.max(e, o.timeStamp));
+        const a = i, r = a.keyframes[a.keyframes.length - 1];
+        r && (e = Math.max(e, r.timeStamp));
       }
     }), e;
   }
@@ -535,16 +576,16 @@ class Q {
       return [];
     const t = [];
     let e = 0;
-    return this.state.currentScript.chapters.forEach((i, s) => {
-      const o = this.calculateChapterDuration(i), r = e + o;
+    return this.state.currentScript.chapters.forEach((i, a) => {
+      const r = this.calculateChapterDuration(i), s = e + r;
       t.push({
-        chapterIndex: s,
+        chapterIndex: a,
         chapterName: i.name,
         startTime: e,
-        duration: o,
-        endTime: r,
+        duration: r,
+        endTime: s,
         chapter: i
-      }), e = r;
+      }), e = s;
     }), this.chapterTimeMapCache = t, this.config.debug && console.log(`${this.NAME} generated chapter time map:`, t), t;
   }
   /**
@@ -562,18 +603,18 @@ class Q {
   getGlobalProgress() {
     let t = 0, e = 0, i = 0;
     if (this.state.currentChapter) {
-      const n = this.getChapterTimeMap().find((a) => a.chapter.name === this.state.currentChapter.name);
-      if (n) {
-        e = n.chapterIndex;
-        const a = this.getProgress();
-        i = (a == null ? void 0 : a.currentTime) || 0, t = n.startTime + i;
+      const o = this.getChapterTimeMap().find((n) => n.chapter.name === this.state.currentChapter.name);
+      if (o) {
+        e = o.chapterIndex;
+        const n = this.getProgress();
+        i = (n == null ? void 0 : n.currentTime) || 0, t = o.startTime + i;
       }
     }
-    const s = this.getTotalDuration(), o = s > 0 ? t / s * 100 : 0;
+    const a = this.getTotalDuration(), r = a > 0 ? t / a * 100 : 0;
     return {
       currentTime: t,
-      totalTime: s,
-      percentage: Math.min(100, Math.max(0, o)),
+      totalTime: a,
+      percentage: Math.min(100, Math.max(0, r)),
       currentChapterIndex: e,
       currentChapterTime: i,
       currentChapter: this.state.currentChapter || void 0
@@ -586,14 +627,14 @@ class Q {
     const e = this.getChapterTimeMap();
     if (e.length === 0)
       return null;
-    const s = e.find((r) => t >= r.startTime && t < r.endTime) || (t >= e[e.length - 1].startTime ? e[e.length - 1] : null);
-    if (!s)
+    const a = e.find((s) => t >= s.startTime && t < s.endTime) || (t >= e[e.length - 1].startTime ? e[e.length - 1] : null);
+    if (!a)
       return null;
-    const o = t - s.startTime;
+    const r = t - a.startTime;
     return {
-      chapterIndex: s.chapterIndex,
-      chapterTime: Math.max(0, o),
-      chapter: s.chapter
+      chapterIndex: a.chapterIndex,
+      chapterTime: Math.max(0, r),
+      chapter: a.chapter
     };
   }
   /**
@@ -606,62 +647,62 @@ class Q {
       try {
         if (!this.state.currentScript)
           throw new Error("No script loaded");
-        const s = this.getTotalDuration(), o = Math.max(0, Math.min(t, s));
-        this.config.debug, this.emit("seek-started", o);
-        const r = this.getChapterByGlobalTime(o);
-        if (!r)
+        const a = this.getTotalDuration(), r = Math.max(0, Math.min(t, a));
+        this.config.debug, this.emit("seek-started", r);
+        const s = this.getChapterByGlobalTime(r);
+        if (!s)
           throw new Error("Unable to locate chapter for the specified time");
-        const { chapterIndex: n, chapterTime: a, chapter: l } = r, u = this.state.playing;
-        this.state.playing && this.pause(), (!this.state.currentChapter || this.state.currentChapter.name !== l.name) && (this.config.debug && console.log(`${this.NAME} switching to chapter ${n}: ${l.name}`), yield this.initializeChapterForSeek(l, a), this.state.currentChapter = l, this.emit("chapter-changed", n, l)), this.setTimelineTo(a), a === 0 && this.state.currentScript.chapters.forEach((g) => {
-          g.players.forEach((C) => {
+        const { chapterIndex: o, chapterTime: n, chapter: l } = s, u = this.state.playing;
+        this.state.playing && this.pause(), (!this.state.currentChapter || this.state.currentChapter.name !== l.name) && (this.config.debug && console.log(`${this.NAME} switching to chapter ${o}: ${l.name}`), yield this.initializeChapterForSeek(l, n), this.state.currentChapter = l, this.syncNameplates(l), this.emit("chapter-changed", o, l)), this.setTimelineTo(n), n === 0 && this.state.currentScript.chapters.forEach((p) => {
+          p.players.forEach((C) => {
             if (C.type === "model") {
-              const A = this.playground.getDigitalHuman(C.model, C.id);
-              A && A.stopAnimation();
+              const b = this.playground.getDigitalHuman(C.model, C.id);
+              b && b.stopAnimation();
             }
           });
         });
-        const T = this.getChapterTimeMap().find((g) => g.chapter.name === l.name), b = (i = T == null ? void 0 : T.chapterIndex) != null ? i : 0;
-        this.state.currentScript.chapters.forEach((g, C) => {
-          g.players.forEach((A) => {
-            if (A.type === "model") {
-              const c = this.playground.getDigitalHuman(A.model, A.id);
+        const T = this.getChapterTimeMap().find((p) => p.chapter.name === l.name), A = (i = T == null ? void 0 : T.chapterIndex) != null ? i : 0;
+        this.state.currentScript.chapters.forEach((p, C) => {
+          p.players.forEach((b) => {
+            if (b.type === "model") {
+              const c = this.playground.getDigitalHuman(b.model, b.id);
               if (!c)
                 return;
-              if (C < b)
+              if (C < A)
                 c.model.visible = !1, c.container.visible = !1, c.state.currentTime = 0, c.pauseAnimation && c.pauseAnimation();
-              else if (C === b) {
+              else if (C === A) {
                 if (c.play({
-                  keyframes: A.keyframes,
-                  items: A.items,
-                  effects: A.effects
-                }), c.state.currentTime = a, c.model.visible = !0, c.container.visible = !0, c.state.currentTime = a, c.keyframesManager && c.keyframes) {
-                  const $ = c.keyframesManager.getStateByTime(a, c.keyframes, "model");
-                  $ && (c.model.position.copy($.translation), c.model.quaternion.copy($.quaternion), c.model.scale.copy($.scale), c.model.visible = $.visible);
+                  keyframes: b.keyframes,
+                  items: b.items,
+                  effects: b.effects
+                }), c.state.currentTime = n, c.model.visible = !0, c.container.visible = !0, c.state.currentTime = n, c.keyframesManager && c.keyframes) {
+                  const N = c.keyframesManager.getStateByTime(n, c.keyframes, "model");
+                  N && (c.model.position.copy(N.translation), c.model.quaternion.copy(N.quaternion), c.model.scale.copy(N.scale), c.model.visible = N.visible);
                 }
                 e ? c.continueAnimation() : c.pauseAnimation && c.pauseAnimation();
               } else
                 c.model.visible = !1, c.container.visible = !1, c.state.currentTime = 0, c.pauseAnimation && c.pauseAnimation();
             }
           });
-        }), (e !== void 0 ? e : u) && (this.state.playing = !0, l.players.forEach((g) => {
-          if (g.type === "model") {
-            const C = this.playground.getDigitalHuman(g.model, g.id);
+        }), (e !== void 0 ? e : u) && (this.state.playing = !0, l.players.forEach((p) => {
+          if (p.type === "model") {
+            const C = this.playground.getDigitalHuman(p.model, p.id);
             C && (C.play({
-              keyframes: g.keyframes,
-              items: g.items,
-              effects: g.effects
-            }), C.state.currentTime = a, C.continueAnimation());
+              keyframes: p.keyframes,
+              items: p.items,
+              effects: p.effects
+            }), C.state.currentTime = n, C.continueAnimation());
           }
-        }), this.emit("playback-started", o)), this.emit("seek-completed", o);
-        const f = this.getChapterTimeMap().find((g) => g.chapter.name === l.name);
-        if (f && Math.abs(a - f.duration) < 1 && // 允许1ms误差
+        }), this.emit("playback-started", r)), this.emit("seek-completed", r);
+        const y = this.getChapterTimeMap().find((p) => p.chapter.name === l.name);
+        if (y && Math.abs(n - y.duration) < 1 && // 允许1ms误差
         e) {
-          const g = this.state.currentScript.chapters[n + 1];
-          g && (this.config.debug && console.log(`${this.NAME} seekToGlobalTime: auto switch to next chapter:`, g.name), yield this.playChapter(g));
+          const p = this.state.currentScript.chapters[o + 1];
+          p && (this.config.debug && console.log(`${this.NAME} seekToGlobalTime: auto switch to next chapter:`, p.name), yield this.playChapter(p));
         }
         this.config.debug;
-      } catch (s) {
-        throw console.error(`${this.NAME} failed to seek to global time ${t}:`, s), s;
+      } catch (a) {
+        throw console.error(`${this.NAME} failed to seek to global time ${t}:`, a), a;
       }
     });
   }
@@ -673,32 +714,32 @@ class Q {
       this.emitPlayingPlayersChanged();
       try {
         this.config.debug && console.log(`${this.NAME} initializing chapter for seek: ${t.name}`), this.playground.reset();
-        const i = t.players.filter((r) => r.type === "model"), s = [];
-        i.forEach((r) => {
-          const n = r;
-          n.keyframes && Array.isArray(n.keyframes) && n.keyframes.forEach((a) => {
-            a.animation && a.animation.url && s.push(a.animation.url);
+        const i = t.players.filter((s) => s.type === "model"), a = [];
+        i.forEach((s) => {
+          const o = s;
+          o.keyframes && Array.isArray(o.keyframes) && o.keyframes.forEach((n) => {
+            n.animation && n.animation.url && a.push(n.animation.url);
           });
-        }), s.length > 0 && (yield this.playground.loadAnimations(s)), yield Promise.all(
-          i.map((r) => m(this, null, function* () {
-            const n = r;
-            let a = this.playground.getDigitalHuman(n.model, n.id);
-            if (a || (yield this.playground.loadModels([n.model], [n.id]), a = this.playground.getDigitalHuman(n.model, n.id)), a && n.keyframes.length > 0) {
-              a.state.currentTime = e, a.state.currentAnimation = null, a.keyframes = n.keyframes;
-              const l = n.keyframes[0];
-              a.model.position.set(l.position[0], l.position[1], l.position[2]), a.model.quaternion.set(
+        }), a.length > 0 && (yield this.playground.loadAnimations(a)), yield Promise.all(
+          i.map((s) => m(this, null, function* () {
+            const o = s;
+            let n = this.playground.getDigitalHuman(o.model, o.id);
+            if (n || (yield this.playground.loadModels([o.model], [o.id]), n = this.playground.getDigitalHuman(o.model, o.id)), n && o.keyframes.length > 0) {
+              n.state.currentTime = e, n.state.currentAnimation = null, n.keyframes = o.keyframes;
+              const l = o.keyframes[0];
+              n.model.position.set(l.position[0], l.position[1], l.position[2]), n.model.quaternion.set(
                 l.quaternion[0],
                 l.quaternion[1],
                 l.quaternion[2],
                 l.quaternion[3]
-              ), a.model.scale.set(l.scale[0], l.scale[1], l.scale[2]), a.model.visible = l.visible, a.play({
-                keyframes: n.keyframes,
-                items: n.items,
-                effects: n.effects
-              }), a.state.currentTime = e, a.continueAnimation();
+              ), n.model.scale.set(l.scale[0], l.scale[1], l.scale[2]), n.model.visible = l.visible, n.play({
+                keyframes: o.keyframes,
+                items: o.items,
+                effects: o.effects
+              }), n.state.currentTime = e, n.continueAnimation();
             }
           }))
-        ), t.players.filter((r) => r.type === "camera").length > 0 && this.config.debug, this.config.debug;
+        ), t.players.filter((s) => s.type === "camera").length > 0 && this.config.debug, this.config.debug;
       } catch (i) {
         throw console.error(`${this.NAME} failed to initialize chapter for seek:`, i), i;
       }
@@ -709,8 +750,8 @@ class Q {
    */
   seekToPercentage(t, e) {
     return m(this, null, function* () {
-      const i = Math.max(0, Math.min(100, t)), o = this.getTotalDuration() * i / 100;
-      this.config.debug && console.log(`${this.NAME} seeking to ${i}% (${o}ms)`), yield this.seekToGlobalTime(o, e);
+      const i = Math.max(0, Math.min(100, t)), r = this.getTotalDuration() * i / 100;
+      this.config.debug && console.log(`${this.NAME} seeking to ${i}% (${r}ms)`), yield this.seekToGlobalTime(r, e);
     });
   }
   /**
@@ -722,8 +763,8 @@ class Q {
         throw new Error("No script loaded");
       if (t < 0 || t >= this.state.currentScript.chapters.length)
         throw new Error("Invalid chapter index");
-      const r = this.getChapterTimeMap()[t].startTime + Math.max(0, e);
-      this.config.debug && console.log(`${this.NAME} seeking to chapter ${t} at ${e}ms (global: ${r}ms)`), yield this.seekToGlobalTime(r, i);
+      const s = this.getChapterTimeMap()[t].startTime + Math.max(0, e);
+      this.config.debug && console.log(`${this.NAME} seeking to chapter ${t} at ${e}ms (global: ${s}ms)`), yield this.seekToGlobalTime(s, i);
     });
   }
   /**
@@ -739,15 +780,15 @@ class Q {
    */
   onProgressChanged(t) {
     const e = (i) => m(this, null, function* () {
-      var a;
+      var n;
       t(i);
-      const s = ((a = this.state.currentScript) == null ? void 0 : a.chapters) || [], o = this.state.currentChapter ? s.findIndex((l) => l.name === this.state.currentChapter.name) : -1, n = this.getChapterTimeMap().find((l) => {
+      const a = ((n = this.state.currentScript) == null ? void 0 : n.chapters) || [], r = this.state.currentChapter ? a.findIndex((l) => l.name === this.state.currentChapter.name) : -1, o = this.getChapterTimeMap().find((l) => {
         var u;
         return l.chapter.name === ((u = this.state.currentChapter) == null ? void 0 : u.name);
       });
-      if (this.state.playing && this.state.currentChapter && n && i.currentChapterTime >= n.duration - 10 && // 允许10ms误差，比较章节内时间
+      if (this.state.playing && this.state.currentChapter && o && i.currentChapterTime >= o.duration - 10 && // 允许10ms误差，比较章节内时间
       this._autoPlayOnNaturalEnd) {
-        const l = s[o + 1];
+        const l = a[r + 1];
         l ? yield this.playChapter(l) : (this.stopAllPlayers(), this.state.playing = !1, this.five.refresh(), this.emitPlayingPlayersChanged && this.emitPlayingPlayersChanged());
       }
     });
@@ -823,11 +864,11 @@ class Q {
   emit(t, ...e) {
     if (this.config.debug, t === "progress-changed" && e.length > 0) {
       const i = e[0];
-      this.progressListeners.forEach((s) => {
+      this.progressListeners.forEach((a) => {
         try {
-          s(i);
-        } catch (o) {
-          console.error(`${this.NAME} progress listener error:`, o);
+          a(i);
+        } catch (r) {
+          console.error(`${this.NAME} progress listener error:`, r);
         }
       });
     }
@@ -842,8 +883,8 @@ class Q {
    * 获取当前正在播放的所有player（数组）
    */
   getCurrentPlayingPlayers() {
-    const e = this.getGlobalProgress().currentTime, s = this.getChapterTimeMap().find((o) => e >= o.startTime && e < o.endTime);
-    return s ? this.getPlayingPlayersFromChapter(s.chapter) : [];
+    const e = this.getGlobalProgress().currentTime, a = this.getChapterTimeMap().find((r) => e >= r.startTime && e < r.endTime);
+    return a ? this.getPlayingPlayersFromChapter(a.chapter) : [];
   }
   /**
    * 从指定章节获取正在播放的players
@@ -866,5 +907,5 @@ class Q {
   }
 }
 export {
-  Q as default
+  Y as default
 };