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

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

@@ -220,18 +220,28 @@ export default class DigitalPerformanceV2PluginController {
     /** 注册关键帧序列变更监听（camera-keyframes-changed）；返回反订阅函数 */
     onCameraKeyframesChanged(listener: CameraKeyframesChangedListener): () => void;
     /**
-     * 章节默认视角（Chapter_Default_View）。
+     * 章节默认视角（Chapter_Default_View）。始终为 **Mapview orbit** 视角（与运镜编辑「仅 Mapview」一致）。
      * - 章节存在 ≥1 个运镜关键帧：返回该章节相机轨道 `sample(0)`（因首帧夹紧，等于首帧 CameraState）。
-     * - 章节存在 0 个运镜关键帧：返回 `undefined`。
-     * 默认视角不单独持久化，完全由关键帧派生（不在 cameraPlayers 新增字段）。
+     * - 章节存在 0 个运镜关键帧：几何派生一个「frame 该章节模型 t=0」的 Mapview orbit
+     *   （target=模型世界包围盒中心，distance 由包围盒尺寸派生，orbit 朝向沿用 five 当前角度以避免跳变）。
+     *   无可用模型几何时返回 `undefined`（调用方 no-op、保持当前视角）。
+     * 默认视角不单独持久化，完全派生（关键帧 / 模型几何），不在 cameraPlayers 新增字段。
      */
     getChapterDefaultView(chapterIndex: number): CameraState | undefined;
     /**
      * 应用章节默认视角到 five。
      * - 章节存在关键帧：经 FiveModelCameraBridge 立即应用 `sample(0)`。
-     * - 章节存在 0 个关键帧：no-op（保持当前 five 相机状态、不强制移动）。
+     * - 章节 0 关键帧：应用几何派生的 Mapview orbit（frame 本章节模型）；无可用几何时 no-op。
      */
     applyChapterDefaultView(chapterIndex: number): void;
+    /**
+     * 无运镜章节的默认视角：几何派生一个「frame 该章节模型 t=0」的 Mapview orbit CameraState。
+     * - target = 章节内所有 model player 容器的世界包围盒中心（需先 prepareChapter 将模型渲染到 t=0）。
+     * - distance = 包围盒对角线 × 系数，钳制到 [MIN, MAX]（保证不过近/过远）。
+     * - orbit 朝向（longitude/latitude/fov）沿用 five 当前状态，避免切章时视角朝向突跳；缺省用兜底值。
+     * 无任何可用模型几何（未加载/无 model player/包围盒空）时返回 undefined。
+     */
+    private deriveChapterModelFramingView;
     /**
      * 设为当前编辑章节（不开始播放）。该次调用内联动完成：
      * 切暂停 → `seek(0)`（进度归零、各 DigitalHuman 渲染 t=0）→ 重建 director 轨道到该章节关键帧 →

package/libs/DigitalPerformanceV2Plugin/controller/index.js

@@ -1,34 +1,34 @@
-var k = Object.defineProperty;
-var C = Object.getOwnPropertySymbols;
-var S = Object.prototype.hasOwnProperty, w = Object.prototype.propertyIsEnumerable;
-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) => {
+var R = Object.defineProperty;
+var x = Object.getOwnPropertySymbols;
+var D = Object.prototype.hasOwnProperty, G = Object.prototype.propertyIsEnumerable;
+var k = (p, e, t) => e in p ? R(p, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : p[e] = t, g = (p, e) => {
   for (var t in e || (e = {}))
-    S.call(e, t) && d(l, t, e[t]);
-  if (C)
-    for (var t of C(e))
-      w.call(e, t) && d(l, t, e[t]);
-  return l;
+    D.call(e, t) && k(p, t, e[t]);
+  if (x)
+    for (var t of x(e))
+      G.call(e, t) && k(p, t, e[t]);
+  return p;
 };
-var h = (l, e, t) => (d(l, typeof e != "symbol" ? e + "" : e, t), t);
-var c = (l, e, t) => new Promise((r, a) => {
+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) => {
     try {
       o(t.next(i));
-    } catch (u) {
-      a(u);
+    } catch (l) {
+      a(l);
     }
   }, n = (i) => {
     try {
       o(t.throw(i));
-    } catch (u) {
-      a(u);
+    } catch (l) {
+      a(l);
     }
   }, o = (i) => i.done ? r(i.value) : Promise.resolve(i.value).then(s, n);
-  o((t = t.apply(l, e)).next());
+  o((t = t.apply(p, e)).next());
 });
-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 * 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 "../../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 M = "Dnalogel-DigitalPerformanceV2Plugin", P = "five-world";
-class B {
+const V = "Dnalogel-DigitalPerformanceV2Plugin", I = "five-world";
+class $ {
   constructor(e, t = {}) {
     h(this, "five");
     h(this, "config");
-    h(this, "NAME", M);
+    h(this, "NAME", V);
     h(this, "playground");
     h(this, "state", {
       enabled: !0,
@@ -84,11 +84,11 @@ class B {
      * `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());
+    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());
   }
   /** 加载剧本：预加载资源 + 将模型加入 five 场景；autoPlay 时自动播放首章 */
   loadScript(e) {
-    return c(this, null, function* () {
+    return m(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;
@@ -107,7 +107,7 @@ class B {
   }
   /** 播放指定章节 */
   playChapter(e) {
-    return c(this, null, function* () {
+    return m(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);
@@ -118,7 +118,7 @@ class B {
   }
   /** 通过索引播放章节 */
   playChapterByIndex(e) {
-    return c(this, null, function* () {
+    return m(this, null, function* () {
       const t = this.getChapters();
       if (e < 0 || e >= t.length)
         throw new Error("Invalid chapter index");
@@ -127,7 +127,7 @@ class B {
   }
   /** 从当前章节连续播放到最后一章（连播中跨章 seek 可经 seekRedirect 令牌无缝重定向） */
   playAllRemaining() {
-    return c(this, null, function* () {
+    return m(this, null, function* () {
       const e = this.getChapters();
       if (e.length === 0)
         throw new Error("No chapters to play");
@@ -153,13 +153,13 @@ class B {
   }
   /** 从第一章开始按顺序连续播放（用于"重播全部"，保留已捕获的各章节运镜） */
   playAllFromStart() {
-    return c(this, null, function* () {
+    return m(this, null, function* () {
       yield this.playFromChapterIndex(0);
     });
   }
   /** 从指定章节索引开始，按顺序连续播放到本动画组最后一章（保留已捕获的各章节运镜） */
   playFromChapterIndex(e) {
-    return c(this, null, function* () {
+    return m(this, null, function* () {
       const t = this.getChapters();
       if (t.length === 0)
         throw new Error("No chapters to play");
@@ -174,7 +174,7 @@ class B {
    * 无当前章节时为 no-op。
    */
   playCurrentChapterForEdit() {
-    return c(this, null, function* () {
+    return m(this, null, function* () {
       const e = this.state.currentChapter;
       if (!e)
         return;
@@ -195,7 +195,7 @@ class B {
   }
   continue(e) {
     if (e != null && e.prepare)
-      return (() => c(this, null, function* () {
+      return (() => m(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();
@@ -216,7 +216,7 @@ class B {
    * 章节无运镜关键帧时 prepare 为 no-op。不改变通用 `continue()`/`pause()` 语义。
    */
   continueForEdit() {
-    return c(this, null, function* () {
+    return m(this, null, function* () {
       yield this.playground.prepareCameraTo(this.playground.getClock().getTime()), this.playground.resume(), this.state.playing = !0, this.emitProgress();
     });
   }
@@ -280,8 +280,8 @@ class B {
       fov: o
     };
     r != null && r.transition && (i.transition = r.transition), r != null && r.thumbnail && (i.thumbnail = r.thumbnail);
-    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);
+    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);
   }
   /**
    * 更新指定下标关键帧：合并 patch 中出现的字段，按 timeStamp 重排序。
@@ -330,7 +330,7 @@ class B {
         name: (t = e == null ? void 0 : e.name) != null ? t : "camera",
         type: "camera",
         keyframes: this.serializeKeyframes(e),
-        coordinateSpace: P
+        coordinateSpace: I
       }
     };
   }
@@ -351,7 +351,7 @@ class B {
           name: (s = a.name) != null ? s : "camera",
           type: "camera",
           keyframes: this.serializeKeyframes(a),
-          coordinateSpace: P
+          coordinateSpace: I
         }
       });
     }), e;
@@ -363,13 +363,13 @@ class B {
   loadCameraPlayersByChapterIndex(e) {
     const t = this.getChapters();
     Object.keys(e).forEach((a) => {
-      var u, m;
+      var l, c;
       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((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);
+      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 r = this.cameraPlayerOf(this.state.currentChapter);
     r && this.playground.setCameraKeyframes(r.keyframes);
@@ -380,25 +380,55 @@ class B {
   }
   // —— 编辑端加法式新增能力（Requirement 18 / design Part III §7）——
   /**
-   * 章节默认视角（Chapter_Default_View）。
+   * 章节默认视角（Chapter_Default_View）。始终为 **Mapview orbit** 视角（与运镜编辑「仅 Mapview」一致）。
    * - 章节存在 ≥1 个运镜关键帧：返回该章节相机轨道 `sample(0)`（因首帧夹紧，等于首帧 CameraState）。
-   * - 章节存在 0 个运镜关键帧：返回 `undefined`。
-   * 默认视角不单独持久化，完全由关键帧派生（不在 cameraPlayers 新增字段）。
+   * - 章节存在 0 个运镜关键帧：几何派生一个「frame 该章节模型 t=0」的 Mapview orbit
+   *   （target=模型世界包围盒中心，distance 由包围盒尺寸派生，orbit 朝向沿用 five 当前角度以避免跳变）。
+   *   无可用模型几何时返回 `undefined`（调用方 no-op、保持当前视角）。
+   * 默认视角不单独持久化，完全派生（关键帧 / 模型几何），不在 cameraPlayers 新增字段。
    */
   getChapterDefaultView(e) {
     const t = this.buildChapterCameraTrack(e);
-    if (!(!t || !t.hasContent()))
-      return t.sample(0);
+    return t && t.hasContent() ? t.sample(0) : this.deriveChapterModelFramingView(e);
   }
   /**
    * 应用章节默认视角到 five。
    * - 章节存在关键帧：经 FiveModelCameraBridge 立即应用 `sample(0)`。
-   * - 章节存在 0 个关键帧：no-op（保持当前 five 相机状态、不强制移动）。
+   * - 章节 0 关键帧：应用几何派生的 Mapview orbit（frame 本章节模型）；无可用几何时 no-op。
    */
   applyChapterDefaultView(e) {
     const t = this.getChapterDefaultView(e);
     t && this.playground.applyCameraStateImmediately(t);
   }
+  /**
+   * 无运镜章节的默认视角：几何派生一个「frame 该章节模型 t=0」的 Mapview orbit CameraState。
+   * - target = 章节内所有 model player 容器的世界包围盒中心（需先 prepareChapter 将模型渲染到 t=0）。
+   * - distance = 包围盒对角线 × 系数，钳制到 [MIN, MAX]（保证不过近/过远）。
+   * - orbit 朝向（longitude/latitude/fov）沿用 five 当前状态，避免切章时视角朝向突跳；缺省用兜底值。
+   * 无任何可用模型几何（未加载/无 model player/包围盒空）时返回 undefined。
+   */
+  deriveChapterModelFramingView(e) {
+    var d, S, w;
+    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")
+        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;
+      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);
+    }), !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 };
+  }
   /**
    * 设为当前编辑章节（不开始播放）。该次调用内联动完成：
    * 切暂停 → `seek(0)`（进度归零、各 DigitalHuman 渲染 t=0）→ 重建 director 轨道到该章节关键帧 →
@@ -418,7 +448,7 @@ class B {
     return e ? {
       index: this.getCurrentChapterIndex(),
       name: e.name,
-      duration: T(e)
+      duration: L(e)
     } : { index: -1, name: "", duration: 0 };
   }
   /** 注册当前章节变更监听（current-chapter-changed）；返回反订阅函数 */
@@ -462,7 +492,7 @@ class B {
   getProgress() {
     const e = this.playground.getClock(), t = e.getTime();
     let r = e.getDuration();
-    r <= 0 && this.state.currentChapter && (r = b(this.state.currentChapter));
+    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 };
   }
@@ -486,7 +516,7 @@ class B {
     const t = this.getChapters(), r = [];
     let a = 0;
     for (let s = 0; s < t.length; s++) {
-      const n = T(t[s]), o = a, i = o + n;
+      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;
     }
     return this.groupChapterTimeMapCache = r, this.groupChapterTimeMapCacheScript = e, r;
@@ -600,22 +630,22 @@ class B {
   }
   /** 预加载模型 / 动画 / 道具（复用 Shared_Core 加载） */
   preloadResources(e) {
-    return c(this, null, function* () {
+    return m(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 u = i;
-          t.push(u.model), r.push(i.id), u.keyframes.forEach((m) => {
-            var f, y;
-            if (!m.animation)
+          const l = i;
+          t.push(l.model), r.push(i.id), l.keyframes.forEach((c) => {
+            var f, d;
+            if (!c.animation)
               return;
-            a.add(m.animation.url);
-            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]
+            a.add(c.animation.url);
+            const u = c.animation.item;
+            u && (s.push(u.url), n.set(u.url, {
+              position: (f = u.position) != null ? f : [0, 0, 0],
+              rotation: (d = u.rotation) != null ? d : [0, 0, 0]
             }));
           });
         });
@@ -727,7 +757,7 @@ class B {
     const r = this.cameraPlayerOf(t[e]);
     if (!r || r.keyframes.length === 0)
       return null;
-    const a = new E();
+    const a = new O();
     return a.setKeyframes(r.keyframes), a;
   }
   /** 深拷贝关键帧序列（数组字段亦深拷贝），供快照/还原使用（Mapview 位姿） */
@@ -746,5 +776,5 @@ class B {
   }
 }
 export {
-  B as default
+  $ as default
 };

package/libs/DigitalPerformanceV2Plugin/index.js

@@ -1,7 +1,7 @@
 import { default as D } from "./controller/index.js";
 import { DigitalPerformanceV2Plugin as d, DigitalPerformanceV2Plugin as s } from "./index/index.js";
-import "./core/Playground.js";
 import "three";
+import "./core/Playground.js";
 import "../DigitalPerformancePlugin/core/DigitalPlayground.js";
 import "@realsee/five/gltf-loader";
 import "../DigitalPerformancePlugin/core/DigitalHuman.js";

package/libs/base/BasePlugin.js

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