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

package/libs/DigitalPerformanceV2Plugin/controller/index.js

@@ -11,24 +11,24 @@ var k = (p, e, t) => e in p ? R(p, e, { enumerable: !0, configurable: !0, writab
 };
 var h = (p, e, t) => (k(p, typeof e != "symbol" ? e + "" : e, t), t);
 var m = (p, e, t) => new Promise((r, a) => {
-  var s = (i) => {
+  var s = (n) => {
     try {
-      o(t.next(i));
+      o(t.next(n));
     } catch (l) {
       a(l);
     }
-  }, n = (i) => {
+  }, i = (n) => {
     try {
-      o(t.throw(i));
+      o(t.throw(n));
     } catch (l) {
       a(l);
     }
-  }, o = (i) => i.done ? r(i.value) : Promise.resolve(i.value).then(s, n);
+  }, o = (n) => n.done ? r(n.value) : Promise.resolve(n.value).then(s, i);
   o((t = t.apply(p, e)).next());
 });
 import * as T from "three";
-import { PerformancePlayground as N, getChapterModelDuration as L, getChapterDuration as A } from "../core/Playground.js";
-import { CameraTrack as O } from "../core/CameraTrack.js";
+import { PerformancePlayground as A, getChapterModelDuration as I, getChapterDuration as N } from "../core/Playground.js";
+import { CameraTrack as V } from "../core/CameraTrack.js";
 import "../../DigitalPerformancePlugin/core/DigitalPlayground.js";
 import "@realsee/five/gltf-loader";
 import "../../DigitalPerformancePlugin/core/DigitalHuman.js";
@@ -39,12 +39,12 @@ import "../core/PerformanceClock.js";
 import "../core/CameraDirector.js";
 import "../core/FiveModelCameraBridge.js";
 import "../core/CameraSampler.js";
-const V = "Dnalogel-DigitalPerformanceV2Plugin", I = "five-world";
+const O = "Dnalogel-DigitalPerformanceV2Plugin", L = "five-world";
 class $ {
   constructor(e, t = {}) {
     h(this, "five");
     h(this, "config");
-    h(this, "NAME", V);
+    h(this, "NAME", O);
     h(this, "playground");
     h(this, "state", {
       enabled: !0,
@@ -84,25 +84,36 @@ class $ {
      * `null`（整体）表示未启用该能力（不触碰楼层可见性）。由消费方经 `setChapterFloorMap` 注入。
      */
     h(this, "chapterFloorMap", null);
-    this.five = e, this.config = g({ autoPlay: !1, loop: !1, debug: !1 }, t), this.playground = new N(e, this.config.debug), this.unsubClockTick = this.playground.getClock().onTick(() => this.emitProgress());
+    /**
+     * 楼层可见性作用的目标模型（`show(floorIndex)` 的接收者）。
+     * - `null`：回退到 `five.model`（= `modelScene.models[0]`，单 VR 即唯一模型）。
+     * - 沙盘/联合现场：`five.model` 恒为 models[0]，未必是当前播放的子 VR，故消费方须显式注入
+     *   动画所属子 VR 的模型（`five.models.find(m => m.name === resourceCode)`），否则楼层隔离会落到
+     *   错误模型，被播放子 VR 保持全楼层可见（表现为「跨楼层动画所有楼层同时高亮」）。
+     */
+    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 A(e, this.config.debug), this.unsubClockTick = this.playground.getClock().onTick(() => this.emitProgress());
   }
   /** 加载剧本：预加载资源 + 将模型加入 five 场景；autoPlay 时自动播放首章 */
   loadScript(e) {
     return m(this, null, function* () {
+      var t;
       if (this.state.currentScript = e, this.playground.setScript(e), this.groupChapterTimeMapCache = null, this.groupChapterTimeMapCacheScript = null, this.chapterFloorMap = null, yield this.preloadResources(e), this.five && this.five.scene) {
-        yield new Promise((r) => requestAnimationFrame(() => r()));
-        let t = 0;
-        if (e.chapters.forEach((r) => {
-          r.players.forEach((a) => {
-            if (a.type === "model") {
-              const s = this.playground.loader.getDigitalHuman(a.model, a.id);
-              s != null && s.container && (this.five.scene.add(s.container), t++);
+        yield new Promise((a) => requestAnimationFrame(() => a()));
+        let r = 0;
+        if (e.chapters.forEach((a) => {
+          a.players.forEach((s) => {
+            if (s.type === "model") {
+              const i = this.playground.loader.getDigitalHuman(s.model, s.id);
+              i != null && i.container && (this.five.scene.add(i.container), r++);
             }
           });
-        }), t === 0)
+        }), r === 0)
           throw new Error("没有模型被添加到场景中");
       }
-      this.config.autoPlay && e.chapters.length > 0 && (yield this.playChapter(e.chapters[0]));
+      this.playground.setTraceVisible((t = this.config.showTrace) != null ? t : !1), this.config.autoPlay && e.chapters.length > 0 && (yield this.playChapter(e.chapters[0]));
     });
   }
   /** 播放指定章节 */
@@ -224,6 +235,13 @@ class $ {
   setCameraDirectionEnabled(e) {
     this.playground.setCameraDirectionEnabled(e);
   }
+  /**
+   * 人物运动轨迹线开关（默认关闭、不显示）。仅 debug / 特殊需求由业务显式开启。
+   * 立即作用于当前所有 DigitalHuman，并记忆给后续加载的模型。
+   */
+  setTraceVisible(e) {
+    this.playground.setTraceVisible(e);
+  }
   /**
    * 加法式：设置「章节索引 → 楼层」映射，启用「播放/切章时 Mapview 只显示当前章节所在楼层」。
    * - number：该章节单一楼层；null：该章节内跨楼层 → 显示全部；映射缺项按显示全部处理。
@@ -231,12 +249,44 @@ class $ {
    * - 传入 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(e) {
-    if (this.chapterFloorMap = e, e) {
-      const t = this.getCurrentChapterIndex();
-      this.applyChapterFloor(t >= 0 ? t : 0);
-    }
+  setChapterFloorMap(e, t) {
+    if (this.chapterFloorMap = e, arguments.length >= 2 && (this.chapterFloorModel = t != null ? t : null), e) {
+      const r = this.getCurrentChapterIndex();
+      this.applyChapterFloor(r >= 0 ? r : 0), this.hookFloorModeChange();
+    } else
+      this.unhookFloorModeChange();
+  }
+  /** 监听 five 'modeChange'：模态切换后（延后一帧）重放当前章节楼层，避免被外部 UI 覆盖（只挂一次） */
+  hookFloorModeChange() {
+    if (this.unsubFloorModeChange)
+      return;
+    const e = this.five;
+    if (typeof e.on != "function")
+      return;
+    const t = () => {
+      if (!this.chapterFloorMap)
+        return;
+      (typeof requestAnimationFrame == "function" ? requestAnimationFrame : (a) => setTimeout(a, 0))(() => {
+        if (!this.chapterFloorMap)
+          return;
+        const a = this.getCurrentChapterIndex();
+        this.applyChapterFloor(a >= 0 ? a : 0);
+      });
+    };
+    e.on("modeChange", t), this.unsubFloorModeChange = () => {
+      var r;
+      return (r = e.off) == null ? void 0 : r.call(e, "modeChange", t);
+    };
+  }
+  /** 取消 'modeChange' 楼层重放监听 */
+  unhookFloorModeChange() {
+    this.unsubFloorModeChange && (this.unsubFloorModeChange(), this.unsubFloorModeChange = null);
   }
   /** 按章节楼层映射对指定章节应用楼层可见性（映射未启用时 no-op） */
   applyChapterFloor(e) {
@@ -245,11 +295,14 @@ class $ {
     const t = e in this.chapterFloorMap ? this.chapterFloorMap[e] : null;
     this.showModelFloor(typeof t == "number" ? t : void 0);
   }
-  /** 显示指定楼层（传 undefined 显示全部）。安全访问 five.model.show，避免类型/运行时缺失。 */
+  /**
+   * 显示指定楼层（传 undefined 显示全部）。安全访问 model.show，避免类型/运行时缺失。
+   * 目标模型优先用消费方注入的 `chapterFloorModel`（沙盘下为播放中的子 VR），缺省回退 `five.model`。
+   */
   showModelFloor(e) {
-    var r, a, s;
-    const t = (r = this.five) == null ? void 0 : r.model;
-    typeof e == "number" ? (a = t == null ? void 0 : t.show) == null || a.call(t, e) : (s = t == null ? void 0 : t.show) == null || s.call(t);
+    var r, a, s, i;
+    const t = (a = this.chapterFloorModel) != null ? a : (r = this.five) == null ? void 0 : r.model;
+    typeof e == "number" ? (s = t == null ? void 0 : t.show) == null || s.call(t, e) : (i = t == null ? void 0 : t.show) == null || i.call(t);
   }
   /**
    * seek 预览：跳转到指定时间并渲染当前帧（不改变播放/暂停状态）。
@@ -271,17 +324,17 @@ class $ {
       return a;
     if (!(Number.isFinite(e) && e >= 0))
       return this.rejectKeyframe("time 必须为非负有限数");
-    const s = this.ensureCameraPlayer(), n = this.captureCameraPose(), o = this.resolveFov(t), i = {
+    const s = this.ensureCameraPlayer(), i = this.captureCameraPose(), o = this.resolveFov(t), n = {
       timeStamp: e,
-      target: n.target,
-      longitude: n.longitude,
-      latitude: n.latitude,
-      distance: n.distance,
+      target: i.target,
+      longitude: i.longitude,
+      latitude: i.latitude,
+      distance: i.distance,
       fov: o
     };
-    r != null && r.transition && (i.transition = r.transition), r != null && r.thumbnail && (i.thumbnail = r.thumbnail);
+    r != null && r.transition && (n.transition = r.transition), r != null && r.thumbnail && (n.thumbnail = r.thumbnail);
     const l = s.keyframes.findIndex((c) => c.timeStamp === e);
-    return l >= 0 ? s.keyframes[l] = i : s.keyframes.push(i), s.keyframes.sort((c, u) => c.timeStamp - u.timeStamp), this.afterKeyframesChanged(s);
+    return l >= 0 ? s.keyframes[l] = n : s.keyframes.push(n), s.keyframes.sort((c, u) => c.timeStamp - u.timeStamp), this.afterKeyframesChanged(s);
   }
   /**
    * 更新指定下标关键帧：合并 patch 中出现的字段，按 timeStamp 重排序。
@@ -297,7 +350,7 @@ class $ {
     if (t.timeStamp !== void 0 && !(Number.isFinite(t.timeStamp) && t.timeStamp >= 0))
       return this.rejectKeyframe("time 必须为非负有限数");
     const s = g(g({}, a.keyframes[e]), t);
-    return a.keyframes[e] = s, a.keyframes.sort((n, o) => n.timeStamp - o.timeStamp), this.afterKeyframesChanged(a);
+    return a.keyframes[e] = s, a.keyframes.sort((i, o) => i.timeStamp - o.timeStamp), this.afterKeyframesChanged(a);
   }
   /** 移除指定下标关键帧。拒绝（保持序列不变）：未加载 script / 无章节 / index 越界。 */
   removeCameraKeyframe(e) {
@@ -330,7 +383,7 @@ class $ {
         name: (t = e == null ? void 0 : e.name) != null ? t : "camera",
         type: "camera",
         keyframes: this.serializeKeyframes(e),
-        coordinateSpace: I
+        coordinateSpace: L
       }
     };
   }
@@ -351,7 +404,7 @@ class $ {
           name: (s = a.name) != null ? s : "camera",
           type: "camera",
           keyframes: this.serializeKeyframes(a),
-          coordinateSpace: I
+          coordinateSpace: L
         }
       });
     }), e;
@@ -367,9 +420,9 @@ class $ {
       const s = Number(a);
       if (!Number.isInteger(s) || s < 0 || s >= t.length)
         return;
-      const n = t[s], o = e[s];
-      let i = n.players.find((u) => u.type === "camera");
-      i || (i = { name: (l = o.name) != null ? l : "camera", type: "camera", keyframes: [] }, n.players.push(i)), i.keyframes = [...(c = o.keyframes) != null ? c : []].sort((u, f) => u.timeStamp - f.timeStamp), o.coordinateSpace && (i.coordinateSpace = o.coordinateSpace);
+      const i = t[s], o = e[s];
+      let n = i.players.find((u) => u.type === "camera");
+      n || (n = { name: (l = o.name) != null ? l : "camera", type: "camera", keyframes: [] }, i.players.push(n)), n.keyframes = [...(c = o.keyframes) != null ? c : []].sort((u, f) => u.timeStamp - f.timeStamp), o.coordinateSpace && (n.coordinateSpace = o.coordinateSpace);
     });
     const r = this.cameraPlayerOf(this.state.currentChapter);
     r && this.playground.setCameraKeyframes(r.keyframes);
@@ -408,26 +461,26 @@ class $ {
    * 无任何可用模型几何（未加载/无 model player/包围盒空）时返回 undefined。
    */
   deriveChapterModelFramingView(e) {
-    var d, S, w;
+    var d, F, M;
     const t = this.getChapters();
     if (e < 0 || e >= t.length)
       return;
     const r = t[e], a = new T.Box3();
     let s = !1;
-    if (r.players.forEach((b) => {
-      var M, C, v, K;
-      if (b.type !== "model")
+    if (r.players.forEach((S) => {
+      var E, C, v, K;
+      if (S.type !== "model")
         return;
-      const F = b, P = (v = (C = (M = this.playground) == null ? void 0 : M.loader) == null ? void 0 : C.getDigitalHuman) == null ? void 0 : v.call(C, F.model, F.id), y = P == null ? void 0 : P.container;
+      const b = S, P = (v = (C = (E = this.playground) == null ? void 0 : E.loader) == null ? void 0 : C.getDigitalHuman) == null ? void 0 : v.call(C, b.model, b.id), y = P == null ? void 0 : P.container;
       if (!y)
         return;
       (K = y.updateWorldMatrix) == null || K.call(y, !0, !0);
-      const E = new T.Box3().setFromObject(y);
-      E.isEmpty() || (a.union(E), s = !0);
+      const w = new T.Box3().setFromObject(y);
+      w.isEmpty() || (a.union(w), s = !0);
     }), !s || a.isEmpty())
       return;
-    const n = a.getCenter(new T.Vector3()), o = a.getSize(new T.Vector3()).length(), i = (w = (S = (d = this.five).getCurrentState) == null ? void 0 : S.call(d)) != null ? w : {}, l = typeof i.longitude == "number" ? i.longitude : Math.PI / 4, c = typeof i.latitude == "number" ? i.latitude : Math.PI / 5, u = typeof i.fov == "number" && i.fov > 0 ? i.fov : 60, f = this.clamp(o * 2.5, 4, 14);
-    return { target: n, longitude: l, latitude: c, distance: f, fov: u };
+    const i = a.getCenter(new T.Vector3()), o = a.getSize(new T.Vector3()).length(), n = (M = (F = (d = this.five).getCurrentState) == null ? void 0 : F.call(d)) != null ? M : {}, 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, f = this.clamp(o * 2.5, 4, 14);
+    return { target: i, longitude: l, latitude: c, distance: f, fov: u };
   }
   /**
    * 设为当前编辑章节（不开始播放）。该次调用内联动完成：
@@ -448,7 +501,7 @@ class $ {
     return e ? {
       index: this.getCurrentChapterIndex(),
       name: e.name,
-      duration: L(e)
+      duration: I(e)
     } : { index: -1, name: "", duration: 0 };
   }
   /** 注册当前章节变更监听（current-chapter-changed）；返回反订阅函数 */
@@ -481,8 +534,8 @@ class $ {
       else if (s)
         s.keyframes = this.cloneKeyframes(r);
       else {
-        const n = { name: "camera", type: "camera", keyframes: this.cloneKeyframes(r) };
-        a.players.push(n);
+        const i = { name: "camera", type: "camera", keyframes: this.cloneKeyframes(r) };
+        a.players.push(i);
       }
     });
     const t = this.cameraPlayerOf(this.state.currentChapter);
@@ -492,9 +545,9 @@ class $ {
   getProgress() {
     const e = this.playground.getClock(), t = e.getTime();
     let r = e.getDuration();
-    r <= 0 && this.state.currentChapter && (r = A(this.state.currentChapter));
-    const a = this.getChapters(), s = this.state.currentChapter, n = s ? a.findIndex((o) => o === s || o.name === s.name) : -1;
-    return { currentTime: t, totalTime: r, currentChapterIndex: n, totalChapters: a.length };
+    r <= 0 && this.state.currentChapter && (r = N(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 };
   }
   /** 注册进度监听；返回反订阅函数 */
   onProgressChanged(e) {
@@ -516,8 +569,8 @@ class $ {
     const t = this.getChapters(), r = [];
     let a = 0;
     for (let s = 0; s < t.length; s++) {
-      const n = L(t[s]), o = a, i = o + n;
-      r.push({ index: s, name: t[s].name, startTime: o, endTime: i, duration: n }), a = i;
+      const i = I(t[s]), o = a, n = o + i;
+      r.push({ index: s, name: t[s].name, startTime: o, endTime: n, duration: i }), a = n;
     }
     return this.groupChapterTimeMapCache = r, this.groupChapterTimeMapCacheScript = e, r;
   }
@@ -532,14 +585,14 @@ class $ {
     const e = this.getProgress(), t = this.getGroupChapterTimeMap(), r = t.length === 0 ? 0 : t[t.length - 1].endTime, a = e.currentChapterIndex;
     let s = 0;
     if (a >= 0 && a < t.length) {
-      const o = t[a].startTime, i = this.clamp(e.currentTime, 0, t[a].duration);
-      s = this.clamp(o + i, 0, r);
+      const o = t[a].startTime, n = this.clamp(e.currentTime, 0, t[a].duration);
+      s = this.clamp(o + n, 0, r);
     }
-    const n = r > 0 ? this.clamp(s / r * 100, 0, 100) : 0;
+    const i = r > 0 ? this.clamp(s / r * 100, 0, 100) : 0;
     return {
       groupCurrentTime: s,
       groupTotalTime: r,
-      percentage: n,
+      percentage: i,
       currentChapterIndex: a,
       currentChapterTime: e.currentTime,
       currentChapterTotalTime: e.totalTime,
@@ -576,12 +629,12 @@ class $ {
     const t = this.getGroupChapterTimeMap();
     if (t.length === 0)
       return { success: !1, error: "无章节" };
-    const r = t[t.length - 1].endTime, a = this.clamp(e, 0, r), { index: s, localTime: n } = this.mapGroupTimeToChapter(a, t), o = s !== this.getCurrentChapterIndex();
+    const r = t[t.length - 1].endTime, a = this.clamp(e, 0, r), { index: s, localTime: i } = this.mapGroupTimeToChapter(a, t), o = s !== this.getCurrentChapterIndex();
     if (this.state.playing && this.state.continuousPlaying && o)
-      return this.seekRedirect = { index: s, fromTime: n }, this.playground.abortCurrentPlay(), { success: !0 };
-    o && this.setCurrentChapterForPlayback(s, n);
-    const i = this.setTimelineTo(n);
-    return this.emitProgress(), i;
+      return this.seekRedirect = { index: s, fromTime: i }, this.playground.abortCurrentPlay(), { success: !0 };
+    o && this.setCurrentChapterForPlayback(s, i);
+    const n = this.setTimelineTo(i);
+    return this.emitProgress(), n;
   }
   /** 跳转到组级百分比 [0,100]（= seekToGroupTime(clamp(pct,0,100)/100 * groupTotalTime)） */
   seekToGroupPercentage(e) {
@@ -622,28 +675,28 @@ class $ {
   }
   /** 重置播放（保留已加载资源） */
   reset() {
-    this.playground.reset(), this.state.playing = !1, this.state.continuousPlaying = !1, this.state.currentChapter = null, this.state.selectedShotIndex = null, this.seekRedirect = null, this.chapterFloorMap && (this.showModelFloor(), this.chapterFloorMap = null), this.emitProgress();
+    this.playground.reset(), this.state.playing = !1, this.state.continuousPlaying = !1, this.state.currentChapter = null, this.state.selectedShotIndex = null, this.seekRedirect = null, this.chapterFloorMap && (this.showModelFloor(), this.chapterFloorMap = null), this.chapterFloorModel = null, this.unhookFloorModeChange(), this.emitProgress();
   }
   /** 销毁插件、释放资源 */
   dispose() {
-    this.unsubClockTick && (this.unsubClockTick(), this.unsubClockTick = null), this.chapterFloorMap && (this.showModelFloor(), this.chapterFloorMap = null), this.progressListeners.clear(), this.keyframesChangedListeners.clear(), this.currentChapterChangedListeners.clear(), this.groupProgressListeners.clear(), this.cameraEditSnapshot = null, this.playground.dispose();
+    this.unsubClockTick && (this.unsubClockTick(), this.unsubClockTick = null), this.chapterFloorMap && (this.showModelFloor(), this.chapterFloorMap = null), this.chapterFloorModel = null, this.unhookFloorModeChange(), this.progressListeners.clear(), this.keyframesChangedListeners.clear(), this.currentChapterChangedListeners.clear(), this.groupProgressListeners.clear(), this.cameraEditSnapshot = null, this.playground.dispose();
   }
   /** 预加载模型 / 动画 / 道具（复用 Shared_Core 加载） */
   preloadResources(e) {
     return m(this, null, function* () {
-      const t = [], r = [], a = /* @__PURE__ */ new Set(), s = [], n = /* @__PURE__ */ new Map();
+      const t = [], r = [], a = /* @__PURE__ */ new Set(), s = [], i = /* @__PURE__ */ new Map();
       e.chapters.forEach((o) => {
-        o.players.forEach((i) => {
-          if (i.type !== "model")
+        o.players.forEach((n) => {
+          if (n.type !== "model")
             return;
-          const l = i;
-          t.push(l.model), r.push(i.id), l.keyframes.forEach((c) => {
+          const l = n;
+          t.push(l.model), r.push(n.id), l.keyframes.forEach((c) => {
             var f, d;
             if (!c.animation)
               return;
             a.add(c.animation.url);
             const u = c.animation.item;
-            u && (s.push(u.url), n.set(u.url, {
+            u && (s.push(u.url), i.set(u.url, {
               position: (f = u.position) != null ? f : [0, 0, 0],
               rotation: (d = u.rotation) != null ? d : [0, 0, 0]
             }));
@@ -651,7 +704,7 @@ class $ {
         });
       }), yield Promise.all([
         this.playground.loader.loadModels(t, r),
-        this.playground.loader.loadItems(s, n),
+        this.playground.loader.loadItems(s, i),
         this.playground.loader.loadAnimations(Array.from(a))
       ]);
     });
@@ -757,7 +810,7 @@ class $ {
     const r = this.cameraPlayerOf(t[e]);
     if (!r || r.keyframes.length === 0)
       return null;
-    const a = new O();
+    const a = new V();
     return a.setKeyframes(r.keyframes), a;
   }
   /** 深拷贝关键帧序列（数组字段亦深拷贝），供快照/还原使用（Mapview 位姿） */

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

@@ -72,6 +72,8 @@ export declare class PerformancePlayground {
     setTimelineTo(time: number): void;
     /** 运镜开关（透传到 CameraDirector，立即生效） */
     setCameraDirectionEnabled(enabled: boolean): void;
+    /** 运动轨迹线开关（默认关闭；透传到 loader，作用于全部 DigitalHuman） */
+    setTraceVisible(visible: boolean): void;
     /**
      * 加法式新增：立即将一个 CameraState 应用到 five（透传到 CameraDirector，复用其桥实例）。
      * 供 controller 的「章节默认视角」应用使用；不改变播放/时钟状态、不绑定轨道。

package/libs/DigitalPerformanceV2Plugin/core/Playground.js

@@ -34,7 +34,7 @@ function I(s) {
 function m(s, e, t) {
   return s < e ? e : s > t ? t : s;
 }
-class B {
+class V {
   constructor(e, t = !1) {
     /** 复用 Shared_Core 的加载与实例管理 */
     o(this, "loader");
@@ -145,6 +145,10 @@ class B {
   setCameraDirectionEnabled(e) {
     this.director.setEnabled(e);
   }
+  /** 运动轨迹线开关（默认关闭；透传到 loader，作用于全部 DigitalHuman） */
+  setTraceVisible(e) {
+    this.loader.setTraceVisible(e);
+  }
   /**
    * 加法式新增：立即将一个 CameraState 应用到 five（透传到 CameraDirector，复用其桥实例）。
    * 供 controller 的「章节默认视角」应用使用；不改变播放/时钟状态、不绑定轨道。
@@ -203,7 +207,7 @@ class B {
   }
 }
 export {
-  B as PerformancePlayground,
+  V as PerformancePlayground,
   d as getChapterDuration,
   I as getChapterModelDuration
 };

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

@@ -6,6 +6,8 @@ export interface DigitalPerformanceV2PluginConfig {
     loop?: boolean;
     /** 是否输出调试日志 */
     debug?: boolean;
+    /** 是否显示人物运动轨迹线（默认 false，不显示）。仅 debug / 特殊需求开启。 */
+    showTrace?: boolean;
 }
 /**
  * 关键帧到下一关键帧的过渡缓动

package/libs/base/BasePlugin.js

@@ -23,7 +23,7 @@ let I = class {
     /**
      * @realsee/dnalogel 版本号
      */
-    r(this, "VERSION", "3.81.0-alpha.3");
+    r(this, "VERSION", "3.81.0-alpha.5");
     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.0-alpha.3",
+    "%c %c@realsee/dnalogel %cv3.81.0-alpha.5",
     [
       "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.0-alpha.3",
+  "version": "3.81.0-alpha.5",
   "main": "./dist/index.js",
   "module": "./libs/index.js",
   "types": "./libs/index.d.ts",