vrtalk-web-sdk 0.1.592 → 0.1.594

package/dist/src/index.d.ts

@@ -8,3 +8,4 @@ export { migrateXrMonitorMultiScene } from './utils/xr-monitor-multi-scene-migra
 export { buildExpressionFromTree, extractConditionTreeDependencies, EXPRESSION_FUNC_NAME, type ConditionFunctionDependency, type ConditionFunctionDepSpec, type ConditionTreeDependencies, } from './utils/xr-condition-tree-builder';
 export { pickMultiLanguageStr, normalizeMultiLanguageStr, createMultiLanguageStr, normalizeBrowserLanguage, pickCurrentLanguage, } from './utils/multi-language-str-util';
 export { computeProgressBarFillStyle, PROGRESS_BAR_KEYFRAMES_CSS, type ProgressBarFillOptions, } from './utils/progress-bar-style';
+export { generatePathKeyframes, samplePathDesign, buildKeyframesFromSampling, suggestedPlayCompleteProcessType, simplifyPathPoints, type PathGroundSnapFn, type PathSample, type PathSamplingResult, type PathGenerateStats, type PathGenerateResult, } from './utils/path-keyframe-generator';

package/dist/src/model/vr/vr-content-data.d.ts

@@ -63,18 +63,9 @@ export declare class VrIntroduceItem {
     title: string;
     description: string;
 }
