@realsee/dnalogel 3.81.0-alpha.3 → 3.81.0-alpha.5

package/libs/DigitalPerformancePlugin/core/DigitalPlayground.js

@@ -1,131 +1,133 @@
 var g = Object.defineProperty;
-var u = (o, t, i) => t in o ? g(o, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : o[t] = i;
-var m = (o, t, i) => (u(o, typeof t != "symbol" ? t + "" : t, i), i);
-var p = (o, t, i) => new Promise((e, a) => {
-  var r = (l) => {
+var u = (m, t, e) => t in m ? g(m, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : m[t] = e;
+var o = (m, t, e) => (u(m, typeof t != "symbol" ? t + "" : t, e), e);
+var h = (m, t, e) => new Promise((i, a) => {
+  var r = (s) => {
     try {
-      s(i.next(l));
-    } catch (h) {
-      a(h);
+      l(e.next(s));
+    } catch (p) {
+      a(p);
     }
-  }, n = (l) => {
+  }, n = (s) => {
     try {
-      s(i.throw(l));
-    } catch (h) {
-      a(h);
+      l(e.throw(s));
+    } catch (p) {
+      a(p);
     }
-  }, s = (l) => l.done ? e(l.value) : Promise.resolve(l.value).then(r, n);
-  s((i = i.apply(o, t)).next());
+  }, l = (s) => s.done ? i(s.value) : Promise.resolve(s.value).then(r, n);
+  l((e = e.apply(m, t)).next());
 });
 import * as d from "three";
 import { GLTFLoader as M } from "@realsee/five/gltf-loader";
 import { DigitalHuman as y } from "./DigitalHuman.js";
-import { loadGltf as A } from "@realsee/five";
+import { loadGltf as T } from "@realsee/five";
 import "./DigitalStateMachine.js";
 import "./Trace.js";
-class T {
+class k {
   constructor(t = !1) {
-    m(this, "gltfLoader");
-    m(this, "script");
-    m(this, "currentChapter");
-    m(this, "digitalHumanMap");
-    m(this, "digitalItemMap");
-    m(this, "skeletalAnimationMap");
-    m(this, "debugMode");
+    o(this, "gltfLoader");
+    o(this, "script");
+    o(this, "currentChapter");
+    o(this, "digitalHumanMap");
+    o(this, "digitalItemMap");
+    o(this, "skeletalAnimationMap");
+    o(this, "debugMode");
+    /** 运动轨迹线开关（默认关闭）。应用到已加载及后续加载的所有 DigitalHuman。 */
+    o(this, "showTrace", !1);
     this.gltfLoader = new M(), this.digitalHumanMap = /* @__PURE__ */ new Map(), this.digitalItemMap = /* @__PURE__ */ new Map(), this.skeletalAnimationMap = /* @__PURE__ */ new Map(), this.script = null, this.currentChapter = null, this.debugMode = t;
   }
   setScript(t) {
     this.script = t;
   }
-  loadModel(t, i) {
-    return p(this, null, function* () {
-      const e = i ? `${t}_${i}` : t;
-      if (this.digitalHumanMap.has(e)) {
-        const a = this.digitalHumanMap.get(e);
+  loadModel(t, e) {
+    return h(this, null, function* () {
+      const i = e ? `${t}_${e}` : t;
+      if (this.digitalHumanMap.has(i)) {
+        const a = this.digitalHumanMap.get(i);
         return Promise.resolve(a);
       } else
         return new Promise((a, r) => {
           t.endsWith(".gltf") || t.endsWith(".glb") ? this.loadGLTF(t).then((n) => {
-            const s = n.scene, l = new y(s, this);
-            this.digitalHumanMap.set(e, l), a(l);
+            const l = n.scene, s = new y(l, this);
+            s.setTraceVisible(this.showTrace), this.digitalHumanMap.set(i, s), a(s);
           }) : r(new Error("不支持的模型格式"));
         });
     });
   }
-  loadModels(t, i) {
-    return p(this, null, function* () {
-      return i && i.length === t.length ? Promise.all(t.map((e, a) => this.loadModel(e, i[a]))) : Promise.all(t.map((e) => this.loadModel(e)));
+  loadModels(t, e) {
+    return h(this, null, function* () {
+      return e && e.length === t.length ? Promise.all(t.map((i, a) => this.loadModel(i, e[a]))) : Promise.all(t.map((i) => this.loadModel(i)));
     });
   }
   // 加载骨骼动画，暂且认为一个glb只包含一个骨骼动画
   loadAnimation(t) {
-    return p(this, null, function* () {
+    return h(this, null, function* () {
       if (this.skeletalAnimationMap.has(t)) {
-        const i = this.skeletalAnimationMap.get(t);
-        return Promise.resolve(i);
+        const e = this.skeletalAnimationMap.get(t);
+        return Promise.resolve(e);
       } else
-        return new Promise((i, e) => {
+        return new Promise((e, i) => {
           this.loadGLTF(t).then((a) => {
             const n = a.animations[0];
-            this.skeletalAnimationMap.set(t, n), i(n);
+            this.skeletalAnimationMap.set(t, n), e(n);
           });
         });
     });
   }
   loadAnimations(t) {
-    return p(this, null, function* () {
-      return Promise.all(t.map((i) => this.loadAnimation(i)));
+    return h(this, null, function* () {
+      return Promise.all(t.map((e) => this.loadAnimation(e)));
     });
   }
   getAnimation(t) {
     return this.skeletalAnimationMap.get(t) || null;
   }
-  getDigitalHuman(t, i) {
-    const e = i ? `${t}_${i}` : t;
-    return this.digitalHumanMap.get(e) || null;
+  getDigitalHuman(t, e) {
+    const i = e ? `${t}_${e}` : t;
+    return this.digitalHumanMap.get(i) || null;
   }
   playByChapter(t) {
-    return p(this, null, function* () {
+    return h(this, null, function* () {
       if (!t || !Array.isArray(t.players))
         throw new Error("Invalid chapter: chapter or chapter.players is undefined");
       this.currentChapter = t;
-      const i = t.players.filter((a) => a.type === "model");
+      const e = t.players.filter((a) => a.type === "model");
       this.digitalHumanMap.forEach((a) => {
         a.model.visible = !1, a.container.visible = !1;
       });
-      const e = [];
-      for (let a = 0; a < i.length; a++) {
-        const r = i[a], n = `${r.model}_${r.id}`, s = this.digitalHumanMap.get(n);
-        s && (s.model.visible = !0, s.container.visible = !0, e.push(s.play({ keyframes: r.keyframes, items: [], effects: [] })));
+      const i = [];
+      for (let a = 0; a < e.length; a++) {
+        const r = e[a], n = `${r.model}_${r.id}`, l = this.digitalHumanMap.get(n);
+        l && (l.model.visible = !0, l.container.visible = !0, i.push(l.play({ keyframes: r.keyframes, items: [], effects: [] })));
       }
-      return Promise.all(e);
+      return Promise.all(i);
     });
   }
-  loadItems(t, i) {
-    return p(this, null, function* () {
-      return Promise.all(t.map((e) => this.loadItem(e, i == null ? void 0 : i.get(e))));
+  loadItems(t, e) {
+    return h(this, null, function* () {
+      return Promise.all(t.map((i) => this.loadItem(i, e == null ? void 0 : e.get(i))));
     });
   }
-  loadItem(t, i) {
-    return p(this, null, function* () {
+  loadItem(t, e) {
+    return h(this, null, function* () {
       if (this.digitalItemMap.has(t)) {
-        const e = this.digitalItemMap.get(t);
-        return Promise.resolve(e);
+        const i = this.digitalItemMap.get(t);
+        return Promise.resolve(i);
       } else
-        return new Promise((e, a) => {
+        return new Promise((i, a) => {
           t.endsWith(".gltf") || t.endsWith(".glb") ? this.loadGLTF(t).then((r) => {
             const n = r.scene;
-            if (i && (i != null && i.position) && (i != null && i.rotation)) {
-              const [s, l, h] = i.position;
-              n.position.set(s * 0.01, -l * 0.01, -h * 0.01);
+            if (e && (e != null && e.position) && (e != null && e.rotation)) {
+              const [l, s, p] = e.position;
+              n.position.set(l * 0.01, -s * 0.01, -p * 0.01);
               const c = new d.Euler(
-                d.MathUtils.degToRad(i.rotation[0]),
-                d.MathUtils.degToRad(i.rotation[1]),
-                d.MathUtils.degToRad(i.rotation[2])
+                d.MathUtils.degToRad(e.rotation[0]),
+                d.MathUtils.degToRad(e.rotation[1]),
+                d.MathUtils.degToRad(e.rotation[2])
               );
               n.quaternion.setFromEuler(c);
             }
-            this.digitalItemMap.set(t, n), e(n);
+            this.digitalItemMap.set(t, n), i(n);
           }) : a(new Error("不支持的模型格式"));
         });
     });
@@ -149,8 +151,17 @@ class T {
     });
   }
   setTimelineTo(t) {
-    this.digitalHumanMap.forEach((i) => {
-      i.state.currentTime = t;
+    this.digitalHumanMap.forEach((e) => {
+      e.state.currentTime = t;
+    });
+  }
+  /**
+   * 运动轨迹线开关（默认关闭）。作用于当前所有 DigitalHuman，并记忆给后续加载的模型。
+   * 仅 debug / 特殊需求由业务经插件显式开启。
+   */
+  setTraceVisible(t) {
+    this.showTrace = t, this.digitalHumanMap.forEach((e) => {
+      e.setTraceVisible(t);
     });
   }
   /**
@@ -162,12 +173,12 @@ class T {
     }), this.digitalHumanMap.clear(), this.digitalItemMap.clear(), this.skeletalAnimationMap.clear();
   }
   loadGLTF(t) {
-    return A(t).then((i) => {
-      const e = i == null ? void 0 : i.upAxis;
-      return i && e === "Z" && i.scene && (i.scene.rotateX(-Math.PI / 2), i.scene.updateMatrixWorld(!0)), i;
+    return T(t).then((e) => {
+      const i = e == null ? void 0 : e.upAxis;
+      return e && i === "Z" && e.scene && (e.scene.rotateX(-Math.PI / 2), e.scene.updateMatrixWorld(!0)), e;
     });
   }
 }
 export {
-  T as DigitalPlayground
+  k as DigitalPlayground
 };

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

@@ -106,6 +106,16 @@ export default class DigitalPerformanceV2PluginController {
      * `null`（整体）表示未启用该能力（不触碰楼层可见性）。由消费方经 `setChapterFloorMap` 注入。
      */
     private chapterFloorMap;
+    /**
+     * 楼层可见性作用的目标模型（`show(floorIndex)` 的接收者）。
+     * - `null`：回退到 `five.model`（= `modelScene.models[0]`，单 VR 即唯一模型）。
+     * - 沙盘/联合现场：`five.model` 恒为 models[0]，未必是当前播放的子 VR，故消费方须显式注入
+     *   动画所属子 VR 的模型（`five.models.find(m => m.name === resourceCode)`），否则楼层隔离会落到
+     *   错误模型，被播放子 VR 保持全楼层可见（表现为「跨楼层动画所有楼层同时高亮」）。
+     */
+    private chapterFloorModel;
+    /** five 'modeChange' 楼层重放监听的反订阅句柄（chapterFloorMap 启用时挂载，停用/reset/dispose 时清理） */
+    private unsubFloorModeChange;
     constructor(five: Five, config?: DigitalPerformanceV2PluginConfig);
     /** 加载剧本：预加载资源 + 将模型加入 five 场景；autoPlay 时自动播放首章 */
     loadScript(script: DigitalScript): Promise<void>;
@@ -157,6 +167,11 @@ export default class DigitalPerformanceV2PluginController {
     continueForEdit(): Promise<void>;
     /** 运镜开关：关闭后播放仅驱动模型动画，不接管 five 相机（立即生效） */
     setCameraDirectionEnabled(enabled: boolean): void;
+    /**
+     * 人物运动轨迹线开关（默认关闭、不显示）。仅 debug / 特殊需求由业务显式开启。
+     * 立即作用于当前所有 DigitalHuman，并记忆给后续加载的模型。
+     */
+    setTraceVisible(visible: boolean): void;
     /**
      * 加法式：设置「章节索引 → 楼层」映射，启用「播放/切章时 Mapview 只显示当前章节所在楼层」。
      * - number：该章节单一楼层；null：该章节内跨楼层 → 显示全部；映射缺项按显示全部处理。
@@ -164,11 +179,25 @@ export default class DigitalPerformanceV2PluginController {
      * - 传入 null：停用该能力（不再随章节应用），但**不主动恢复**楼层可见性（恢复由 `reset()` 负责）。
      * 楼层可见性是 five 空间模型的显隐（`five.model.show`），与运镜相机接管相互独立。
      * 各消费方（workshop 编辑端 / NextVR 展示端）自行从各自数据算好映射注入，保证两端行为一致（parity）。
+     *
+     * @param model 楼层可见性作用的目标模型（缺省/undefined/null 回退到 `five.model`）。
+     *   单 VR 场景无需传（`five.model` 即唯一模型）；沙盘/联合现场须传动画所属子 VR 的模型
+     *   （`five.models.find(m => m.name === resourceCode)`），否则楼层隔离会落到 models[0] 而非播放中的子 VR，
+     *   导致跨楼层动画所有楼层同时高亮。传入 null 时清空目标模型回退到 `five.model`。
      */
-    setChapterFloorMap(map: Record<number, number | null> | null): void;
+    setChapterFloorMap(map: Record<number, number | null> | null, model?: {
+        show?: (floorIndex?: number) => void;
+    } | null): void;
+    /** 监听 five 'modeChange'：模态切换后（延后一帧）重放当前章节楼层，避免被外部 UI 覆盖（只挂一次） */
+    private hookFloorModeChange;
+    /** 取消 'modeChange' 楼层重放监听 */
+    private unhookFloorModeChange;
     /** 按章节楼层映射对指定章节应用楼层可见性（映射未启用时 no-op） */
     private applyChapterFloor;
-    /** 显示指定楼层（传 undefined 显示全部）。安全访问 five.model.show，避免类型/运行时缺失。 */
+    /**
+     * 显示指定楼层（传 undefined 显示全部）。安全访问 model.show，避免类型/运行时缺失。
+     * 目标模型优先用消费方注入的 `chapterFloorModel`（沙盘下为播放中的子 VR），缺省回退 `five.model`。
+     */
     private showModelFloor;
     /**
      * seek 预览：跳转到指定时间并渲染当前帧（不改变播放/暂停状态）。