@realsee/dnalogel 3.81.11-alpha.2 → 3.81.11-alpha.3

package/libs/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.js

@@ -1,23 +1,23 @@
-var T = Object.defineProperty, S = Object.defineProperties;
-var C = Object.getOwnPropertyDescriptors;
-var w = Object.getOwnPropertySymbols;
-var _ = Object.prototype.hasOwnProperty, M = Object.prototype.propertyIsEnumerable;
-var u = (r, e, t) => e in r ? T(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t, p = (r, e) => {
+var N = Object.defineProperty, D = Object.defineProperties;
+var O = Object.getOwnPropertyDescriptors;
+var v = Object.getOwnPropertySymbols;
+var T = Object.prototype.hasOwnProperty, S = Object.prototype.propertyIsEnumerable;
+var d = (r, e, t) => e in r ? N(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t, c = (r, e) => {
   for (var t in e || (e = {}))
-    _.call(e, t) && u(r, t, e[t]);
-  if (w)
-    for (var t of w(e))
-      M.call(e, t) && u(r, t, e[t]);
+    T.call(e, t) && d(r, t, e[t]);
+  if (v)
+    for (var t of v(e))
+      S.call(e, t) && d(r, t, e[t]);
   return r;
-}, B = (r, e) => S(r, C(e));
-var a = (r, e, t) => (u(r, typeof e != "symbol" ? e + "" : e, t), t);
-import * as d from "three";
-const f = 30;
-function L(r, e = f) {
-  const t = typeof r == "string" ? r.trim() : "", s = Number.isFinite(e) ? Math.max(0, Math.floor(e)) : f;
-  return Array.from(t).slice(0, s).join("");
+}, w = (r, e) => D(r, O(e));
+var a = (r, e, t) => (d(r, typeof e != "symbol" ? e + "" : e, t), t);
+import * as u from "three";
+const m = 30;
+function M(r, e = m) {
+  const t = typeof r == "string" ? r.trim() : "", n = Number.isFinite(e) ? Math.max(0, Math.floor(e)) : m;
+  return Array.from(t).slice(0, n).join("");
 }
-const D = [0, 0.12, 0], m = "digital-performance-nameplate", O = "digital-performance-nameplates", N = "digital-performance-nameplate-arrow-style", R = {
+const C = [0, 0.12, 0], f = "digital-performance-nameplate", _ = "digital-performance-nameplates", L = "digital-performance-nameplate-arrow-style", R = {
   position: "absolute",
   "z-index": "1",
   display: "block",
@@ -48,24 +48,33 @@ class z {
     a(this, "bindings", /* @__PURE__ */ new Map());
     a(this, "nameOverrides", /* @__PURE__ */ new Map());
     a(this, "enabled", !0);
+    /** 是否由本层自动挂载到 five canvas 父容器（插件内置模式），无需调用方提供容器。 */
+    a(this, "autoMount", !1);
     a(this, "onResize", () => this.update());
-    a(this, "anchor", new d.Vector3());
-    a(this, "box", new d.Box3());
-    a(this, "offset", new d.Vector3());
+    a(this, "anchor", new u.Vector3());
+    a(this, "box", new u.Box3());
+    a(this, "offset", new u.Vector3());
     a(this, "debugBoxes", /* @__PURE__ */ new Map());
     a(this, "debugBoxesVisible", !1);
-    this.five = e, this.options = p({}, t);
+    this.five = e, this.options = c({}, t), this.applyDebugBoundingBoxOption();
   }
   /** 将 overlay 挂到 Five canvas 的父级或业务提供的全屏相对定位容器。 */
   mount(e, t) {
-    var s;
-    if (t && (this.options = p(p({}, this.options), t)), this.parent === e && this.container) {
-      this.applyContainerStyle(), this.update();
+    var n;
+    if (t && (this.options = c(c({}, this.options), t)), this.parent === e && this.container) {
+      this.applyContainerStyle(), this.applyDebugBoundingBoxOption(), this.update();
       return;
     }
-    this.unmount(), this.parent = e, this.container = document.createElement("div"), this.container.className = (s = this.options.containerClassName) != null ? s : O, this.applyContainerStyle(), this.injectArrowStyle(), e.appendChild(this.container), typeof window != "undefined" && window.addEventListener("resize", this.onResize, !1), this.update();
+    this.unmount(), this.parent = e, this.container = document.createElement("div"), this.container.className = (n = this.options.containerClassName) != null ? n : _, this.applyContainerStyle(), this.injectArrowStyle(), e.appendChild(this.container), typeof window != "undefined" && window.addEventListener("resize", this.onResize, !1), this.applyDebugBoundingBoxOption(), this.update();
   }
-  /** 移除 overlay，但保留 bindings，便于编辑端切换容器后重新 mount。 */
+  /**
+   * 内置自动挂载：把 overlay 挂到 five canvas 的父容器（与 canvas 同级），调用方无需提供容器。
+   * canvas 尚未进入 DOM 时不报错，会在后续 update() 中自动重试挂载。
+   */
+  enableAutoMount(e) {
+    e && (this.options = c(c({}, this.options), e)), this.autoMount = !0, this.applyDebugBoundingBoxOption(), this.tryAutoMount();
+  }
+  /** 移除 overlay，但保留 bindings；重新挂载（含换容器）时会复用 bindings。 */
   unmount() {
     var e;
     typeof window != "undefined" && window.removeEventListener("resize", this.onResize, !1), (e = this.container) == null || e.remove(), this.container = null, this.parent = null, this.bindings.forEach((t) => {
@@ -74,19 +83,19 @@ class z {
   }
   /** 更新当前章节的角色绑定；id 是角色唯一键，同一模型复用时也不会互相覆盖。 */
   setBindings(e) {
-    const t = new Set(e.map((i) => i.id)), s = this.bindings, n = /* @__PURE__ */ new Map();
+    const t = new Set(e.map((i) => i.id)), n = this.bindings, s = /* @__PURE__ */ new Map();
     e.forEach((i) => {
-      const o = s.get(i.id);
-      n.set(i.id, B(p({}, i), { element: o == null ? void 0 : o.element }));
-    }), s.forEach((i, o) => {
+      const o = n.get(i.id);
+      s.set(i.id, w(c({}, i), { element: o == null ? void 0 : o.element }));
+    }), n.forEach((i, o) => {
       var l;
       t.has(o) || ((l = i.element) == null || l.remove(), this.removeDebugBox(o), this.nameOverrides.delete(o));
-    }), this.bindings = n, this.update();
+    }), this.bindings = s, this.update();
   }
   /** 实时更新指定角色名称，不需要重新加载模型或动画资源。 */
   updateName(e, t) {
-    const s = L(t, this.getMaxLength());
-    this.nameOverrides.set(e, s), this.update();
+    const n = M(t, this.getMaxLength());
+    this.nameOverrides.set(e, n), this.update();
   }
   setEnabled(e) {
     this.enabled = e, this.container && (this.container.style.display = e ? "" : "none"), e && this.update();
@@ -99,14 +108,19 @@ class z {
   setBoundingBoxVisible(e) {
     this.debugBoxesVisible = e, e || this.clearDebugBoxes(), this.five.needsRender = !0, this.update();
   }
+  /** 应用 `options.debugBoundingBox`；未配置时保持现状（不覆盖运行时的 setBoundingBoxVisible）。 */
+  applyDebugBoundingBoxOption() {
+    const e = this.options.debugBoundingBox;
+    e !== void 0 && this.setBoundingBoxVisible(e);
+  }
   isEnabled() {
     return this.enabled;
   }
   /** 在数字人模型变换完成后调用，更新所有当前章节名牌的位置和可见性。 */
   update() {
-    this.container && (this.container.style.display = this.enabled ? "" : "none", this.enabled && this.bindings.forEach((e) => {
+    this.autoMount && this.tryAutoMount(), this.container && (this.container.style.display = this.enabled ? "" : "none", this.enabled && this.bindings.forEach((e) => {
       this.syncDebugBox(e);
-      const t = this.getText(e.player, e.id), s = {
+      const t = this.getText(e.player, e.id), n = {
         id: e.id,
         text: t,
         player: e.player,
@@ -116,32 +130,40 @@ class z {
         this.hideElement(e);
         return;
       }
-      const n = this.ensureElement(e, s), i = this.getScreenPosition(e.model);
+      const s = this.ensureElement(e, n), i = this.getScreenPosition(e.model);
       if (!i) {
         this.hideElement(e);
         return;
       }
-      this.applyElementContent(n, s), n.style.display = "block", n.style.transform = `translate3d(${i.x}px, ${i.y}px, 0) translate(-50%, calc(-100% - 8px))`;
+      this.applyElementContent(s, n), s.style.display = "block", s.style.transform = `translate3d(${i.x}px, ${i.y}px, 0) translate(-50%, calc(-100% - 8px))`;
     }));
   }
   dispose() {
-    this.unmount(), this.clearDebugBoxes(), this.bindings.clear(), this.nameOverrides.clear();
+    this.autoMount = !1, this.unmount(), this.clearDebugBoxes(), this.bindings.clear(), this.nameOverrides.clear();
+  }
+  /** 内置自动挂载的实际执行：解析 five canvas 的父容器并 mount；条件不满足时静默跳过。 */
+  tryAutoMount() {
+    var t, n, s;
+    if (!this.autoMount || this.container || typeof document == "undefined")
+      return;
+    const e = (s = (n = (t = this.five).getElement) == null ? void 0 : n.call(t)) == null ? void 0 : s.parentElement;
+    e && this.mount(e);
   }
   getMaxLength() {
     var e;
-    return (e = this.options.maxLength) != null ? e : f;
+    return (e = this.options.maxLength) != null ? e : m;
   }
   getText(e, t) {
-    var o, l, c, h;
-    const s = this.nameOverrides.get(t), n = (l = (o = this.options).getText) == null ? void 0 : l.call(o, e), i = (c = e.displayName) != null ? c : e.name;
-    return L((h = s != null ? s : n) != null ? h : i, this.getMaxLength());
+    var o, l, h, p;
+    const n = this.nameOverrides.get(t), s = (l = (o = this.options).getText) == null ? void 0 : l.call(o, e), i = (h = e.displayName) != null ? h : e.name;
+    return M((p = n != null ? n : s) != null ? p : i, this.getMaxLength());
   }
   ensureElement(e, t) {
-    var i, o, l, c;
+    var i, o, l, h;
     if (e.element)
       return e.element;
-    const s = (l = (o = (i = this.options).createElement) == null ? void 0 : o.call(i, t)) != null ? l : document.createElement("div");
-    return ((c = this.options.className) != null ? c : m).split(/\s+/).filter(Boolean).forEach((h) => s.classList.add(h)), s.setAttribute("data-digital-performance-nameplate-id", e.id), s.setAttribute("role", "status"), this.applyElementStyle(s), this.container.appendChild(s), e.element = s, s;
+    const n = (l = (o = (i = this.options).createElement) == null ? void 0 : o.call(i, t)) != null ? l : document.createElement("div");
+    return ((h = this.options.className) != null ? h : f).split(/\s+/).filter(Boolean).forEach((p) => n.classList.add(p)), n.setAttribute("data-digital-performance-nameplate-id", e.id), n.setAttribute("role", "status"), this.applyElementStyle(n), this.container.appendChild(n), e.element = n, n;
   }
   applyElementContent(e, t) {
     this.options.updateElement ? this.options.updateElement(e, t) : e.textContent = t.text, e.setAttribute("aria-label", t.text);
@@ -151,11 +173,11 @@ class z {
   }
   applyContainerStyle() {
     var e;
-    this.container && (Object.entries(j).forEach(([t, s]) => this.container.style.setProperty(t, s)), Object.entries((e = this.options.containerStyle) != null ? e : {}).forEach(([t, s]) => this.container.style.setProperty(t, s)));
+    this.container && (Object.entries(j).forEach(([t, n]) => this.container.style.setProperty(t, n)), Object.entries((e = this.options.containerStyle) != null ? e : {}).forEach(([t, n]) => this.container.style.setProperty(t, n)));
   }
   applyElementStyle(e) {
     var t;
-    Object.entries(R).forEach(([s, n]) => e.style.setProperty(s, n)), Object.entries((t = this.options.style) != null ? t : {}).forEach(([s, n]) => e.style.setProperty(s, n));
+    Object.entries(R).forEach(([n, s]) => e.style.setProperty(n, s)), Object.entries((t = this.options.style) != null ? t : {}).forEach(([n, s]) => e.style.setProperty(n, s));
   }
   /**
    * 注入名牌气泡箭头的伪元素样式。
@@ -164,11 +186,11 @@ class z {
    * 当调用方完全自定义了 className 时，箭头选择器不会命中，也就无需注入。
    */
   injectArrowStyle() {
-    var s;
-    if (typeof document == "undefined" || !document.head || !((s = this.options.className) != null ? s : m).split(/\s+/).includes(m) || document.getElementById(N))
+    var n;
+    if (typeof document == "undefined" || !document.head || !((n = this.options.className) != null ? n : f).split(/\s+/).includes(f) || document.getElementById(L))
       return;
     const t = document.createElement("style");
-    t.id = N, t.textContent = `
+    t.id = L, t.textContent = `
       .digital-performance-nameplate::after {
         content: '';
         width: 16px;
@@ -197,48 +219,48 @@ class z {
       return;
     let t = this.debugBoxes.get(e.id);
     if (!t) {
-      t = new d.BoxHelper(e.model, 16726832);
-      const s = t.material;
-      s && (s.depthTest = !1, s.transparent = !0, s.opacity = 0.9), this.five.scene.add(t), this.debugBoxes.set(e.id, t);
+      t = new u.BoxHelper(e.model, 16726832);
+      const n = t.material;
+      n && (n.depthTest = !1, n.transparent = !0, n.opacity = 0.9), this.five.scene.add(t), this.debugBoxes.set(e.id, t);
     }
     t.update();
   }
   removeDebugBox(e) {
-    var s, n;
+    var n, s;
     const t = this.debugBoxes.get(e);
-    t && (this.five.scene.remove(t), (s = t.geometry) == null || s.dispose(), (n = t.material) == null || n.dispose(), this.debugBoxes.delete(e));
+    t && (this.five.scene.remove(t), (n = t.geometry) == null || n.dispose(), (s = t.material) == null || s.dispose(), this.debugBoxes.delete(e));
   }
   clearDebugBoxes() {
     this.debugBoxes.forEach((e) => {
-      var t, s;
-      this.five.scene.remove(e), (t = e.geometry) == null || t.dispose(), (s = e.material) == null || s.dispose();
+      var t, n;
+      this.five.scene.remove(e), (t = e.geometry) == null || t.dispose(), (n = e.material) == null || n.dispose();
     }), this.debugBoxes.clear();
   }
   getScreenPosition(e) {
-    var x, E, y, g, b;
+    var x, g, y, E, b;
     if (e.updateMatrixWorld(!0), this.box.setFromObject(e), this.box.isEmpty())
       return null;
     this.box.getCenter(this.anchor), this.anchor.y = this.box.max.y;
-    const t = (x = this.options.offset) != null ? x : D;
+    const t = (x = this.options.offset) != null ? x : C;
     this.offset.fromArray(t), this.anchor.add(this.offset);
-    const s = this.anchor.clone().project(this.five.camera);
-    if (s.z < -1 || s.z > 1)
+    const n = this.anchor.clone().project(this.five.camera);
+    if (n.z < -1 || n.z > 1)
       return null;
-    const n = this.five.project2d(this.anchor);
-    if (!n)
+    const s = this.five.project2d(this.anchor);
+    if (!s)
       return null;
-    let i = n.x, o = n.y;
+    let i = s.x, o = s.y;
     const l = this.five.getElement();
     if (l && this.parent) {
-      const v = l.getBoundingClientRect(), A = this.parent.getBoundingClientRect();
-      i += v.left - A.left, o += v.top - A.top;
+      const B = l.getBoundingClientRect(), A = this.parent.getBoundingClientRect();
+      i += B.left - A.left, o += B.top - A.top;
     }
-    const c = (y = (E = this.parent) == null ? void 0 : E.clientWidth) != null ? y : 0, h = (b = (g = this.parent) == null ? void 0 : g.clientHeight) != null ? b : 0;
-    return c > 0 && h > 0 && (i < -200 || i > c + 200 || o < -100 || o > h + 100) ? null : { x: i, y: o };
+    const h = (y = (g = this.parent) == null ? void 0 : g.clientWidth) != null ? y : 0, p = (b = (E = this.parent) == null ? void 0 : E.clientHeight) != null ? b : 0;
+    return h > 0 && p > 0 && (i < -200 || i > h + 200 || o < -100 || o > p + 100) ? null : { x: i, y: o };
   }
 }
 export {
-  f as DEFAULT_DIGITAL_PERFORMANCE_NAME_MAX_LENGTH,
+  m as DEFAULT_DIGITAL_PERFORMANCE_NAME_MAX_LENGTH,
   z as DigitalPerformanceNameplate,
-  L as normalizeDigitalPerformanceName
+  M as normalizeDigitalPerformanceName
 };

package/libs/DigitalPerformancePlugin/typings/index.d.ts

@@ -1,10 +1,18 @@
 import * as THREE from 'three';
 import type { DigitalChapter } from '../core/DigitalStateMachine';
+import type { DigitalPerformanceNameplateOptions } from '../core/DigitalPerformanceNameplate';
 export type { DigitalScript, DigitalChapter, DigitalModelPlayer, DigitalSubTitlePlayer, DigitalCameraPlayer, DigitalModelKeyframe, DigitalSubTitleKeyframe, DigitalCameraKeyframe, DigitalModelState, DigitalSubTitleState, DigitalCameraState, DigitalModelPlayerItem, DigitalModelPlayerEffect, DigitalEffectKeyframe, DigitalDataState, DigitalDataPlayer, KeyframeType, StateType, } from '../core/DigitalStateMachine';
 export interface DigitalPerformancePluginConfig {
     autoPlay?: boolean;
     loop?: boolean;
     debug?: boolean;
+    /**
+     * 是否展示模型头顶的 2D 气泡名牌（默认 true）。
+     * 插件会内置挂载到 five canvas 的父容器，调用方无需提供容器，仅需声明是否展示。
+     */
+    showNameplate?: boolean;
+    /** 内置名牌的自定义配置（class / 内联样式 / 文本 / 自定义渲染器等）。仅 showNameplate 为真时生效。 */
+    nameplateOptions?: DigitalPerformanceNameplateOptions;
 }
 export interface GlobalProgress {
     currentTime: number;

package/libs/DigitalPerformanceV2Plugin/controller/index.d.ts

@@ -1,7 +1,6 @@
 import type { Five } from '@realsee/five';
 import type { DigitalPerformanceV2PluginConfig, DigitalCameraKeyframe, DigitalCameraPlayer, CameraTransition, CameraCoordinateSpace, CameraState, GroupChapterTimeInfo, GroupProgress } from '../typings';
 import { PerformancePlayground } from '../core/Playground';
-import type { DigitalPerformanceNameplateOptions } from '../../DigitalPerformancePlugin/core/DigitalPerformanceNameplate';
 import type { DigitalScript, DigitalChapter } from '../core/shared';
 /** 播放进度（当前章节内） */
 export interface V2Progress {
@@ -356,12 +355,6 @@ export default class DigitalPerformanceV2PluginController {
         playing: boolean;
         currentChapter: DigitalChapter | null;
     };
-    /** 挂载模型头顶 2D 气泡名牌；编辑端与 C 端可使用同一套 API 和自定义渲染器。 */
-    mountNameplates(parent: HTMLElement, options?: DigitalPerformanceNameplateOptions): void;
-    unmountNameplates(): void;
-    setNameplatesEnabled(enabled: boolean): void;
-    /** 调试：显示/隐藏名牌绑定模型的世界包围盒（核对名牌锚点用）。 */
-    setNameplateBoundingBoxVisible(visible: boolean): void;
     /** 实时修改角色名牌；只更新文本和当前剧本，不重新加载模型/动画。 */
     updateModelName(id: string, value: string): void;
     private syncNameplates;

package/libs/DigitalPerformanceV2Plugin/controller/index.js

@@ -27,9 +27,9 @@ var m = (p, e, t) => new Promise((r, a) => {
   o((t = t.apply(p, e)).next());
 });
 import * as T from "three";
-import { PerformancePlayground as G, getChapterModelDuration as x, getChapterDuration as V } from "../core/Playground.js";
-import { CameraTrack as A } from "../core/CameraTrack.js";
-import { DigitalPerformanceNameplate as B, normalizeDigitalPerformanceName as O } from "../../DigitalPerformancePlugin/core/DigitalPerformanceNameplate.js";
+import { PerformancePlayground as A, getChapterModelDuration as x, getChapterDuration as G } from "../core/Playground.js";
+import { CameraTrack as O } from "../core/CameraTrack.js";
+import { DigitalPerformanceNameplate as V, normalizeDigitalPerformanceName as z } from "../../DigitalPerformancePlugin/core/DigitalPerformanceNameplate.js";
 import "../../DigitalPerformancePlugin/core/DigitalPlayground.js";
 import "@realsee/five/gltf-loader";
 import "../../DigitalPerformancePlugin/core/DigitalHuman.js";
@@ -40,12 +40,12 @@ import "../core/PerformanceClock.js";
 import "../core/CameraDirector.js";
 import "../core/FiveModelCameraBridge.js";
 import "../core/CameraSampler.js";
-const z = "Dnalogel-DigitalPerformanceV2Plugin", I = "five-world";
+const B = "Dnalogel-DigitalPerformanceV2Plugin", I = "five-world";
 class re {
   constructor(e, t = {}) {
     h(this, "five");
     h(this, "config");
-    h(this, "NAME", z);
+    h(this, "NAME", B);
     h(this, "playground");
     h(this, "state", {
       enabled: !0,
@@ -98,7 +98,7 @@ class re {
     h(this, "chapterFloorModel", null);
     /** five 'modeChange' 楼层重放监听的反订阅句柄（chapterFloorMap 启用时挂载，停用/reset/dispose 时清理） */
     h(this, "unsubFloorModeChange", null);
-    this.five = e, this.config = g({ autoPlay: !1, loop: !1, debug: !1, showTrace: !1 }, t), this.playground = new G(e, this.config.debug), this.nameplate = new B(e), this.unsubNameplateRender = this.playground.onRender(() => this.nameplate.update()), this.unsubNameplateCameraUpdate = this.five.on("cameraUpdate", () => this.nameplate.update()), this.unsubClockTick = this.playground.getClock().onTick(() => this.emitProgress());
+    this.five = e, this.config = g({ autoPlay: !1, loop: !1, debug: !1, showTrace: !1, showNameplate: !0 }, t), this.playground = new A(e, this.config.debug), this.nameplate = new V(e), this.unsubNameplateRender = this.playground.onRender(() => this.nameplate.update()), this.unsubNameplateCameraUpdate = this.five.on("cameraUpdate", () => this.nameplate.update()), this.unsubClockTick = this.playground.getClock().onTick(() => this.emitProgress()), this.config.showNameplate !== !1 && this.nameplate.enableAutoMount(this.config.nameplateOptions);
   }
   /** 加载剧本：预加载资源 + 将模型加入 five 场景；autoPlay 时自动播放首章 */
   loadScript(e) {
@@ -472,15 +472,15 @@ class re {
     const r = t[e], a = new T.Box3();
     let s = !1;
     if (r.players.forEach((M) => {
-      var E, C, N, v;
+      var E, C, v, N;
       if (M.type !== "model")
         return;
-      const S = M, P = (N = (C = (E = this.playground) == null ? void 0 : E.loader) == null ? void 0 : C.getDigitalHuman) == null ? void 0 : N.call(C, S.model, S.id), y = P == null ? void 0 : P.container;
+      const w = M, P = (v = (C = (E = this.playground) == null ? void 0 : E.loader) == null ? void 0 : C.getDigitalHuman) == null ? void 0 : v.call(C, w.model, w.id), y = P == null ? void 0 : P.container;
       if (!y)
         return;
-      (v = y.updateWorldMatrix) == null || v.call(y, !0, !0);
-      const w = new T.Box3().setFromObject(y);
-      w.isEmpty() || (a.union(w), s = !0);
+      (N = y.updateWorldMatrix) == null || N.call(y, !0, !0);
+      const S = new T.Box3().setFromObject(y);
+      S.isEmpty() || (a.union(S), s = !0);
     }), !s || a.isEmpty())
       return;
     const i = a.getCenter(new T.Vector3()), o = a.getSize(new T.Vector3()).length(), n = (F = (k = (f = this.five).getCurrentState) == null ? void 0 : k.call(f)) != null ? F : {}, l = typeof n.longitude == "number" ? n.longitude : Math.PI / 4, c = typeof n.latitude == "number" ? n.latitude : Math.PI / 5, u = typeof n.fov == "number" && n.fov > 0 ? n.fov : 60, d = this.clamp(o * 2.5, 4, 14);
@@ -549,7 +549,7 @@ class re {
   getProgress() {
     const e = this.playground.getClock(), t = e.getTime();
     let r = e.getDuration();
-    r <= 0 && this.state.currentChapter && (r = V(this.state.currentChapter));
+    r <= 0 && this.state.currentChapter && (r = G(this.state.currentChapter));
     const a = this.getChapters(), s = this.state.currentChapter, i = s ? a.findIndex((o) => o === s || o.name === s.name) : -1;
     return { currentTime: t, totalTime: r, currentChapterIndex: i, totalChapters: a.length };
   }
@@ -677,24 +677,10 @@ class re {
   getState() {
     return { playing: this.state.playing, currentChapter: this.state.currentChapter };
   }
-  /** 挂载模型头顶 2D 气泡名牌；编辑端与 C 端可使用同一套 API 和自定义渲染器。 */
-  mountNameplates(e, t) {
-    this.nameplate.mount(e, t), this.syncNameplates();
-  }
-  unmountNameplates() {
-    this.nameplate.unmount();
-  }
-  setNameplatesEnabled(e) {
-    this.nameplate.setEnabled(e);
-  }
-  /** 调试：显示/隐藏名牌绑定模型的世界包围盒（核对名牌锚点用）。 */
-  setNameplateBoundingBoxVisible(e) {
-    this.nameplate.setBoundingBoxVisible(e);
-  }
   /** 实时修改角色名牌；只更新文本和当前剧本，不重新加载模型/动画。 */
   updateModelName(e, t) {
     var a;
-    const r = O(t);
+    const r = z(t);
     (a = this.state.currentScript) == null || a.chapters.forEach((s) => {
       s.players.forEach((i) => {
         i.type === "model" && i.id === e && (i.name = r);
@@ -851,7 +837,7 @@ class re {
     const r = this.cameraPlayerOf(t[e]);
     if (!r || r.keyframes.length === 0)
       return null;
-    const a = new A();
+    const a = new O();
     return a.setKeyframes(r.keyframes), a;
   }
   /** 深拷贝关键帧序列（数组字段亦深拷贝），供快照/还原使用（Mapview 位姿） */

package/libs/DigitalPerformanceV2Plugin/typings/index.d.ts

@@ -1,4 +1,5 @@
 import type * as THREE from 'three';
+import type { DigitalPerformanceNameplateOptions } from '../../DigitalPerformancePlugin/core/DigitalPerformanceNameplate';
 export interface DigitalPerformanceV2PluginConfig {
     /** 是否在加载剧本后自动播放第一个章节 */
     autoPlay?: boolean;
@@ -8,6 +9,14 @@ export interface DigitalPerformanceV2PluginConfig {
     debug?: boolean;
     /** 是否显示人物运动轨迹线（默认 false，不显示）。仅 debug / 特殊需求开启。 */
     showTrace?: boolean;
+    /**
+     * 是否内置展示模型头顶的 2D 气泡名牌（默认 true）。
+     * 插件会自动挂载到 five canvas 的父容器（与 canvas 同级），消费方只需声明是否展示；
+     * 设为 false 时不挂载任何名牌 DOM。
+     */
+    showNameplate?: boolean;
+    /** 内置名牌的自定义配置（class / 内联样式 / 文本 / 自定义渲染器等）。仅 showNameplate 为真时生效。 */
+    nameplateOptions?: DigitalPerformanceNameplateOptions;
 }
 /**
  * 关键帧到下一关键帧的过渡缓动

package/libs/base/BasePlugin.js

@@ -23,7 +23,7 @@ let I = class {
     /**
      * @realsee/dnalogel 版本号
      */
-    r(this, "VERSION", "3.81.11-alpha.2");
+    r(this, "VERSION", "3.81.11-alpha.3");
     r(this, "NAME");
     r(this, "five");
     r(this, "workUtil");

package/libs/shared-utils/logger.js

@@ -1,6 +1,6 @@
 function A() {
   console.debug(
-    "%c %c@realsee/dnalogel %cv3.81.11-alpha.2",
+    "%c %c@realsee/dnalogel %cv3.81.11-alpha.3",
     [
       "background: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAkAAAAMCAMAAACHgmeRAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAABLFBMVEUAAAAapPoap/oaqvkbrfkbr/gZnfwZoPsaqfnD4v/E4/8Ylv0clPm93/+/4P/B4f8Yj/683/8Wif+33P8Uhv+x2f8ShP+s1v8Pgf+n0/8Nf/+h0f8Lff8Lff8Nf/9dl/+czv8KfP8KfP+Lxf+Uyv+Xy/+Hwv+Jw/+Mxf+Oxv+RyP8aovsapfoap/oZmfwZm/wZnvsYnPsYkf4YlP0NePsDYfgYcfi43f+63v8Xiv8Xjf4EWfwCV/sWZ/qz2v+02/8Vh/8WiP8EUf8CTf4WXv2u1/+v2P8Thf8Thv8ETf8CR/8VV/+o1f+q1f8Qgv8Rg/8DSv8BRf8UVP+j0v+k0v8OgP8Pgf8DR/8DQv9Nhf+dzv+fz/+Kv/+Vyv+Xy/+azf+Oxv+Qx/+SyP////8MUhLdAAAAK3RSTlMACEWQ2bd98uQECPXxqO7c+Pb49vj2+Pb49vj23Oul8fMHA+TwerXXjEIG2P+bHgAAAAFiS0dEY1y+LaoAAAB+SURBVAjXY2BgZGJmYWVgYGBgY9fW0eVg4ORi4NbTNzDk4eXjZxAwMjYxNTO3EGQQsrSytrG1sxdmEHFwdHJ2cXUTZRBz9/D08vbxFWeQ8PMPCAwKDpFkkAoNC4+IjIqWZpCRlZOPiY2LV2BQVGJQTkhMUlEFWaOmrqGpxQAAyg0S9Dq+VPYAAAAASUVORK5CYII=')",
       "background-repeat: no-repeat",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@realsee/dnalogel",
-  "version": "3.81.11-alpha.2",
+  "version": "3.81.11-alpha.3",
   "main": "./dist/index.js",
   "module": "./libs/index.js",
   "types": "./libs/index.d.ts",