-export declare class ArMultisetSettings {
-    mapCode: string;
-    isSingleFrame: boolean;
-    frameCount: number;
-    frameInterval: number;
-    enableBlurCheck: boolean;
-    confidenceThreshold: number;
-    backgroundCorrectionInterval: number;
-}
 /**
- * AR 通用设置（与定位方式无关，定位成功后的渲染/加载控制；MSAR / Vuforia / PositionX 共用）。
- * 这些是「定位之后」的事，独立于具体定位算法，故从 ArMultisetSettings 抽出单独成组。
+ * AR 通用设置（与定位方式无关，定位成功后的渲染/加载控制；Vuforia / PositionX 共用）。
+ * 这些是「定位之后」的事，独立于具体定位算法。
  */
 export declare class ArCommonSettings {
     nearDistanceMax: number;
@@ -179,7 +170,6 @@ export declare class VrContentData {
     vrPlayerUiSettings: VrPlayerUiSettings;
     hamburgerMenu: XrHamburgerMenu;
     vrInfoTemplateSettings: VrInfoTemplateSettings;
-    arMultisetSettings: ArMultisetSettings;
     arCommonSettings: ArCommonSettings;
     arPositionXSettings: ArPositionXSettings;
     vrRenderSettings: VrRenderSettings;

package/dist/src/model/vr-component/index.d.ts

@@ -7,3 +7,4 @@ export * from './vr-component-3d-box-data';
 export * from './vr-component-3d-model-data';
 export * from './vr-component-data';
 export * from './vr-component-tag-data';
+export * from './vr-path-design';

package/dist/src/model/vr-component/vr-component-data.d.ts

@@ -5,6 +5,7 @@ import { VrComponentAudioSource } from '../vr';
 import { VRTalkBaseData } from '../general/vrtalk-base-data';
 import { MultiLanguageStr } from '../general';
 import { XrVariable } from '../vr/xr-logic';
+import { VrTransitionAnimationPathDesign } from './vr-path-design';
 /**
  * VR组件类型
  */
@@ -148,6 +149,7 @@ export declare class VrComponentTransitionAnimation {
     description: string;
     playCompleteProcessType: VrComponentTransitionAnimationPlayCompleteProcessType;
     keyFrameList: VrComponentTransitionAnimationKeyframe[];
+    pathDesign: VrTransitionAnimationPathDesign | null;
 }
 /**
  * 组件过渡动画关键帧

package/dist/src/model/vr-component/vr-path-design.d.ts

@@ -0,0 +1,92 @@
+import { Vector3 } from '../general/vector';
+/**
+ * 路径设计模式：贴地 / 空中
+ */
+export declare type VrPathDesignMode = 'ground' | 'air';
+export declare class VrPathDesignModeDefine {
+    static readonly GROUND: VrPathDesignMode;
+    static readonly AIR: VrPathDesignMode;
+}
+/**
+ * 沿路径的朝向模式
+ */
+export declare type VrPathOrientMode = 'yaw' | 'full' | 'none';
+export declare class VrPathOrientModeDefine {
+    static readonly YAW: VrPathOrientMode;
+    static readonly FULL: VrPathOrientMode;
+    static readonly NONE: VrPathOrientMode;
+}
+/**
+ * 往返模式
+ */
+export declare type VrPathRoundTrip = 'none' | 'back-once' | 'back-loop';
+export declare class VrPathRoundTripDefine {
+    static readonly NONE: VrPathRoundTrip;
+    static readonly BACK_ONCE: VrPathRoundTrip;
+    static readonly BACK_LOOP: VrPathRoundTrip;
+}
+/**
+ * 路径平滑方式
+ */
+export declare type VrPathSmoothing = 'linear' | 'smooth';
+export declare class VrPathSmoothingDefine {
+    static readonly LINEAR: VrPathSmoothing;
+    static readonly SMOOTH: VrPathSmoothing;
+}
+/**
+ * 路径起播方式
+ */
+export declare type VrPathStartMode = 'teleport' | 'walk-in';
+export declare class VrPathStartModeDefine {
+    static readonly TELEPORT: VrPathStartMode;
+    static readonly WALK_IN: VrPathStartMode;
+}
+/**
+ * 路径设计模式下的 3D 交互工具
+ * add=点击放点；select=点选/拖动已有点；pick-start/pick-end=为 PositionX 导航拾取起/终点
+ */
+export declare type VrPathDesignTool = 'add' | 'select' | 'pick-start' | 'pick-end';
+/**
+ * 路径设计模式下的观察视角
+ * inside=全景漫游；dollhouse=鸟瞰模型；floorplan=正交平面图
+ */
+export declare type VrPathDesignView = 'inside' | 'dollhouse' | 'floorplan';
+/**
+ * 路径设计点（控制点）
+ */
+export declare class VrPathDesignPoint {
+    id: string;
+    position: Vector3;
+    hoverMs: number;
+    speedOverrideMps: number | null;
+}
+/**
+ * 路径设计草稿的 PositionX 导航来源参数（便于一键重算）
+ */
+export declare class VrPathDesignPositionXSource {
+    planId: string;
+    start: Vector3;
+    end: Vector3;
+}
+/**
+ * 过渡动画的路径设计草稿
+ * 仅编辑器（vrtalk-console + player 编辑模式）读写；player 运行时完全不读此字段。
+ * 生成关键帧是显式单向烘焙：keyFrameList 被整体替换，本草稿保留以便再次修改/重新生成。
+ */
+export declare class VrTransitionAnimationPathDesign {
+    mode: VrPathDesignMode;
+    source: 'manual' | 'positionx';
+    points: VrPathDesignPoint[];
+    speedMps: number;
+    orientMode: VrPathOrientMode;
+    forwardYawOffsetDeg: number;
+    autoGroundOffset: boolean;
+    groundOffset: number;
+    smoothing: VrPathSmoothing;
+    sampleStepM: number;
+    closed: boolean;
+    roundTrip: VrPathRoundTrip;
+    turnDurationMs: number;
+    startMode: VrPathStartMode;
+    positionx: VrPathDesignPositionXSource | null;
+}

package/dist/src/parent/com-command/index.d.ts

@@ -27,3 +27,4 @@ export * from './parent-com-command-monitor';
 export * from './parent-com-command-message-card';
 export * from './parent-com-command-dolly-path';
 export * from './parent-com-command-hamburger-menu';
+export * from './parent-com-command-path-design';

package/dist/src/parent/com-command/parent-com-command-path-design.d.ts

@@ -0,0 +1,65 @@
+import { VrPathDesignTool, VrPathDesignView, VrTransitionAnimationPathDesign } from '../../model';
+import { VRTalkEditablePlayer } from '../vrtalk-editable-player';
+/**
+ * 向播放器发送过渡动画路径设计相关命令
+ */
+export declare class ParentComCommandPathDesign {
+    private player;
+    constructor(player: VRTalkEditablePlayer);
+    /**
+     * 进入路径设计模式（player 进入后自动回传 PATH_DESIGN_BOUNDS 包围盒信息）
+     * @param componentId 被编辑的组件id
+     * @param animationId 被编辑的过渡动画id
+     * @param pathDesign 路径设计草稿
+     */
+    enter(componentId: string, animationId: string, pathDesign: VrTransitionAnimationPathDesign): void;
+    /**
+     * 退出路径设计模式（还原组件姿态与视角）
+     */
+    exit(): void;
+    /**
+     * 草稿更新（参数或点位变化后整体推送，player 重绘路径并回传最新统计）
+     * @param pathDesign 路径设计草稿
+     * @param resnapPoints 是否对所有控制点重新贴地（PositionX 导入 / 撤销重做后使用）
+     */
+    update(pathDesign: VrTransitionAnimationPathDesign, resnapPoints?: boolean): void;
+    /**
+     * 切换 3D 交互工具
+     */
+    setTool(tool: VrPathDesignTool): void;
+    /**
+     * 切换观察视角（全景漫游/鸟瞰/平面图）
+     */
+    setView(view: VrPathDesignView): void;
+    /**
+     * 选中/取消选中路径点
+     * @param pointId 点id，null=取消选中
+     */
+    selectPoint(pointId: string | null): void;
+    /**
+     * 预览进度拖拽（player 把组件本体摆到路径对应位置与姿态）
+     * @param progress 0~1
+     */
+    scrub(progress: number): void;
+    /**
+     * 试播（player 内部烘临时关键帧走真实播放链路）
+     */
+    previewPlay(): void;
+    /**
+     * 停止试播（还原组件姿态）
+     */
+    previewStop(): void;
+    /**
+     * 生成关键帧（player 采样+贴地+烘焙后通过 PATH_DESIGN_KEYFRAMES 回传）
+     */
+    generate(): void;
+    /**
+     * 一发式生成关键帧（AI 工具用，不进入交互模式）
+     * player 直接采样+贴地+烘焙，回传带 requestId 的 PATH_DESIGN_KEYFRAMES 消息
+     */
+    generateOneshot(requestId: string, componentId: string, pathDesign: VrTransitionAnimationPathDesign): void;
+    /**
+     * 把组件本体移到路径起点（含朝向），player 通过 COMPONENT_UPDATE 消息回传新姿态
+     */
+    moveComponentToStart(): void;
+}

package/dist/src/parent/com-message/index.d.ts

@@ -16,3 +16,4 @@ export * from './parent-com-message-sticker';
 export * from './parent-com-message-wormhole';
 export * from './parent-com-message-space-fence';
 export * from './parent-com-message-dolly-path';
+export * from './parent-com-message-path-design';

package/dist/src/parent/com-message/parent-com-message-path-design.d.ts

@@ -0,0 +1,52 @@
+import { VRTalkEditablePlayer } from '../vrtalk-editable-player';
+import { VrComponentTransitionAnimationKeyframe, VrPathDesignPoint, VrPathDesignTool, Vector3 } from '../../model';
+import type { PathGenerateStats } from '../../utils/path-keyframe-generator';
+/**
+ * 父层关于ComMessage的接收
+ * 过渡动画路径设计相关
+ */
+export declare class ParentComMessagePathDesign {
+    private player;
+    constructor(player: VRTalkEditablePlayer);
+    /**
+     * 用户在 3D 中增/删/插/拖点后回传最新控制点列表
+     */
+    onPointsUpdate(callback: (points: VrPathDesignPoint[]) => void): void;
+    /**
+     * 3D 中选中点变化
+     */
+    onSelectionUpdate(callback: (pointId: string | null) => void): void;
+    /**
+     * 组件包围盒信息（进入模式后自动回传）
+     * bottomToPivot = 组件 pivot 到包围盒底部的世界距离（自动离地偏移的来源）
+     */
+    onBounds(callback: (data: {
+        bottomToPivot: number;
+        size: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    }) => void): void;
+    /**
+     * 路径统计（任何变化后回传）
+     */
+    onStats(callback: (stats: PathGenerateStats) => void): void;
+    /**
+     * 生成关键帧结果
+     * @param callback requestId 非 null 时为一发式生成（AI 工具）的结果，交互面板应忽略
+     */
+    onKeyframes(callback: (keyFrameList: VrComponentTransitionAnimationKeyframe[], stats: PathGenerateStats, requestId: string | null) => void): void;
+    /**
+     * 起/终点拾取结果（PositionX 导航起终点选择）
+     */
+    onPickResult(callback: (tool: VrPathDesignTool, position: Vector3) => void): void;
+    /**
+     * player 内按下 Ctrl+Z / Ctrl+Shift+Z（撤销栈在 console 侧）
+     */
+    onUndoRequest(callback: (redo: boolean) => void): void;
+    /**
+     * 试播/scrub 状态回传
+     */
+    onPreviewState(callback: (playing: boolean, progress: number) => void): void;
+}

package/dist/src/parent/vrtalk-editable-player.d.ts

@@ -1,8 +1,8 @@
 import { ParentComMessagePlayer } from './com-message/parent-com-message-player';
 import { PlayerComMessage, PlayerComMessageType } from '..//player/com-message/player-com-message';
 import { PlayerComCommand } from '../player/com-command/player-com-command';
-import { ParentComCommandAssetLabel, ParentComCommandAssetPointMark, ParentComCommandAssetVolumeMark, ParentComCommandAudio, ParentComCommandCamera, ParentComCommandComponent, ParentComCommandCover, ParentComCommandFloor, ParentComCommandFov, ParentComCommandInformation, ParentComCommandInfoTemplate, ParentComCommandLayer, ParentComCommandLight, ParentComCommandMarker, ParentComCommandNavigation, ParentComCommandObstacle, ParentComCommandPlayer, ParentComCommandSpaceFence, ParentComCommandRenderer, ParentComCommandSticker, ParentComCommandSweep, ParentComCommandTarget, ParentComCommandTrimmer, ParentComCommandUi, ParentComCommandWormhole, ParentComCommandMonitor, ParentComCommandMessageCard, ParentComCommandDollyPath, ParentComCommandHamburgerMenu } from './com-command';
-import { ParentComMessageAssetLabel, ParentComMessageAssetPointMark, ParentComMessageAssetVolumeMark, ParentComMessageCamera, ParentComMessageComponent, ParentComMessageFloor, ParentComMessageFov, ParentComMessageNavigation, ParentComMessageObstacle, ParentComMessageRenderer, ParentComMessageSpaceFence, ParentComMessageSticker, ParentComMessageSweep, ParentComMessageTarget, ParentComMessageTrimmer, ParentComMessageWormhole, ParentComMessageDollyPath } from './com-message';
+import { ParentComCommandAssetLabel, ParentComCommandAssetPointMark, ParentComCommandAssetVolumeMark, ParentComCommandAudio, ParentComCommandCamera, ParentComCommandComponent, ParentComCommandCover, ParentComCommandFloor, ParentComCommandFov, ParentComCommandInformation, ParentComCommandInfoTemplate, ParentComCommandLayer, ParentComCommandLight, ParentComCommandMarker, ParentComCommandNavigation, ParentComCommandObstacle, ParentComCommandPlayer, ParentComCommandSpaceFence, ParentComCommandRenderer, ParentComCommandSticker, ParentComCommandSweep, ParentComCommandTarget, ParentComCommandTrimmer, ParentComCommandUi, ParentComCommandWormhole, ParentComCommandMonitor, ParentComCommandMessageCard, ParentComCommandDollyPath, ParentComCommandHamburgerMenu, ParentComCommandPathDesign } from './com-command';
+import { ParentComMessageAssetLabel, ParentComMessageAssetPointMark, ParentComMessageAssetVolumeMark, ParentComMessageCamera, ParentComMessageComponent, ParentComMessageFloor, ParentComMessageFov, ParentComMessageNavigation, ParentComMessageObstacle, ParentComMessageRenderer, ParentComMessageSpaceFence, ParentComMessageSticker, ParentComMessageSweep, ParentComMessageTarget, ParentComMessageTrimmer, ParentComMessageWormhole, ParentComMessageDollyPath, ParentComMessagePathDesign } from './com-message';
 export declare class VRTalkEditablePlayer {
     serviceRegion: string;
     iframeElement: HTMLIFrameElement | null;
@@ -25,6 +25,7 @@ export declare class VRTalkEditablePlayer {
     messageWormhole: ParentComMessageWormhole;
     messageSpaceFence: ParentComMessageSpaceFence;
     messageDollyPath: ParentComMessageDollyPath;
+    messagePathDesign: ParentComMessagePathDesign;
     commandPlayer: ParentComCommandPlayer;
     commandCover: ParentComCommandCover;
     commandUi: ParentComCommandUi;
@@ -54,6 +55,7 @@ export declare class VRTalkEditablePlayer {
     commandMessageCard: ParentComCommandMessageCard;
     commandDollyPath: ParentComCommandDollyPath;
     commandHamburgerMenu: ParentComCommandHamburgerMenu;
+    commandPathDesign: ParentComCommandPathDesign;
     constructor(serviceRegion: string, iframeElement: HTMLIFrameElement);
     /**
      * 注册Player消息监听器

package/dist/src/player/com-command/index.d.ts

@@ -28,3 +28,4 @@ export * from './player-com-command-monitor';
 export * from './player-com-command-message-card';
 export * from './player-com-command-dolly-path';
 export * from './player-com-command-hamburger-menu';
+export * from './player-com-command-path-design';

package/dist/src/player/com-command/player-com-command-path-design.d.ts

@@ -0,0 +1,54 @@
+import { VrPathDesignTool, VrPathDesignView, VrTransitionAnimationPathDesign } from '../../model';
+/**
+ * 播放器监听过渡动画路径设计相关命令
+ */
+export declare class PlayerComCommandPathDesign {
+    /**
+     * 监听命令 进入路径设计模式
+     */
+    onEnter(callback: (componentId: string, animationId: string, pathDesign: VrTransitionAnimationPathDesign) => void): void;
+    /**
+     * 监听命令 退出路径设计模式
+     */
+    onExit(callback: () => void): void;
+    /**
+     * 监听命令 草稿更新
+     */
+    onUpdate(callback: (pathDesign: VrTransitionAnimationPathDesign, resnapPoints: boolean) => void): void;
+    /**
+     * 监听命令 切换 3D 交互工具
+     */
+    onSetTool(callback: (tool: VrPathDesignTool) => void): void;
+    /**
+     * 监听命令 切换观察视角
+     */
+    onSetView(callback: (view: VrPathDesignView) => void): void;
+    /**
+     * 监听命令 选中/取消选中路径点
+     */
+    onSelectPoint(callback: (pointId: string | null) => void): void;
+    /**
+     * 监听命令 预览进度拖拽
+     */
+    onScrub(callback: (progress: number) => void): void;
+    /**
+     * 监听命令 试播
+     */
+    onPreviewPlay(callback: () => void): void;
+    /**
+     * 监听命令 停止试播
+     */
+    onPreviewStop(callback: () => void): void;
+    /**
+     * 监听命令 生成关键帧
+     */
+    onGenerate(callback: () => void): void;
+    /**
+     * 监听命令 一发式生成关键帧（AI 工具用，不进入交互模式）
+     */
+    onGenerateOneshot(callback: (requestId: string, componentId: string, pathDesign: VrTransitionAnimationPathDesign) => void): void;
+    /**
+     * 监听命令 把组件本体移到路径起点
+     */
+    onMoveComponentToStart(callback: () => void): void;
+}

package/dist/src/player/com-command/player-com-command.d.ts

@@ -11,7 +11,7 @@ export declare class PlayerComCommand {
 /**
  * VR播放器向父层发送的消息类型
  */
-export declare type PlayerComCommandType = 'vrtalk_cmd_player_start' | 'vrtalk_cmd_player_mode_update' | 'vrtalk_cmd_player_xr_prepare_preview' | 'vrtalk_cmd_player_prepare_settings_update' | 'vrtalk_cmd_cover_settings_update' | 'vrtalk_cmd_ui_settings_update' | 'vrtalk_cmd_info_template_settings_update' | 'vrtalk_cmd_component_create' | 'vrtalk_cmd_component_update' | 'vrtalk_cmd_component_delete' | 'vrtalk_cmd_component_follow_mouse' | 'vrtalk_cmd_component_controller' | 'vrtalk_cmd_component_play_transition_animation' | 'vrtalk_cmd_component_stop_transition_animation' | 'vrtalk_cmd_component_3d_model_play_animation_clip' | 'vrtalk_cmd_component_3d_model_stop_animation_clip' | 'vrtalk_cmd_component_2d_text_auto_fit' | 'vrtalk_cmd_fov_enter_shot_mode' | 'vrtalk_cmd_fov_exit_shot_mode' | 'vrtalk_cmd_fov_update' | 'vrtalk_cmd_fov_delete' | 'vrtalk_cmd_layer_update' | 'vrtalk_cmd_layer_delete' | 'vrtalk_cmd_layer_visible' | 'vrtalk_cmd_information_content_card_update' | 'vrtalk_cmd_information_content_card_delete' | 'vrtalk_cmd_marker_update' | 'vrtalk_cmd_marker_delete' | 'vrtalk_cmd_marker_group_update' | 'vrtalk_cmd_marker_group_delete' | 'vrtalk_cmd_sweep_update_all' | 'vrtalk_cmd_sweep_update' | 'vrtalk_cmd_sweep_delete_virtual' | 'vrtalk_cmd_sweep_update_render_flag_visible' | 'vrtalk_cmd_light_create' | 'vrtalk_cmd_light_update' | 'vrtalk_cmd_light_delete' | 'vrtalk_cmd_trimmer_create' | 'vrtalk_cmd_trimmer_update' | 'vrtalk_cmd_trimmer_delete' | 'vrtalk_cmd_trimmer_controller' | 'vrtalk_cmd_trimmer_editing_state_update' | 'vrtalk_cmd_sticker_create' | 'vrtalk_cmd_sticker_update' | 'vrtalk_cmd_sticker_delete' | 'vrtalk_cmd_sticker_controller' | 'vrtalk_cmd_sticker_editing_state_update' | 'vrtalk_cmd_target_create' | 'vrtalk_cmd_target_update' | 'vrtalk_cmd_target_delete' | 'vrtalk_cmd_target_controller' | 'vrtalk_cmd_target_editing_state_update' | 'vrtalk_cmd_target_group_visible_update' | 'vrtalk_cmd_obstacle_create' | 'vrtalk_cmd_obstacle_update' | 'vrtalk_cmd_obstacle_delete' | 'vrtalk_cmd_obstacle_controller' | 'vrtalk_cmd_obstacle_editing_state_update' | 'vrtalk_cmd_obstacle_group_visible_update' | 'vrtalk_cmd_space_fence_create' | 'vrtalk_cmd_space_fence_update' | 'vrtalk_cmd_space_fence_delete' | 'vrtalk_cmd_space_fence_controller' | 'vrtalk_cmd_space_fence_editing_state_update' | 'vrtalk_cmd_space_fence_group_visible_update' | 'vrtalk_cmd_space_fence_group_color_update' | 'vrtalk_cmd_wormhole_create' | 'vrtalk_cmd_wormhole_update' | 'vrtalk_cmd_wormhole_delete' | 'vrtalk_cmd_wormhole_controller' | 'vrtalk_cmd_wormhole_editing_state_update' | 'vrtalk_cmd_wormhole_group_visible_update' | 'vrtalk_cmd_asset_label_create' | 'vrtalk_cmd_asset_label_update' | 'vrtalk_cmd_asset_label_delete' | 'vrtalk_cmd_asset_label_controller' | 'vrtalk_cmd_asset_label_editing_state_update' | 'vrtalk_cmd_asset_point_mark_create' | 'vrtalk_cmd_asset_point_mark_update' | 'vrtalk_cmd_asset_point_mark_delete' | 'vrtalk_cmd_asset_point_mark_controller' | 'vrtalk_cmd_asset_point_mark_editing_state_update' | 'vrtalk_cmd_asset_volume_mark_create' | 'vrtalk_cmd_asset_volume_mark_update' | 'vrtalk_cmd_asset_volume_mark_delete' | 'vrtalk_cmd_asset_volume_mark_controller' | 'vrtalk_cmd_asset_volume_mark_editing_state_update' | 'vrtalk_cmd_floor_update' | 'vrtalk_cmd_camera_move_to' | 'vrtalk_cmd_camera_move_to_inside' | 'vrtalk_cmd_camera_move_to_vr_fov' | 'vrtalk_cmd_camera_move_to_near_component' | 'vrtalk_cmd_camera_move_to_watch_position' | 'vrtalk_cmd_camera_request_deeplink_params' | 'vrtalk_cmd_renderer_take_screenshot' | 'vrtalk_cmd_renderer_get_panorama_image' | 'vrtalk_cmd_renderer_settings_update' | 'vrtalk_cmd_renderer_color_space_settings_update' | 'vrtalk_cmd_navigation_request' | 'vrtalk_cmd_navigation_start' | 'vrtalk_cmd_navigation_cancel' | 'vrtalk_cmd_audio_update' | 'vrtalk_cmd_audio_delete' | 'vrtalk_cmd_audio_list_update' | 'vrtalk_cmd_audio_list_delete' | 'vrtalk_cmd_audio_center_player_show_play_control_update' | 'vrtalk_cmd_audio_center_player_show_volume_control_update' | 'vrtalk_cmd_audio_center_player_volume_update' | 'vrtalk_cmd_monitor_list_update' | 'vrtalk_cmd_dolly_path_capture_destination' | 'vrtalk_cmd_dolly_path_preview' | 'vrtalk_cmd_dolly_path_stop_preview' | 'vrtalk_cmd_message_card_preview' | 'vrtalk_cmd_hamburger_menu_update';
+export declare type PlayerComCommandType = 'vrtalk_cmd_player_start' | 'vrtalk_cmd_player_mode_update' | 'vrtalk_cmd_player_xr_prepare_preview' | 'vrtalk_cmd_player_prepare_settings_update' | 'vrtalk_cmd_cover_settings_update' | 'vrtalk_cmd_ui_settings_update' | 'vrtalk_cmd_info_template_settings_update' | 'vrtalk_cmd_component_create' | 'vrtalk_cmd_component_update' | 'vrtalk_cmd_component_delete' | 'vrtalk_cmd_component_follow_mouse' | 'vrtalk_cmd_component_controller' | 'vrtalk_cmd_component_play_transition_animation' | 'vrtalk_cmd_component_stop_transition_animation' | 'vrtalk_cmd_component_3d_model_play_animation_clip' | 'vrtalk_cmd_component_3d_model_stop_animation_clip' | 'vrtalk_cmd_component_2d_text_auto_fit' | 'vrtalk_cmd_fov_enter_shot_mode' | 'vrtalk_cmd_fov_exit_shot_mode' | 'vrtalk_cmd_fov_update' | 'vrtalk_cmd_fov_delete' | 'vrtalk_cmd_layer_update' | 'vrtalk_cmd_layer_delete' | 'vrtalk_cmd_layer_visible' | 'vrtalk_cmd_information_content_card_update' | 'vrtalk_cmd_information_content_card_delete' | 'vrtalk_cmd_marker_update' | 'vrtalk_cmd_marker_delete' | 'vrtalk_cmd_marker_group_update' | 'vrtalk_cmd_marker_group_delete' | 'vrtalk_cmd_sweep_update_all' | 'vrtalk_cmd_sweep_update' | 'vrtalk_cmd_sweep_delete_virtual' | 'vrtalk_cmd_sweep_update_render_flag_visible' | 'vrtalk_cmd_light_create' | 'vrtalk_cmd_light_update' | 'vrtalk_cmd_light_delete' | 'vrtalk_cmd_trimmer_create' | 'vrtalk_cmd_trimmer_update' | 'vrtalk_cmd_trimmer_delete' | 'vrtalk_cmd_trimmer_controller' | 'vrtalk_cmd_trimmer_editing_state_update' | 'vrtalk_cmd_sticker_create' | 'vrtalk_cmd_sticker_update' | 'vrtalk_cmd_sticker_delete' | 'vrtalk_cmd_sticker_controller' | 'vrtalk_cmd_sticker_editing_state_update' | 'vrtalk_cmd_target_create' | 'vrtalk_cmd_target_update' | 'vrtalk_cmd_target_delete' | 'vrtalk_cmd_target_controller' | 'vrtalk_cmd_target_editing_state_update' | 'vrtalk_cmd_target_group_visible_update' | 'vrtalk_cmd_obstacle_create' | 'vrtalk_cmd_obstacle_update' | 'vrtalk_cmd_obstacle_delete' | 'vrtalk_cmd_obstacle_controller' | 'vrtalk_cmd_obstacle_editing_state_update' | 'vrtalk_cmd_obstacle_group_visible_update' | 'vrtalk_cmd_space_fence_create' | 'vrtalk_cmd_space_fence_update' | 'vrtalk_cmd_space_fence_delete' | 'vrtalk_cmd_space_fence_controller' | 'vrtalk_cmd_space_fence_editing_state_update' | 'vrtalk_cmd_space_fence_group_visible_update' | 'vrtalk_cmd_space_fence_group_color_update' | 'vrtalk_cmd_wormhole_create' | 'vrtalk_cmd_wormhole_update' | 'vrtalk_cmd_wormhole_delete' | 'vrtalk_cmd_wormhole_controller' | 'vrtalk_cmd_wormhole_editing_state_update' | 'vrtalk_cmd_wormhole_group_visible_update' | 'vrtalk_cmd_asset_label_create' | 'vrtalk_cmd_asset_label_update' | 'vrtalk_cmd_asset_label_delete' | 'vrtalk_cmd_asset_label_controller' | 'vrtalk_cmd_asset_label_editing_state_update' | 'vrtalk_cmd_asset_point_mark_create' | 'vrtalk_cmd_asset_point_mark_update' | 'vrtalk_cmd_asset_point_mark_delete' | 'vrtalk_cmd_asset_point_mark_controller' | 'vrtalk_cmd_asset_point_mark_editing_state_update' | 'vrtalk_cmd_asset_volume_mark_create' | 'vrtalk_cmd_asset_volume_mark_update' | 'vrtalk_cmd_asset_volume_mark_delete' | 'vrtalk_cmd_asset_volume_mark_controller' | 'vrtalk_cmd_asset_volume_mark_editing_state_update' | 'vrtalk_cmd_floor_update' | 'vrtalk_cmd_camera_move_to' | 'vrtalk_cmd_camera_move_to_inside' | 'vrtalk_cmd_camera_move_to_vr_fov' | 'vrtalk_cmd_camera_move_to_near_component' | 'vrtalk_cmd_camera_move_to_watch_position' | 'vrtalk_cmd_camera_request_deeplink_params' | 'vrtalk_cmd_renderer_take_screenshot' | 'vrtalk_cmd_renderer_get_panorama_image' | 'vrtalk_cmd_renderer_settings_update' | 'vrtalk_cmd_renderer_color_space_settings_update' | 'vrtalk_cmd_navigation_request' | 'vrtalk_cmd_navigation_start' | 'vrtalk_cmd_navigation_cancel' | 'vrtalk_cmd_audio_update' | 'vrtalk_cmd_audio_delete' | 'vrtalk_cmd_audio_list_update' | 'vrtalk_cmd_audio_list_delete' | 'vrtalk_cmd_audio_center_player_show_play_control_update' | 'vrtalk_cmd_audio_center_player_show_volume_control_update' | 'vrtalk_cmd_audio_center_player_volume_update' | 'vrtalk_cmd_monitor_list_update' | 'vrtalk_cmd_dolly_path_capture_destination' | 'vrtalk_cmd_dolly_path_preview' | 'vrtalk_cmd_dolly_path_stop_preview' | 'vrtalk_cmd_path_design_enter' | 'vrtalk_cmd_path_design_exit' | 'vrtalk_cmd_path_design_update' | 'vrtalk_cmd_path_design_set_tool' | 'vrtalk_cmd_path_design_set_view' | 'vrtalk_cmd_path_design_select_point' | 'vrtalk_cmd_path_design_scrub' | 'vrtalk_cmd_path_design_preview_play' | 'vrtalk_cmd_path_design_preview_stop' | 'vrtalk_cmd_path_design_generate' | 'vrtalk_cmd_path_design_generate_oneshot' | 'vrtalk_cmd_path_design_move_component_to_start' | 'vrtalk_cmd_message_card_preview' | 'vrtalk_cmd_hamburger_menu_update';
 export declare class PlayerComCommandTypeDefine {
     static readonly PLAYER_START: PlayerComCommandType;
     static readonly PLAYER_MODE_UPDATE: PlayerComCommandType;
@@ -123,6 +123,18 @@ export declare class PlayerComCommandTypeDefine {
     static readonly DOLLY_PATH_CAPTURE_DESTINATION: PlayerComCommandType;
     static readonly DOLLY_PATH_PREVIEW: PlayerComCommandType;
     static readonly DOLLY_PATH_STOP_PREVIEW: PlayerComCommandType;
+    static readonly PATH_DESIGN_ENTER: PlayerComCommandType;
+    static readonly PATH_DESIGN_EXIT: PlayerComCommandType;
+    static readonly PATH_DESIGN_UPDATE: PlayerComCommandType;
+    static readonly PATH_DESIGN_SET_TOOL: PlayerComCommandType;
+    static readonly PATH_DESIGN_SET_VIEW: PlayerComCommandType;
+    static readonly PATH_DESIGN_SELECT_POINT: PlayerComCommandType;
+    static readonly PATH_DESIGN_SCRUB: PlayerComCommandType;
+    static readonly PATH_DESIGN_PREVIEW_PLAY: PlayerComCommandType;
+    static readonly PATH_DESIGN_PREVIEW_STOP: PlayerComCommandType;
+    static readonly PATH_DESIGN_GENERATE: PlayerComCommandType;
+    static readonly PATH_DESIGN_GENERATE_ONESHOT: PlayerComCommandType;
+    static readonly PATH_DESIGN_MOVE_COMPONENT_TO_START: PlayerComCommandType;
     static readonly MESSAGE_CARD_PREVIEW: PlayerComCommandType;
     static readonly HAMBURGER_MENU_UPDATE: PlayerComCommandType;
 }

package/dist/src/player/com-message/index.d.ts

@@ -17,3 +17,4 @@ export * from './player-com-message-trimmer';
 export * from './player-com-message-wormhole';
 export * from './player-com-message-space-fence';
 export * from './player-com-message-dolly-path';
+export * from './player-com-message-path-design';

package/dist/src/player/com-message/player-com-message-path-design.d.ts

@@ -0,0 +1,46 @@
+import { VrComponentTransitionAnimationKeyframe, VrPathDesignPoint, VrPathDesignTool, Vector3 } from '../../model';
+import type { PathGenerateStats } from '../../utils/path-keyframe-generator';
+/**
+ * 播放器发送过渡动画路径设计相关消息
+ */
+export declare class PlayerComMessagePathDesign {
+    /**
+     * 发送最新控制点列表（3D 中增/删/插/拖点后）
+     */
+    sendPointsUpdate(points: VrPathDesignPoint[]): void;
+    /**
+     * 发送选中点变化
+     */
+    sendSelectionUpdate(pointId: string | null): void;
+    /**
+     * 发送组件包围盒信息
+     * @param bottomToPivot 组件 pivot 到包围盒底部的世界距离
+     * @param size 包围盒尺寸
+     */
+    sendBounds(bottomToPivot: number, size: {
+        x: number;
+        y: number;
+        z: number;
+    }): void;
+    /**
+     * 发送路径统计
+     */
+    sendStats(stats: PathGenerateStats): void;
+    /**
+     * 发送生成关键帧结果
+     * @param requestId 一发式生成的请求id（交互模式生成不带）
+     */
+    sendKeyframes(keyFrameList: VrComponentTransitionAnimationKeyframe[], stats: PathGenerateStats, requestId?: string): void;
+    /**
+     * 发送起/终点拾取结果
+     */
+    sendPickResult(tool: VrPathDesignTool, position: Vector3): void;
+    /**
+     * 发送撤销/重做请求（撤销栈在 console 侧）
+     */
+    sendUndoRequest(redo: boolean): void;
+    /**
+     * 发送试播/scrub 状态
+     */
+    sendPreviewState(playing: boolean, progress: number): void;
+}

package/dist/src/player/com-message/player-com-message.d.ts

@@ -11,7 +11,7 @@ export declare class PlayerComMessage {
 /**
  * VR播放器向父层发送的消息类型
  */
-export declare type PlayerComMessageType = 'vrtalk_msg_player_ready' | 'vrtalk_msg_player_status_update' | 'vrtalk_msg_component_update' | 'vrtalk_msg_component_on_click' | 'vrtalk_msg_component_controller_focus_update' | 'vrtalk_msg_component_transition_animation_finished' | 'vrtalk_msg_fov_shot_result' | 'vrtalk_msg_trimmer_update' | 'vrtalk_msg_trimmer_on_click' | 'vrtalk_msg_sticker_update' | 'vrtalk_msg_sticker_on_click' | 'vrtalk_msg_target_update' | 'vrtalk_msg_target_on_click' | 'vrtalk_msg_obstacle_update' | 'vrtalk_msg_obstacle_on_click' | 'vrtalk_msg_space_fence_update' | 'vrtalk_msg_space_fence_on_click' | 'vrtalk_msg_wormhole_update' | 'vrtalk_msg_wormhole_on_click' | 'vrtalk_msg_asset_label_update' | 'vrtalk_msg_asset_label_on_click' | 'vrtalk_msg_asset_point_mark_update' | 'vrtalk_msg_asset_point_mark_on_click' | 'vrtalk_msg_asset_volume_mark_update' | 'vrtalk_msg_asset_volume_mark_on_click' | 'vrtalk_msg_sweep_import_from_matterport' | 'vrtalk_msg_sweep_sync_matterport_enabled_state' | 'vrtalk_msg_sweep_request_modify_enabled' | 'vrtalk_msg_floor_import_from_matterport' | 'vrtalk_msg_floor_enter' | 'vrtalk_msg_floor_leave' | 'vrtalk_msg_camera_pose_update' | 'vrtalk_msg_camera_deeplink_params_ready' | 'vrtalk_msg_renderer_screenshot_ready' | 'vrtalk_msg_renderer_panorama_image_ready' | 'vrtalk_msg_renderer_world_size_ready' | 'vrtalk_msg_dolly_path_destination_captured' | 'vrtalk_msg_navigation_result_ready' | 'vrtalk_msg_navigation_start' | 'vrtalk_msg_navigation_end' | 'vrtalk_msg_navigation_cancel';
+export declare type PlayerComMessageType = 'vrtalk_msg_player_ready' | 'vrtalk_msg_player_status_update' | 'vrtalk_msg_component_update' | 'vrtalk_msg_component_on_click' | 'vrtalk_msg_component_controller_focus_update' | 'vrtalk_msg_component_transition_animation_finished' | 'vrtalk_msg_fov_shot_result' | 'vrtalk_msg_trimmer_update' | 'vrtalk_msg_trimmer_on_click' | 'vrtalk_msg_sticker_update' | 'vrtalk_msg_sticker_on_click' | 'vrtalk_msg_target_update' | 'vrtalk_msg_target_on_click' | 'vrtalk_msg_obstacle_update' | 'vrtalk_msg_obstacle_on_click' | 'vrtalk_msg_space_fence_update' | 'vrtalk_msg_space_fence_on_click' | 'vrtalk_msg_wormhole_update' | 'vrtalk_msg_wormhole_on_click' | 'vrtalk_msg_asset_label_update' | 'vrtalk_msg_asset_label_on_click' | 'vrtalk_msg_asset_point_mark_update' | 'vrtalk_msg_asset_point_mark_on_click' | 'vrtalk_msg_asset_volume_mark_update' | 'vrtalk_msg_asset_volume_mark_on_click' | 'vrtalk_msg_sweep_import_from_matterport' | 'vrtalk_msg_sweep_sync_matterport_enabled_state' | 'vrtalk_msg_sweep_request_modify_enabled' | 'vrtalk_msg_floor_import_from_matterport' | 'vrtalk_msg_floor_enter' | 'vrtalk_msg_floor_leave' | 'vrtalk_msg_camera_pose_update' | 'vrtalk_msg_camera_deeplink_params_ready' | 'vrtalk_msg_renderer_screenshot_ready' | 'vrtalk_msg_renderer_panorama_image_ready' | 'vrtalk_msg_renderer_world_size_ready' | 'vrtalk_msg_dolly_path_destination_captured' | 'vrtalk_msg_path_design_points_update' | 'vrtalk_msg_path_design_selection_update' | 'vrtalk_msg_path_design_bounds' | 'vrtalk_msg_path_design_stats' | 'vrtalk_msg_path_design_keyframes' | 'vrtalk_msg_path_design_pick_result' | 'vrtalk_msg_path_design_undo_request' | 'vrtalk_msg_path_design_preview_state' | 'vrtalk_msg_navigation_result_ready' | 'vrtalk_msg_navigation_start' | 'vrtalk_msg_navigation_end' | 'vrtalk_msg_navigation_cancel';
 export declare class PlayerComMessageTypeDefine {
     static readonly PLAYER_READY: PlayerComMessageType;
     static readonly PLAYER_STATUS_UPDATE: PlayerComMessageType;
@@ -49,6 +49,14 @@ export declare class PlayerComMessageTypeDefine {
     static readonly RENDERER_PANORAMA_IMAGE_READY: PlayerComMessageType;
     static readonly RENDERER_WORLD_SIZE_READY: PlayerComMessageType;
     static readonly DOLLY_PATH_DESTINATION_CAPTURED: PlayerComMessageType;
+    static readonly PATH_DESIGN_POINTS_UPDATE: PlayerComMessageType;
+    static readonly PATH_DESIGN_SELECTION_UPDATE: PlayerComMessageType;
+    static readonly PATH_DESIGN_BOUNDS: PlayerComMessageType;
+    static readonly PATH_DESIGN_STATS: PlayerComMessageType;
+    static readonly PATH_DESIGN_KEYFRAMES: PlayerComMessageType;
+    static readonly PATH_DESIGN_PICK_RESULT: PlayerComMessageType;
+    static readonly PATH_DESIGN_UNDO_REQUEST: PlayerComMessageType;
+    static readonly PATH_DESIGN_PREVIEW_STATE: PlayerComMessageType;
     static readonly NAVIGATION_RESULT_READY: PlayerComMessageType;
     static readonly NAVIGATION_START: PlayerComMessageType;
     static readonly NAVIGATION_END: PlayerComMessageType;

package/dist/src/player/player-controller.d.ts

@@ -1,5 +1,5 @@
-import { PlayerComCommand, PlayerComCommandAssetLabel, PlayerComCommandAssetPointMark, PlayerComCommandAssetVolumeMark, PlayerComCommandAudio, PlayerComCommandCamera, PlayerComCommandComponent, PlayerComCommandCover, PlayerComCommandFloor, PlayerComCommandFov, PlayerComCommandInformation, PlayerComCommandInfoTemplate, PlayerComCommandLayer, PlayerComCommandLight, PlayerComCommandMarker, PlayerComCommandNavigation, PlayerComCommandObstacle, PlayerComCommandPlayer, PlayerComCommandRenderer, PlayerComCommandSpaceFence, PlayerComCommandSticker, PlayerComCommandTarget, PlayerComCommandTrimmer, PlayerComCommandType, PlayerComCommandUi, PlayerComCommandWormhole, PlayerComCommandMonitor, PlayerComCommandMessageCard, PlayerComCommandDollyPath, PlayerComCommandHamburgerMenu } from './com-command';
-import { PlayerComMessageAssetLabel, PlayerComMessageAssetPointMark, PlayerComMessageAssetVolumeMark, PlayerComMessageCamera, PlayerComMessageComponent, PlayerComMessageFloor, PlayerComMessageFov, PlayerComMessageNavigation, PlayerComMessageObstacle, PlayerComMessagePlayer, PlayerComMessageRenderer, PlayerComMessageSpaceFence, PlayerComMessageSticker, PlayerComMessageSweep, PlayerComMessageTarget, PlayerComMessageTrimmer, PlayerComMessageWormhole, PlayerComMessageDollyPath } from './com-message';
+import { PlayerComCommand, PlayerComCommandAssetLabel, PlayerComCommandAssetPointMark, PlayerComCommandAssetVolumeMark, PlayerComCommandAudio, PlayerComCommandCamera, PlayerComCommandComponent, PlayerComCommandCover, PlayerComCommandFloor, PlayerComCommandFov, PlayerComCommandInformation, PlayerComCommandInfoTemplate, PlayerComCommandLayer, PlayerComCommandLight, PlayerComCommandMarker, PlayerComCommandNavigation, PlayerComCommandObstacle, PlayerComCommandPlayer, PlayerComCommandRenderer, PlayerComCommandSpaceFence, PlayerComCommandSticker, PlayerComCommandTarget, PlayerComCommandTrimmer, PlayerComCommandType, PlayerComCommandUi, PlayerComCommandWormhole, PlayerComCommandMonitor, PlayerComCommandMessageCard, PlayerComCommandDollyPath, PlayerComCommandHamburgerMenu, PlayerComCommandPathDesign } from './com-command';
+import { PlayerComMessageAssetLabel, PlayerComMessageAssetPointMark, PlayerComMessageAssetVolumeMark, PlayerComMessageCamera, PlayerComMessageComponent, PlayerComMessageFloor, PlayerComMessageFov, PlayerComMessageNavigation, PlayerComMessageObstacle, PlayerComMessagePlayer, PlayerComMessageRenderer, PlayerComMessageSpaceFence, PlayerComMessageSticker, PlayerComMessageSweep, PlayerComMessageTarget, PlayerComMessageTrimmer, PlayerComMessageWormhole, PlayerComMessageDollyPath, PlayerComMessagePathDesign } from './com-message';
 import { PlayerComCommandSweep } from './com-command/player-com-command-sweep';
 /**
  * Player控制器
@@ -36,6 +36,7 @@ export declare class PlayerController {
     static commandMessageCard: PlayerComCommandMessageCard;
     static commandDollyPath: PlayerComCommandDollyPath;
     static commandHamburgerMenu: PlayerComCommandHamburgerMenu;
+    static commandPathDesign: PlayerComCommandPathDesign;
     static messageCamera: PlayerComMessageCamera;
     static messageComponent: PlayerComMessageComponent;
     static messageFov: PlayerComMessageFov;
@@ -54,6 +55,7 @@ export declare class PlayerController {
     static messageWormhole: PlayerComMessageWormhole;
     static messageSpaceFence: PlayerComMessageSpaceFence;
     static messageDollyPath: PlayerComMessageDollyPath;
+    static messagePathDesign: PlayerComMessagePathDesign;
     /**
      * 注册Player命令监听器
      * @param commandType 命令类型

package/dist/src/utils/path-keyframe-generator.d.ts

@@ -0,0 +1,66 @@
+import { Vector3 } from '../model/general/vector';
+import { VrComponentTransitionAnimationKeyframe, VrComponentTransitionAnimationPlayCompleteProcessType } from '../model/vr-component/vr-component-data';
+import { VrTransitionAnimationPathDesign } from '../model/vr-component/vr-path-design';
+/**
+ * 过渡动画路径 → 关键帧生成器（纯函数，零依赖）
+ *
+ * 手动路径工具 / PositionX 导航导入 / AI generate_path_transition_animation 三个来源共用本管线。
+ * 产出的是与手工创建完全同构的普通关键帧；player 播放逻辑零改动。
+ *
+ * 生成正确性的两个关键点（与 xr-component-general-engine.ts 的播放行为严格对应）：
+ * 1. 引擎每个关键帧开始时用 THREE.Euler().setFromQuaternion()（XYZ 序）从实际姿态提取欧拉角作为
+ *    插值源值，值域受 asin/atan2 限制。本生成器精确模拟该提取（simulateEngineEulerRead），
+ *    并在目标欧拉角的两个等价表示 (x,y,z) ≡ (x+180, 180−y, z+180) 及其 ±360k 平移中，
+ *    选取与源值逐分量距离最小的表示 —— 保证每段插值走最短弧，跨 ±180°/万向节区域不甩头。
+ * 2. 引擎对 duration<=16ms 的帧走同步直贴（不经过 anime），「瞬移到起点」帧用 duration=1 实现。
+ */
+export declare type PathGroundSnapFn = (x: number, refY: number, z: number) => number | null;
+export interface PathSample {
+    position: Vector3;
+    groundY: number;
+    isControlPoint: boolean;
+    controlPointId: string;
+    segmentLength: number;
+    speedMps: number;
+    hoverMs: number;
+}
+export interface PathSamplingResult {
+    legs: PathSample[][];
+    totalLengthM: number;
+    sampleStepUsedM: number;
+}
+export interface PathGenerateStats {
+    totalLengthM: number;
+    estimatedDurationMs: number;
+    keyframeCount: number;
+    sampleStepUsedM: number;
+}
+export interface PathGenerateResult {
+    keyFrameList: VrComponentTransitionAnimationKeyframe[];
+    stats: PathGenerateStats;
+}
+/**
+ * 由路径设计草稿生成完整关键帧序列
+ * @param design 路径设计草稿
+ * @param groundSnap 贴地回调（仅贴地模式需要；传 null 则不贴地，直接用曲线高度）
+ * @param currentPosition 组件当前位置（walk-in 起步帧时长计算用）
+ * @param currentRotation 组件当前旋转（欧拉角度数；首帧最短弧参考）
+ */
+export declare function generatePathKeyframes(design: VrTransitionAnimationPathDesign, groundSnap: PathGroundSnapFn | null, currentPosition: Vector3, currentRotation: Vector3): PathGenerateResult;
+/**
+ * 采样路径（平滑 + 贴地 + 速度/悬停解析 + 往返展开）。
+ * 路径可视化画线也用本函数（取 legs 中各样点的 groundY / position）。
+ */
+export declare function samplePathDesign(design: VrTransitionAnimationPathDesign, groundSnap: PathGroundSnapFn | null): PathSamplingResult;
+/**
+ * 由采样结果合成关键帧
+ */
+export declare function buildKeyframesFromSampling(design: VrTransitionAnimationPathDesign, sampling: PathSamplingResult, currentPosition: Vector3, currentRotation: Vector3): PathGenerateResult;
+/**
+ * 根据往返模式给出建议的动画播放完成处理方式
+ */
+export declare function suggestedPlayCompleteProcessType(design: VrTransitionAnimationPathDesign): VrComponentTransitionAnimationPlayCompleteProcessType;
+/**
+ * Douglas-Peucker 折线简化（3D）。PositionX 导航 waypoints 导入前先过一遍，容差建议 0.15m
+ */
+export declare function simplifyPathPoints(points: Vector3[], toleranceM: number): Vector3[];