@realsee/dnalogel 3.81.0-alpha.0 → 3.81.0-alpha.1

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

@@ -98,6 +98,14 @@ export default class DigitalPerformanceV2PluginController {
      * 播放态跨章 seek 时置位 { index, fromTime } 并 abortCurrentPlay；连播循环 await 返回后据此跳转到目标章节继续播放。
      */
     private seekRedirect;
+    /**
+     * 加法式：动画组「章节索引 → 楼层」映射（用于 Mapview 只显示当前章节所在楼层）。
+     * - number：该章节单一楼层 ⇒ `five.model.show(floor)`；
+     * - null：该章节内多段动画跨楼层 ⇒ `five.model.show()`（显示全部，避免藏掉其它层的动画）；
+     * - 映射缺项按显示全部处理。
+     * `null`（整体）表示未启用该能力（不触碰楼层可见性）。由消费方经 `setChapterFloorMap` 注入。
+     */
+    private chapterFloorMap;
     constructor(five: Five, config?: DigitalPerformanceV2PluginConfig);
     /** 加载剧本：预加载资源 + 将模型加入 five 场景；autoPlay 时自动播放首章 */
     loadScript(script: DigitalScript): Promise<void>;
@@ -149,6 +157,19 @@ export default class DigitalPerformanceV2PluginController {
     continueForEdit(): Promise<void>;
     /** 运镜开关：关闭后播放仅驱动模型动画，不接管 five 相机（立即生效） */
     setCameraDirectionEnabled(enabled: boolean): void;
+    /**
+     * 加法式：设置「章节索引 → 楼层」映射，启用「播放/切章时 Mapview 只显示当前章节所在楼层」。
+     * - number：该章节单一楼层；null：该章节内跨楼层 → 显示全部；映射缺项按显示全部处理。
+     * - 传入非 null：立即对当前章节应用一次；此后在任意章节切换（连播推进 / 切章 / 播放预览切章）时自动应用。
+     * - 传入 null：停用该能力（不再随章节应用），但**不主动恢复**楼层可见性（恢复由 `reset()` 负责）。
+     * 楼层可见性是 five 空间模型的显隐（`five.model.show`），与运镜相机接管相互独立。
+     * 各消费方（workshop 编辑端 / NextVR 展示端）自行从各自数据算好映射注入，保证两端行为一致（parity）。
+     */
+    setChapterFloorMap(map: Record<number, number | null> | null): void;
+    /** 按章节楼层映射对指定章节应用楼层可见性（映射未启用时 no-op） */
+    private applyChapterFloor;
+    /** 显示指定楼层（传 undefined 显示全部）。安全访问 five.model.show，避免类型/运行时缺失。 */
+    private showModelFloor;
     /**
      * seek 预览：跳转到指定时间并渲染当前帧（不改变播放/暂停状态）。
      * - 无当前章节：不改时钟、不渲染，返回失败指示且不抛异常。

package/libs/DigitalPerformanceV2Plugin/controller/index.js

@@ -1,33 +1,33 @@
 var k = Object.defineProperty;
 var C = Object.getOwnPropertySymbols;
 var S = Object.prototype.hasOwnProperty, w = Object.prototype.propertyIsEnumerable;
-var d = (u, e, t) => e in u ? k(u, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : u[e] = t, g = (u, e) => {
+var d = (l, e, t) => e in l ? k(l, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : l[e] = t, g = (l, e) => {
   for (var t in e || (e = {}))
-    S.call(e, t) && d(u, t, e[t]);
+    S.call(e, t) && d(l, t, e[t]);
   if (C)
     for (var t of C(e))
-      w.call(e, t) && d(u, t, e[t]);
-  return u;
+      w.call(e, t) && d(l, t, e[t]);
+  return l;
 };
-var h = (u, e, t) => (d(u, typeof e != "symbol" ? e + "" : e, t), t);
-var p = (u, e, t) => new Promise((r, a) => {
+var h = (l, e, t) => (d(l, typeof e != "symbol" ? e + "" : e, t), t);
+var c = (l, e, t) => new Promise((r, a) => {
   var s = (i) => {
     try {
       o(t.next(i));
-    } catch (l) {
-      a(l);
+    } catch (u) {
+      a(u);
     }
   }, n = (i) => {
     try {
       o(t.throw(i));
-    } catch (l) {
-      a(l);
+    } catch (u) {
+      a(u);
     }
   }, o = (i) => i.done ? r(i.value) : Promise.resolve(i.value).then(s, n);
-  o((t = t.apply(u, e)).next());
+  o((t = t.apply(l, e)).next());
 });
-import { PerformancePlayground as b, getChapterModelDuration as T, getChapterDuration as E } from "../core/Playground.js";
-import { CameraTrack as K } from "../core/CameraTrack.js";
+import { PerformancePlayground as F, getChapterModelDuration as T, getChapterDuration as b } from "../core/Playground.js";
+import { CameraTrack as E } from "../core/CameraTrack.js";
 import "three";
 import "../../DigitalPerformancePlugin/core/DigitalPlayground.js";
 import "@realsee/five/gltf-loader";
@@ -39,12 +39,12 @@ import "../core/PerformanceClock.js";
 import "../core/CameraDirector.js";
 import "../core/FiveModelCameraBridge.js";
 import "../core/CameraSampler.js";
-const v = "Dnalogel-DigitalPerformanceV2Plugin", P = "five-world";
+const M = "Dnalogel-DigitalPerformanceV2Plugin", P = "five-world";
 class B {
   constructor(e, t = {}) {
     h(this, "five");
     h(this, "config");
-    h(this, "NAME", v);
+    h(this, "NAME", M);
     h(this, "playground");
     h(this, "state", {
       enabled: !0,
@@ -76,12 +76,20 @@ class B {
      * 播放态跨章 seek 时置位 { index, fromTime } 并 abortCurrentPlay；连播循环 await 返回后据此跳转到目标章节继续播放。
      */
     h(this, "seekRedirect", null);
-    this.five = e, this.config = g({ autoPlay: !1, loop: !1, debug: !1 }, t), this.playground = new b(e, this.config.debug), this.unsubClockTick = this.playground.getClock().onTick(() => this.emitProgress());
+    /**
+     * 加法式：动画组「章节索引 → 楼层」映射（用于 Mapview 只显示当前章节所在楼层）。
+     * - number：该章节单一楼层 ⇒ `five.model.show(floor)`；
+     * - null：该章节内多段动画跨楼层 ⇒ `five.model.show()`（显示全部，避免藏掉其它层的动画）；
+     * - 映射缺项按显示全部处理。
+     * `null`（整体）表示未启用该能力（不触碰楼层可见性）。由消费方经 `setChapterFloorMap` 注入。
+     */
+    h(this, "chapterFloorMap", null);
+    this.five = e, this.config = g({ autoPlay: !1, loop: !1, debug: !1 }, t), this.playground = new F(e, this.config.debug), this.unsubClockTick = this.playground.getClock().onTick(() => this.emitProgress());
   }
   /** 加载剧本：预加载资源 + 将模型加入 five 场景；autoPlay 时自动播放首章 */
   loadScript(e) {
-    return p(this, null, function* () {
-      if (this.state.currentScript = e, this.playground.setScript(e), this.groupChapterTimeMapCache = null, this.groupChapterTimeMapCacheScript = null, yield this.preloadResources(e), this.five && this.five.scene) {
+    return c(this, null, function* () {
+      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) => {
@@ -99,8 +107,8 @@ class B {
   }
   /** 播放指定章节 */
   playChapter(e) {
-    return p(this, null, function* () {
-      this.state.currentChapter = e, this.state.continuousPlaying = !1, this.state.playing = !0;
+    return c(this, null, function* () {
+      this.state.currentChapter = e, this.applyChapterFloor(this.getCurrentChapterIndex()), this.state.continuousPlaying = !1, this.state.playing = !0;
       try {
         yield this.playground.playByChapter(e);
       } finally {
@@ -110,7 +118,7 @@ class B {
   }
   /** 通过索引播放章节 */
   playChapterByIndex(e) {
-    return p(this, null, function* () {
+    return c(this, null, function* () {
       const t = this.getChapters();
       if (e < 0 || e >= t.length)
         throw new Error("Invalid chapter index");
@@ -119,7 +127,7 @@ class B {
   }
   /** 从当前章节连续播放到最后一章（连播中跨章 seek 可经 seekRedirect 令牌无缝重定向） */
   playAllRemaining() {
-    return p(this, null, function* () {
+    return c(this, null, function* () {
       const e = this.getChapters();
       if (e.length === 0)
         throw new Error("No chapters to play");
@@ -132,7 +140,7 @@ class B {
       try {
         for (; t >= 0 && t < e.length && this.state.continuousPlaying; ) {
           let r = 0;
-          if (this.seekRedirect && this.seekRedirect.index === t && (r = this.seekRedirect.fromTime), this.seekRedirect = null, this.state.currentChapter = e[t], this.emitProgress(), yield this.playground.playByChapter(e[t], r), this.seekRedirect) {
+          if (this.seekRedirect && this.seekRedirect.index === t && (r = this.seekRedirect.fromTime), this.seekRedirect = null, this.state.currentChapter = e[t], this.applyChapterFloor(t), this.emitProgress(), yield this.playground.playByChapter(e[t], r), this.seekRedirect) {
             t = this.seekRedirect.index;
             continue;
           }
@@ -145,13 +153,13 @@ class B {
   }
   /** 从第一章开始按顺序连续播放（用于"重播全部"，保留已捕获的各章节运镜） */
   playAllFromStart() {
-    return p(this, null, function* () {
+    return c(this, null, function* () {
       yield this.playFromChapterIndex(0);
     });
   }
   /** 从指定章节索引开始，按顺序连续播放到本动画组最后一章（保留已捕获的各章节运镜） */
   playFromChapterIndex(e) {
-    return p(this, null, function* () {
+    return c(this, null, function* () {
       const t = this.getChapters();
       if (t.length === 0)
         throw new Error("No chapters to play");
@@ -166,7 +174,7 @@ class B {
    * 无当前章节时为 no-op。
    */
   playCurrentChapterForEdit() {
-    return p(this, null, function* () {
+    return c(this, null, function* () {
       const e = this.state.currentChapter;
       if (!e)
         return;
@@ -187,7 +195,7 @@ class B {
   }
   continue(e) {
     if (e != null && e.prepare)
-      return (() => p(this, null, function* () {
+      return (() => c(this, null, function* () {
         yield this.playground.prepareCameraTo(this.playground.getClock().getTime()), this.playground.resume(), this.state.playing = !0, this.emitProgress();
       }))();
     this.playground.resume(), this.state.playing = !0, this.emitProgress();
@@ -208,7 +216,7 @@ class B {
    * 章节无运镜关键帧时 prepare 为 no-op。不改变通用 `continue()`/`pause()` 语义。
    */
   continueForEdit() {
-    return p(this, null, function* () {
+    return c(this, null, function* () {
       yield this.playground.prepareCameraTo(this.playground.getClock().getTime()), this.playground.resume(), this.state.playing = !0, this.emitProgress();
     });
   }
@@ -216,6 +224,33 @@ class B {
   setCameraDirectionEnabled(e) {
     this.playground.setCameraDirectionEnabled(e);
   }
+  /**
+   * 加法式：设置「章节索引 → 楼层」映射，启用「播放/切章时 Mapview 只显示当前章节所在楼层」。
+   * - number：该章节单一楼层；null：该章节内跨楼层 → 显示全部；映射缺项按显示全部处理。
+   * - 传入非 null：立即对当前章节应用一次；此后在任意章节切换（连播推进 / 切章 / 播放预览切章）时自动应用。
+   * - 传入 null：停用该能力（不再随章节应用），但**不主动恢复**楼层可见性（恢复由 `reset()` 负责）。
+   * 楼层可见性是 five 空间模型的显隐（`five.model.show`），与运镜相机接管相互独立。
+   * 各消费方（workshop 编辑端 / NextVR 展示端）自行从各自数据算好映射注入，保证两端行为一致（parity）。
+   */
+  setChapterFloorMap(e) {
+    if (this.chapterFloorMap = e, e) {
+      const t = this.getCurrentChapterIndex();
+      this.applyChapterFloor(t >= 0 ? t : 0);
+    }
+  }
+  /** 按章节楼层映射对指定章节应用楼层可见性（映射未启用时 no-op） */
+  applyChapterFloor(e) {
+    if (!this.chapterFloorMap)
+      return;
+    const t = e in this.chapterFloorMap ? this.chapterFloorMap[e] : null;
+    this.showModelFloor(typeof t == "number" ? t : void 0);
+  }
+  /** 显示指定楼层（传 undefined 显示全部）。安全访问 five.model.show，避免类型/运行时缺失。 */
+  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);
+  }
   /**
    * seek 预览：跳转到指定时间并渲染当前帧（不改变播放/暂停状态）。
    * - 无当前章节：不改时钟、不渲染，返回失败指示且不抛异常。
@@ -245,8 +280,8 @@ class B {
       fov: o
     };
     r != null && r.transition && (i.transition = r.transition), r != null && r.thumbnail && (i.thumbnail = r.thumbnail);
-    const l = s.keyframes.findIndex((m) => m.timeStamp === e);
-    return l >= 0 ? s.keyframes[l] = i : s.keyframes.push(i), s.keyframes.sort((m, c) => m.timeStamp - c.timeStamp), this.afterKeyframesChanged(s);
+    const u = s.keyframes.findIndex((m) => m.timeStamp === e);
+    return u >= 0 ? s.keyframes[u] = i : s.keyframes.push(i), s.keyframes.sort((m, p) => m.timeStamp - p.timeStamp), this.afterKeyframesChanged(s);
   }
   /**
    * 更新指定下标关键帧：合并 patch 中出现的字段，按 timeStamp 重排序。
@@ -328,13 +363,13 @@ class B {
   loadCameraPlayersByChapterIndex(e) {
     const t = this.getChapters();
     Object.keys(e).forEach((a) => {
-      var l, m;
+      var u, m;
       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((c) => c.type === "camera");
-      i || (i = { name: (l = o.name) != null ? l : "camera", type: "camera", keyframes: [] }, n.players.push(i)), i.keyframes = [...(m = o.keyframes) != null ? m : []].sort((c, f) => c.timeStamp - f.timeStamp), o.coordinateSpace && (i.coordinateSpace = o.coordinateSpace);
+      let i = n.players.find((p) => p.type === "camera");
+      i || (i = { name: (u = o.name) != null ? u : "camera", type: "camera", keyframes: [] }, n.players.push(i)), i.keyframes = [...(m = o.keyframes) != null ? m : []].sort((p, f) => p.timeStamp - f.timeStamp), o.coordinateSpace && (i.coordinateSpace = o.coordinateSpace);
     });
     const r = this.cameraPlayerOf(this.state.currentChapter);
     r && this.playground.setCameraKeyframes(r.keyframes);
@@ -375,7 +410,7 @@ class B {
     if (e < 0 || e >= t.length)
       return;
     const r = t[e];
-    this.playground.pause(), this.state.playing = !1, this.state.currentChapter = r, this.playground.prepareChapter(r, 0), this.applyChapterDefaultView(e), this.state.selectedShotIndex = null, this.emitProgress(), this.emitCurrentChapterChanged();
+    this.playground.pause(), this.state.playing = !1, this.state.currentChapter = r, this.playground.prepareChapter(r, 0), this.applyChapterFloor(e), this.applyChapterDefaultView(e), this.state.selectedShotIndex = null, this.emitProgress(), this.emitCurrentChapterChanged();
   }
   /** 当前章节信息：{ index, name, duration }；duration 为该章节模型动画时长（排除相机 player） */
   getCurrentChapterInfo() {
@@ -427,7 +462,7 @@ class B {
   getProgress() {
     const e = this.playground.getClock(), t = e.getTime();
     let r = e.getDuration();
-    r <= 0 && this.state.currentChapter && (r = E(this.state.currentChapter));
+    r <= 0 && this.state.currentChapter && (r = b(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 };
   }
@@ -495,7 +530,7 @@ class B {
    */
   setCurrentChapterForPlayback(e, t) {
     const r = this.getChapters();
-    e < 0 || e >= r.length || (this.state.currentChapter = r[e], this.playground.prepareChapter(r[e], t));
+    e < 0 || e >= r.length || (this.state.currentChapter = r[e], this.applyChapterFloor(e), this.playground.prepareChapter(r[e], t));
   }
   /**
    * 跳转到组级时间(ms)：映射为 (章节 index, 章节内时间)，必要时切章后 setTimelineTo。
@@ -557,30 +592,30 @@ class B {
   }
   /** 重置播放（保留已加载资源） */
   reset() {
-    this.playground.reset(), this.state.playing = !1, this.state.continuousPlaying = !1, this.state.currentChapter = null, this.state.selectedShotIndex = null, this.seekRedirect = 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.emitProgress();
   }
   /** 销毁插件、释放资源 */
   dispose() {
-    this.unsubClockTick && (this.unsubClockTick(), this.unsubClockTick = 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.progressListeners.clear(), this.keyframesChangedListeners.clear(), this.currentChapterChangedListeners.clear(), this.groupProgressListeners.clear(), this.cameraEditSnapshot = null, this.playground.dispose();
   }
   /** 预加载模型 / 动画 / 道具（复用 Shared_Core 加载） */
   preloadResources(e) {
-    return p(this, null, function* () {
+    return c(this, null, function* () {
       const t = [], r = [], a = /* @__PURE__ */ new Set(), s = [], n = /* @__PURE__ */ new Map();
       e.chapters.forEach((o) => {
         o.players.forEach((i) => {
           if (i.type !== "model")
             return;
-          const l = i;
-          t.push(l.model), r.push(i.id), l.keyframes.forEach((m) => {
+          const u = i;
+          t.push(u.model), r.push(i.id), u.keyframes.forEach((m) => {
             var f, y;
             if (!m.animation)
               return;
             a.add(m.animation.url);
-            const c = m.animation.item;
-            c && (s.push(c.url), n.set(c.url, {
-              position: (f = c.position) != null ? f : [0, 0, 0],
-              rotation: (y = c.rotation) != null ? y : [0, 0, 0]
+            const p = m.animation.item;
+            p && (s.push(p.url), n.set(p.url, {
+              position: (f = p.position) != null ? f : [0, 0, 0],
+              rotation: (y = p.rotation) != null ? y : [0, 0, 0]
             }));
           });
         });
@@ -692,7 +727,7 @@ class B {
     const r = this.cameraPlayerOf(t[e]);
     if (!r || r.keyframes.length === 0)
       return null;
-    const a = new K();
+    const a = new E();
     return a.setKeyframes(r.keyframes), a;
   }
   /** 深拷贝关键帧序列（数组字段亦深拷贝），供快照/还原使用（Mapview 位姿） */

package/libs/base/BasePlugin.js

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