@realsee/dnalogel 3.81.12-alpha.1 → 3.81.12

package/libs/DigitalPerformanceV2Plugin/core/Playground.d.ts

@@ -17,6 +17,7 @@ export declare function getChapterModelDuration(chapter: DigitalChapter): number
  * 复用 Shared_Core 的 DigitalPlayground 做模型/动画/道具加载与实例管理，
  * 但用 PerformanceClock 统一驱动 DigitalHuman.renderAtTime，不使用 Legacy 的 playByChapter / 自驱 rAF。
  */
+export type PerformanceRenderListener = (time: number, delta: number) => void;
 export declare class PerformancePlayground {
     /** 复用 Shared_Core 的加载与实例管理 */
     readonly loader: DigitalPlayground;
@@ -25,12 +26,15 @@ export declare class PerformancePlayground {
     private readonly clock;
     private currentChapter;
     private shownHumans;
+    private renderListeners;
     private unsubTick;
     /** 结束当前 pending 的 playByChapter Promise 的句柄（用于 reset 时干净收尾，避免 await 泄漏） */
     private currentPlayResolve;
     constructor(five: Five, debug?: boolean);
     getClock(): PerformanceClock;
     getCurrentChapter(): DigitalChapter | null;
+    /** 在模型 renderAtTime 完成后执行，供名牌等跟随 UI 使用。 */
+    onRender(listener: PerformanceRenderListener): () => void;
     setScript(script: Parameters<DigitalPlayground['setScript']>[0]): void;
     /**
      * 播放指定章节：准备模型 → 统一时钟驱动 renderAtTime → 自然结束 resolve。

package/libs/DigitalPerformanceV2Plugin/core/Playground.js

@@ -1,6 +1,6 @@
 var k = Object.defineProperty;
 var y = (s, e, t) => e in s ? k(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
-var o = (s, e, t) => (y(s, typeof e != "symbol" ? e + "" : e, t), t);
+var n = (s, e, t) => (y(s, typeof e != "symbol" ? e + "" : e, t), t);
 import "three";
 import { DigitalPlayground as C } from "../../DigitalPerformancePlugin/core/DigitalPlayground.js";
 import { PerformanceClock as T } from "./PerformanceClock.js";
@@ -21,7 +21,7 @@ function d(s) {
   }
   return e;
 }
-function I(s) {
+function K(s) {
   let e = 0;
   for (const t of s.players) {
     if (t.type !== "model")
@@ -34,18 +34,19 @@ function I(s) {
 function m(s, e, t) {
   return s < e ? e : s > t ? t : s;
 }
-class V {
+class I {
   constructor(e, t = !1) {
     /** 复用 Shared_Core 的加载与实例管理 */
-    o(this, "loader");
+    n(this, "loader");
     /** 运镜导演（消费 camera player，驱动 five 相机） */
-    o(this, "director");
-    o(this, "clock");
-    o(this, "currentChapter", null);
-    o(this, "shownHumans", []);
-    o(this, "unsubTick", null);
+    n(this, "director");
+    n(this, "clock");
+    n(this, "currentChapter", null);
+    n(this, "shownHumans", []);
+    n(this, "renderListeners", /* @__PURE__ */ new Set());
+    n(this, "unsubTick", null);
     /** 结束当前 pending 的 playByChapter Promise 的句柄（用于 reset 时干净收尾，避免 await 泄漏） */
-    o(this, "currentPlayResolve", null);
+    n(this, "currentPlayResolve", null);
     this.loader = new C(t), this.clock = new T(e), this.director = new w(e);
   }
   getClock() {
@@ -54,6 +55,10 @@ class V {
   getCurrentChapter() {
     return this.currentChapter;
   }
+  /** 在模型 renderAtTime 完成后执行，供名牌等跟随 UI 使用。 */
+  onRender(e) {
+    return this.renderListeners.add(e), () => this.renderListeners.delete(e);
+  }
   setScript(e) {
     this.loader.setScript(e);
   }
@@ -67,10 +72,10 @@ class V {
   playByChapter(e, t = 0, r) {
     this.stopTick(), this.currentChapter = e, this.hideShownHumans(), this.shownHumans = this.showChapterModels(e), this.bindChapterCamera(e, !0);
     const i = d(e);
-    return new Promise((n) => {
+    return new Promise((o) => {
       let c = null;
       const a = () => {
-        this.currentPlayResolve === a && (this.currentPlayResolve = null, c && c(), this.stopTick(), n());
+        this.currentPlayResolve === a && (this.currentPlayResolve = null, c && c(), this.stopTick(), o());
       };
       this.currentPlayResolve = a;
       const h = () => {
@@ -108,8 +113,8 @@ class V {
   showChapterModels(e) {
     const t = e.players.filter((i) => i.type === "model"), r = [];
     for (const i of t) {
-      const n = this.loader.getDigitalHuman(i.model, i.id);
-      n && (n.model.visible = !0, n.container.visible = !0, n.prepareExternalDrive({ keyframes: i.keyframes, items: [], effects: [] }), r.push(n));
+      const o = this.loader.getDigitalHuman(i.model, i.id);
+      o && (o.model.visible = !0, o.container.visible = !0, o.prepareExternalDrive({ keyframes: i.keyframes, items: [], effects: [] }), r.push(o));
     }
     return r;
   }
@@ -191,11 +196,12 @@ class V {
   }
   /** 释放资源 */
   dispose() {
-    this.currentPlayResolve && this.currentPlayResolve(), this.stopTick(), this.clock.dispose(), this.director.dispose(), this.shownHumans = [], this.currentChapter = null, this.loader.dispose();
+    this.currentPlayResolve && this.currentPlayResolve(), this.stopTick(), this.clock.dispose(), this.director.dispose(), this.shownHumans = [], this.currentChapter = null, this.renderListeners.clear(), this.loader.dispose();
   }
   renderShownAt(e, t) {
     for (const r of this.shownHumans)
       r.renderAtTime(e, t);
+    this.renderListeners.forEach((r) => r(e, t));
   }
   hideShownHumans() {
     for (const e of this.shownHumans)
@@ -207,7 +213,7 @@ class V {
   }
 }
 export {
-  V as PerformancePlayground,
+  I as PerformancePlayground,
   d as getChapterDuration,
-  I as getChapterModelDuration
+  K as getChapterModelDuration
 };

package/libs/DigitalPerformanceV2Plugin/index/index.js

@@ -1,11 +1,15 @@
 import r from "../controller/index.js";
-const e = (o, t) => new r(o, t), l = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+import { DEFAULT_DIGITAL_PERFORMANCE_NAME_MAX_LENGTH as i, DigitalPerformanceNameplate as l, normalizeDigitalPerformanceName as n } from "../../DigitalPerformancePlugin/core/DigitalPerformanceNameplate.js";
+const e = (o, t) => new r(o, t), f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
+  DEFAULT_DIGITAL_PERFORMANCE_NAME_MAX_LENGTH: i,
+  DigitalPerformanceNameplate: l,
   DigitalPerformanceV2Plugin: e,
   DigitalPerformanceV2PluginController: r,
-  default: e
+  default: e,
+  normalizeDigitalPerformanceName: n
 }, Symbol.toStringTag, { value: "Module" }));
 export {
   e as DigitalPerformanceV2Plugin,
-  l as index
+  f as index
 };

package/libs/DigitalPerformanceV2Plugin/index.d.ts

@@ -2,6 +2,8 @@ import type { Five } from '@realsee/five';
 import DigitalPerformanceV2PluginController from './controller';
 export { default as DigitalPerformanceV2PluginController } from './controller';
 export type { V2Progress, V2ProgressListener } from './controller';
+export { DigitalPerformanceNameplate, normalizeDigitalPerformanceName, DEFAULT_DIGITAL_PERFORMANCE_NAME_MAX_LENGTH, } from '../DigitalPerformancePlugin/core/DigitalPerformanceNameplate';
+export type { DigitalPerformanceNameplateBinding, DigitalPerformanceNameplateOptions, DigitalPerformanceNameplateRenderContext, } from '../DigitalPerformancePlugin/core/DigitalPerformanceNameplate';
 export * from './typings';
 export type DigitalPerformanceV2PluginExportInterface = InstanceType<typeof DigitalPerformanceV2PluginController>;
 export type DigitalPerformanceV2PluginParamsInterface = ConstructorParameters<typeof DigitalPerformanceV2PluginController>[1];

package/libs/DigitalPerformanceV2Plugin/index.js

@@ -1,5 +1,6 @@
-import { default as D } from "./controller/index.js";
-import { DigitalPerformanceV2Plugin as d, DigitalPerformanceV2Plugin as s } from "./index/index.js";
+import { default as x } from "./controller/index.js";
+import { DEFAULT_DIGITAL_PERFORMANCE_NAME_MAX_LENGTH as M, DigitalPerformanceNameplate as T, normalizeDigitalPerformanceName as V } from "../DigitalPerformancePlugin/core/DigitalPerformanceNameplate.js";
+import { DigitalPerformanceV2Plugin as s, DigitalPerformanceV2Plugin as C } from "./index/index.js";
 import "three";
 import "./core/Playground.js";
 import "../DigitalPerformancePlugin/core/DigitalPlayground.js";
@@ -13,8 +14,16 @@ import "./core/CameraTrack.js";
 import "./core/CameraSampler.js";
 import "./core/CameraDirector.js";
 import "./core/FiveModelCameraBridge.js";
+import "../DigitalPerformancePlugin/animation-script-adapter.js";
+import "../DigitalPerformancePlugin/movement-track-classifier.js";
+import "../DigitalPerformancePlugin/transform-script-data.js";
+import "../DigitalPerformancePlugin/mock.js";
+import "../shared-utils/five/transformPosition.js";
 export {
-  d as DigitalPerformanceV2Plugin,
-  D as DigitalPerformanceV2PluginController,
-  s as default
+  M as DEFAULT_DIGITAL_PERFORMANCE_NAME_MAX_LENGTH,
+  T as DigitalPerformanceNameplate,
+  s as DigitalPerformanceV2Plugin,
+  x as DigitalPerformanceV2PluginController,
+  C as default,
+  V as normalizeDigitalPerformanceName
 };

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

@@ -1,7 +1,7 @@
 var e = Object.defineProperty;
 var s = (o, t, i) => t in o ? e(o, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : o[t] = i;
 var r = (o, t, i) => (s(o, typeof t != "symbol" ? t + "" : t, i), i);
-import { Subscribe as l } from "../shared-utils/Subscribe.js";
+import { Subscribe as m } from "../shared-utils/Subscribe.js";
 import "../shared-utils/tag.js";
 import "three";
 import "../vendor/hammerjs/hammer.js";
@@ -15,7 +15,7 @@ import "../shared-utils/three/blink.js";
 import "../vendor/@tweenjs/tween/dist/tween.esm.js.js";
 import "../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
 import "../vendor/earcut/src/earcut.js";
-import { FiveUtil as m } from "../shared-utils/Utils/FiveUtil.js";
+import { FiveUtil as l } from "../shared-utils/Utils/FiveUtil.js";
 import { DEFAULT_STATIC_PREFIX as p } from "../shared-utils/url/defaultUrls.js";
 import "../shared-utils/five/FivePuppet.js";
 let I = class {
@@ -23,7 +23,7 @@ let I = class {
     /**
      * @realsee/dnalogel 版本号
      */
-    r(this, "VERSION", "3.81.12-alpha.1");
+    r(this, "VERSION", "3.81.12");
     r(this, "NAME");
     r(this, "five");
     r(this, "workUtil");
@@ -31,9 +31,9 @@ let I = class {
     /**
      * @description: 插件事件钩子
      */
-    r(this, "hooks", new l());
+    r(this, "hooks", new m());
     r(this, "staticPrefix", p);
-    this.five = t, this.fiveUtil = new m(t), this.workUtil = this.fiveUtil.workUtil, i != null && i.staticPrefix && (this.staticPrefix = i.staticPrefix);
+    this.five = t, this.fiveUtil = new l(t), this.workUtil = this.fiveUtil.workUtil, i != null && i.staticPrefix && (this.staticPrefix = i.staticPrefix);
   }
   set workCode(t) {
     this.workUtil.workCode = t, this.onWorkCodeChange();