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

package/dist/DigitalPerformancePlugin/core/DigitalHuman.d.ts

@@ -20,6 +20,11 @@ export declare class DigitalHuman {
     effectsGroup: THREE.Group;
     effectObjects: Map<string, THREE.Mesh>;
     container: THREE.Group;
+    /**
+     * 运动轨迹线（curveLine）开关。默认关闭、不绘制、不显示。
+     * 仅 debug / 特殊需求时由业务经插件显式开启（见 setTraceVisible）。
+     */
+    showTrace: boolean;
     private mixer;
     private action;
     private itemMatrixMap;
@@ -34,6 +39,18 @@ export declare class DigitalHuman {
         repeat: boolean;
         switchDuration: number;
     }): void;
+    /**
+     * seek/预览专用：立即「硬切」到目标动画（无 crossfade）。
+     *
+     * 背景：`playAnimation` 走 `crossFadeFrom(oldAction, switchDuration, true)` 做平滑过渡，依赖后续帧以
+     * 正的 delta 推进权重淡入淡出。但 seek/定格帧（delta===0）只做一次 `mixer.update(0)`，零时长的
+     * crossfade 不会推进——新动作权重可能仍≈0、旧动作权重仍≈1，且旧动作的 `stop()` 被 `setTimeout(…,0)`
+     * 推迟到本帧渲染之后执行。结果：跨动画 seek（如章节末「躺」姿回到起始帧「跑」）时旧姿态残留，
+     * 而位置/旋转因是直接拷贝关键帧的、已正确。
+     *
+     * 这里同步停旧动作、把新动作权重直接置 1，保证随后的 `mixer.update(0)` 立即定格到目标姿态。
+     */
+    private switchAnimationImmediately;
     pauseAnimation(): void;
     stopAnimation(): void;
     continueAnimation(): void;
@@ -62,6 +79,12 @@ export declare class DigitalHuman {
      * @param delta 距上一帧的时间增量(ms)，用于推进骨骼动画 mixer
      */
     renderAtTime(time: number, delta: number): void;
+    /**
+     * 运动轨迹线开关（默认关闭、不显示）。仅 debug / 特殊需求由业务显式开启。
+     * - 开启：显示 curveLine，并回填当前时间点之前的轨迹（此后每帧继续累积）。
+     * - 关闭：隐藏并清空轨迹几何。
+     */
+    setTraceVisible(visible: boolean): void;
     traceUpDate(): void;
     clearTrace(): void;
     clearProcessedNeedRenderKeyframeIndices(): void;

package/dist/DigitalPerformancePlugin/core/DigitalPlayground.d.ts

@@ -10,6 +10,8 @@ export declare class DigitalPlayground {
     private digitalItemMap;
     private skeletalAnimationMap;
     private debugMode;
+    /** 运动轨迹线开关（默认关闭）。应用到已加载及后续加载的所有 DigitalHuman。 */
+    private showTrace;
     constructor(debugMode?: boolean);
     setScript(script: DigitalScript): void;
     loadModel(url: string, id?: string): Promise<DigitalHuman>;
@@ -32,6 +34,11 @@ export declare class DigitalPlayground {
     continue(): void;
     reset(): void;
     setTimelineTo(time: number): void;
+    /**
+     * 运动轨迹线开关（默认关闭）。作用于当前所有 DigitalHuman，并记忆给后续加载的模型。
+     * 仅 debug / 特殊需求由业务经插件显式开启。
+     */
+    setTraceVisible(visible: boolean): void;
     /**
      * 销毁 playground
      */

package/dist/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 预览：跳转到指定时间并渲染当前帧（不改变播放/暂停状态）。

package/dist/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/dist/DigitalPerformanceV2Plugin/typings/index.d.ts

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