vrtalk-web-sdk 0.1.599 → 0.1.600

package/dist/src/model/vr/xr-logic.d.ts

@@ -3,13 +3,24 @@ import type { XrMonitorComponentType, XrMonitorComponentImageMode, XrMonitorComp
 import { VrSignalTrigger } from '@/model';
 import type { XrAnyAction } from './vr-action';
 import { XrConditionTree } from './vr-action';
-export declare type XrVariableType = 'string' | 'number' | 'boolean' | 'color' | 'css_color';
+export declare type XrVariableType = 'string' | 'number' | 'boolean' | 'color' | 'css_color' | 'image' | 'entity_ref' | 'list' | 'custom_class' | 'closure' | 'listener' | 'thread' | 'timer' | 'state_snapshot' | 'event_obj' | 'func_ref';
 export declare class XrVariableTypeDefine {
     static readonly STRING: XrVariableType;
     static readonly NUMBER: XrVariableType;
     static readonly BOOLEAN: XrVariableType;
     static readonly COLOR: XrVariableType;
     static readonly CSS_COLOR: XrVariableType;
+    static readonly IMAGE: XrVariableType;
+    static readonly ENTITY_REF: XrVariableType;
+    static readonly LIST: XrVariableType;
+    static readonly CUSTOM_CLASS: XrVariableType;
+    static readonly CLOSURE: XrVariableType;
+    static readonly LISTENER: XrVariableType;
+    static readonly THREAD: XrVariableType;
+    static readonly TIMER: XrVariableType;
+    static readonly STATE_SNAPSHOT: XrVariableType;
+    static readonly EVENT_OBJ: XrVariableType;
+    static readonly FUNC_REF: XrVariableType;
 }
 /**
  * string 类型变量的"推荐选项"。
@@ -37,6 +48,11 @@ export declare class XrVariable {
     colorRecommendOptions: Color[];
     cssColorDefaultValue: string;
     cssColorRecommendOptions: string[];
+    entityRefTypeKey?: string;
+    listElementType?: XrVariableType;
+    listElementRefTypeKey?: string;
+    listElementCustomClassId?: string;
+    customClassId?: string;
     /** @deprecated 已迁移至 stringRecommendOptions */
     enumOptions?: string[];
     /** @deprecated 已迁移至 stringDefaultValue */
@@ -51,8 +67,15 @@ export declare class XrVariable {
  * - flow: Flow 级（VrFlow.flowScopeVariableList）
  * - step: Flow Step 级（VrFlowStep.stepScopeVariableList）
  * - local: 最内层容器（trigger / button / background_thread / init / 消息卡片按钮）
+ *
+ * ===== 可视化编程系统方案甲·经典分层新增（plan §4.4）：共享 → 场景 → 模块 → 函数/子程序 → 回调 =====
+ * - scene:  场景级（每场景一份，场景内所有模块可见；替代老 global 在场景内的角色）；表达式 _场景.$
+ * - module: 模块级（模块内私有）；表达式 _模块.$
+ * - func:   函数/子程序级（调用帧的参数 + 局部，正确压栈；回调局部也用此层）；表达式 _函数.$
+ * - event:  事件载荷（监听回调期间临时压入的事件数据，泛化自 broadcast_msg）；表达式 _事件.$
+ * 老 global/local/step/flow/ability/broadcast_msg/agent 保留，供迁移与向后兼容读老格式（plan §1.23）。
  */
-export declare type XrVariableScopeType = 'global' | 'shared' | 'local' | 'step' | 'flow' | 'ability' | 'broadcast_msg' | 'agent';
+export declare type XrVariableScopeType = 'global' | 'shared' | 'local' | 'step' | 'flow' | 'ability' | 'broadcast_msg' | 'agent' | 'scene' | 'module' | 'func' | 'event';
 export declare class XrVariableScopeTypeDefine {
     static readonly GLOBAL: XrVariableScopeType;
     static readonly SHARED: XrVariableScopeType;
@@ -62,6 +85,10 @@ export declare class XrVariableScopeTypeDefine {
     static readonly ABILITY: XrVariableScopeType;
     static readonly AGENT: XrVariableScopeType;
     static readonly BROADCAST_MSG: XrVariableScopeType;
+    static readonly SCENE: XrVariableScopeType;
+    static readonly MODULE: XrVariableScopeType;
+    static readonly FUNC: XrVariableScopeType;
+    static readonly EVENT: XrVariableScopeType;
 }
 /**
  * 单个变量作用域
@@ -72,16 +99,18 @@ export declare class XrVariableScope {
     ownerId: string;
     variableList: XrVariable[];
 }
-export declare type XrTypedValueMode = 'literal' | 'variable';
+export declare type XrTypedValueMode = 'literal' | 'variable' | 'call';
 export declare class XrTypedValueModeDefine {
     static readonly LITERAL: XrTypedValueMode;
     static readonly VARIABLE: XrTypedValueMode;
+    static readonly CALL: XrTypedValueMode;
 }
 export declare class XrTypedValue<T = any> {
     mode: XrTypedValueMode;
     literal?: T;
     variableScope?: XrVariableScopeType;
     variableKey?: string;
+    callAction?: any;
 }
 /**
  * 变量目标（写变量时用）

package/dist/src/model/vr/xr-program.d.ts

@@ -0,0 +1,148 @@
+import { MultiLanguageStr, VRTalkBaseData } from '../general';
+import { XrVariable, XrVariableType } from './xr-logic';
+import type { XrAnyAction } from './vr-action';
+/**
+ * ============================================================
+ * 可视化编程系统 —— 程序组织模型（plan §4.4 / §4.6 / §4.8 / §4.9 / §4.3⑥）
+ * ============================================================
+ *
+ * 层级（方案甲·经典分层）：
+ *   VrContentData
+ *     ├─ sharedVariableList            共享变量（跨场景单例，已有）
+ *     ├─ customClassList               自定义类（全局类型库，plan §1.39）
+ *     ├─ sharedFunctionList            公共函数库（共享层，任意场景可调，plan §1.27/§1.35）
+ *     ├─ entityHandlerBindingList      实体↔handler 关联（VB code-behind，plan §4.9）
+ *     └─ programSceneList              场景（真隔离逻辑，多场景并发，plan §4.8）
+ *          └─ XrProgramScene
+ *               ├─ sceneVariableList   场景变量（场景内所有模块可见）
+ *               └─ moduleList          模块（.java 式；模块变量私有，plan §1.15）
+ *                    └─ XrProgramModule
+ *                         ├─ moduleVariableList
+ *                         ├─ listenerList     声明式监听器
+ *                         ├─ functionList     函数（调用即返回，plan §4.6）
+ *                         ├─ subprogramList   常驻子程序（有生命周期，plan §4.6）
+ *                         └─ folderList       可选的组织文件夹（plan §1.40）
+ *
+ * 说明：动作体暂用 XrAnyAction[]（现有 AST）；后续 Block AST 演进自 XrAnyAction，向后兼容。
+ */
+/** 顶层「场景」——真隔离的逻辑工程，多个可并发运行，仅隔离逻辑（空间内容各场景共用，plan §1.6/§1.13） */
+export declare class XrProgramScene extends VRTalkBaseData {
+    name: MultiLanguageStr;
+    remark: string;
+    autoStart: boolean;
+    sceneVariableList: XrVariable[];
+    onStartActionList: XrAnyAction[];
+    onStopActionList: XrAnyAction[];
+    onPauseActionList: XrAnyAction[];
+    onResumeActionList: XrAnyAction[];
+    moduleList: XrProgramModule[];
+}
+/** 场景内「模块」——类似一个 .java 文件；模块变量私有，跨模块调用公开函数（plan §1.15） */
+export declare class XrProgramModule extends VRTalkBaseData {
+    name: MultiLanguageStr;
+    remark: string;
+    moduleVariableList: XrVariable[];
+    listenerList: XrProgramListener[];
+    functionList: XrProgramFunction[];
+    subprogramList: XrSubprogram[];
+    folderList: XrProgramFolder[];
+    sortMode: 'by-type' | 'by-name';
+}
+/** 模块内的组织文件夹（纯 UI 分组，plan §1.40） */
+export declare class XrProgramFolder extends VRTalkBaseData {
+    name: string;
+    parentFolderId: string;
+}
+/** 对象.事件 的引用（监听器订阅的目标；plan §4.1 receiver + eventName） */
+export declare class XrEventRef {
+    from: 'picker' | 'variable';
+    typeKey: string;
+    entityId: string;
+    entityParentPath: string[];
+    variableScope: string;
+    variableKey: string;
+    eventName: string;
+}
+/** 声明式监听器（= VrSignalTrigger 泛化；加载即注册。动态监听器由 addListener action 运行时创建，不在此列） */
+export declare class XrProgramListener extends VRTalkBaseData {
+    name: MultiLanguageStr;
+    remark: string;
+    folderId: string;
+    event: XrEventRef;
+    localVariableList: XrVariable[];
+    bodyActionList: XrAnyAction[];
+}
+/** 函数参数（类型可为任意 XrVariableType，含对象/自定义类；plan §4.6） */
+export declare class XrProgramFunctionParam {
+    key: string;
+    name: MultiLanguageStr;
+    type: XrVariableType;
+    entityRefTypeKey?: string;
+    listElementType?: XrVariableType;
+    listElementRefTypeKey?: string;
+    listElementCustomClassId?: string;
+    customClassId?: string;
+}
+/** 函数可见性（plan §1.27/§1.35）：共享=公共(任意场景可调) / 场景=同场景可调 / 模块=私有 */
+export declare type XrProgramVisibility = 'shared' | 'scene' | 'module';
+export declare class XrProgramVisibilityDefine {
+    static readonly SHARED: XrProgramVisibility;
+    static readonly SCENE: XrProgramVisibility;
+    static readonly MODULE: XrProgramVisibility;
+}
+/** 函数 / 配方（调用即返回、带参、带返回值、可复用；plan §4.6）。也用作自定义类的实例方法/静态方法。 */
+export declare class XrProgramFunction extends VRTalkBaseData {
+    name: MultiLanguageStr;
+    remark: string;
+    folderId: string;
+    visibility: XrProgramVisibility;
+    paramList: XrProgramFunctionParam[];
+    localVariableList: XrVariable[];
+    bodyActionList: XrAnyAction[];
+    returnType?: XrVariableType;
+    returnEntityRefTypeKey?: string;
+    returnCustomClassId?: string;
+}
+/** 常驻子程序（子应用）——有生命周期（启动/停止，可暂停/恢复），持有自己注册的监听器，被叫停时整体回收（plan §4.6/§1.5/§1.35，只属于场景）。 */
+export declare class XrSubprogram extends VRTalkBaseData {
+    name: MultiLanguageStr;
+    remark: string;
+    folderId: string;
+    autoStart: boolean;
+    paramList: XrProgramFunctionParam[];
+    localVariableList: XrVariable[];
+    onStartActionList: XrAnyAction[];
+    onStopActionList: XrAnyAction[];
+    onPauseActionList: XrAnyAction[];
+    onResumeActionList: XrAnyAction[];
+}
+/** 自定义类的字段 */
+export declare class XrCustomClassField {
+    key: string;
+    name: MultiLanguageStr;
+    type: XrVariableType;
+    entityRefTypeKey?: string;
+    listElementType?: XrVariableType;
+    listElementRefTypeKey?: string;
+    listElementCustomClassId?: string;
+    customClassId?: string;
+    defaultValue?: any;
+}
+/** 用户自定义类（可 new 多个实例，也可标记为全局单例；支持实例字段/实例方法/静态方法；自定义类之间可继承） */
+export declare class XrCustomClass extends VRTalkBaseData {
+    name: MultiLanguageStr;
+    remark: string;
+    extendsCustomClassId: string;
+    isSingleton: boolean;
+    fieldList: XrCustomClassField[];
+    instanceMethodList: XrProgramFunction[];
+    staticMethodList: XrProgramFunction[];
+}
+export declare class XrEntityHandlerBinding extends VRTalkBaseData {
+    entityTypeKey: string;
+    entityId: string;
+    entityParentPath: string[];
+    eventName: string;
+    handlerFunctionId: string;
+    sceneId: string;
+}

package/dist/src/model/vr/xr-ray-hitter.d.ts

@@ -0,0 +1,49 @@
+import { Color, Vector3, VRTalkBaseData } from '../general';
+/**
+ * 射线命中器 - 检测面
+ * 扁圆柱只有上下两个圆面有检测意义（侧面永不参与检测）
+ */
+export declare type RayHitterDetectFace = 'top' | 'bottom' | 'both';
+export declare class RayHitterDetectFaceDefine {
+    static readonly TOP: RayHitterDetectFace;
+    static readonly BOTTOM: RayHitterDetectFace;
+    static readonly BOTH: RayHitterDetectFace;
+}
+/**
+ * 射线命中器 - 单个圆面的独立配置
+ * 距离+角度双门槛的语义：以该圆面为上底、按 maxTiltDeg 张开的锥体/球面区域——
+ * 相机必须位于圆面法线夹角 ≤ maxTiltDeg 的方向内，且沿射线距离在 [distanceMin, distanceMax] 内，
+ * 停留计时才会累计；门槛不符时准星旁提示（过近/过远/角度太偏）且不计时
+ */
+export declare class RayHitterFaceConfig {
+    distanceMin: number;
+    distanceMax: number;
+    maxTiltDeg: number;
+    iconUrl: string;
+}
+/**
+ * 射线命中器（独立实体，不是装修组件）——扁圆柱，准星停留触发
+ *
+ * 存 vrContentData.rayHitterList，console 在「内容设置」板块管理（照空间围栏的独立实体模式），
+ * 运行时由 XrRayHitterEngine 独立渲染与驱动，不走装修组件工厂/组件运行时状态体系。
+ *
+ * 运行时行为：
+ * - 全系统同时只能激活一个；未激活不显示（编辑器摆放时恒显）
+ * - 由 ray_hitter_activate / ray_hitter_deactivate action 控制激活
+ * - 激活期间屏幕正中显示准星；准星射线命中检测面并通过该面距离+角度双门槛后开始停留计时+进度环，
+ *   移开重置；计满按命中面发 ray_hitter_top_triggered / ray_hitter_bottom_triggered 信号
+ *   （上/下圆面各自独立的触发器 actionList），任一面完成都自动取消整个命中器的激活
+ */
+export declare class XrRayHitter extends VRTalkBaseData {
+    name: string;
+    description: string;
+    position: Vector3;
+    rotation: Vector3;
+    radius: number;
+    height: number;
+    detectFace: RayHitterDetectFace;
+    dwellTriggerMs: number;
+    color: Color;
+    topFace: RayHitterFaceConfig;
+    bottomFace: RayHitterFaceConfig;
+}

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

@@ -22,6 +22,7 @@ export * from './parent-com-command-trimmer';
 export * from './parent-com-command-sticker';
 export * from './parent-com-command-ui';
 export * from './parent-com-command-wormhole';
+export * from './parent-com-command-ray-hitter';
 export * from './parent-com-command-space-fence';
 export * from './parent-com-command-monitor';
 export * from './parent-com-command-message-card';

package/dist/src/parent/com-command/parent-com-command-ray-hitter.d.ts

@@ -0,0 +1,11 @@
+import { VRTalkEditablePlayer } from '../vrtalk-editable-player';
+import { VrComponentControllerType, XrRayHitter } from '@/model';
+export declare class ParentComCommandRayHitter {
+    private player;
+    constructor(player: VRTalkEditablePlayer);
+    sendCreate(rayHitterData: XrRayHitter): void;
+    sendUpdate(rayHitterData: XrRayHitter): void;
+    sendDelete(rayHitterId: string): void;
+    sendControllerModify(controllerType: VrComponentControllerType, rayHitterId: string): void;
+    sendEditingStateUpdate(editingState: boolean): void;
+}

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

@@ -14,6 +14,7 @@ export * from './parent-com-message-target';
 export * from './parent-com-message-trimmer';
 export * from './parent-com-message-sticker';
 export * from './parent-com-message-wormhole';
+export * from './parent-com-message-ray-hitter';
 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-ray-hitter.d.ts

@@ -0,0 +1,8 @@
+import { VRTalkEditablePlayer } from '../vrtalk-editable-player';
+import { XrRayHitter } from '@/model';
+export declare class ParentComMessageRayHitter {
+    private player;
+    constructor(player: VRTalkEditablePlayer);
+    onUpdate(callback: (rayHitterData: XrRayHitter) => void): void;
+    onClick(callback: (rayHitterId: string) => 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, 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';
+import { ParentComCommandAssetLabel, ParentComCommandAssetPointMark, ParentComCommandAssetVolumeMark, ParentComCommandAudio, ParentComCommandCamera, ParentComCommandComponent, ParentComCommandCover, ParentComCommandFloor, ParentComCommandFov, ParentComCommandInformation, ParentComCommandInfoTemplate, ParentComCommandLayer, ParentComCommandLight, ParentComCommandMarker, ParentComCommandNavigation, ParentComCommandObstacle, ParentComCommandPlayer, ParentComCommandRayHitter, 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, ParentComMessageRayHitter, ParentComMessageRenderer, ParentComMessageSpaceFence, ParentComMessageSticker, ParentComMessageSweep, ParentComMessageTarget, ParentComMessageTrimmer, ParentComMessageWormhole, ParentComMessageDollyPath, ParentComMessagePathDesign } from './com-message';
 export declare class VRTalkEditablePlayer {
     serviceRegion: string;
     iframeElement: HTMLIFrameElement | null;
@@ -23,6 +23,7 @@ export declare class VRTalkEditablePlayer {
     messageAssetVolumeMark: ParentComMessageAssetVolumeMark;
     messageTarget: ParentComMessageTarget;
     messageWormhole: ParentComMessageWormhole;
+    messageRayHitter: ParentComMessageRayHitter;
     messageSpaceFence: ParentComMessageSpaceFence;
     messageDollyPath: ParentComMessageDollyPath;
     messagePathDesign: ParentComMessagePathDesign;
@@ -50,6 +51,7 @@ export declare class VRTalkEditablePlayer {
     commandAudio: ParentComCommandAudio;
     commandTarget: ParentComCommandTarget;
     commandWormhole: ParentComCommandWormhole;
+    commandRayHitter: ParentComCommandRayHitter;
     commandSpaceFence: ParentComCommandSpaceFence;
     commandMonitor: ParentComCommandMonitor;
     commandMessageCard: ParentComCommandMessageCard;

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

@@ -23,6 +23,7 @@ export * from './player-com-command-trimmer';
 export * from './player-com-command-sticker';
 export * from './player-com-command-ui';
 export * from './player-com-command-wormhole';
+export * from './player-com-command-ray-hitter';
 export * from './player-com-command-space-fence';
 export * from './player-com-command-monitor';
 export * from './player-com-command-message-card';

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

@@ -0,0 +1,8 @@
+import { VrComponentControllerType, XrRayHitter } from '@/model';
+export declare class PlayerComCommandRayHitter {
+    onCreate(callback: (rayHitterData: XrRayHitter) => void): void;
+    onUpdate(callback: (rayHitterData: XrRayHitter) => void): void;
+    onDelete(callback: (rayHitterId: string) => void): void;
+    onControllerModify(callback: (controllerType: VrComponentControllerType, rayHitterId: string) => void): void;
+    onEditingStateUpdate(callback: (editingState: boolean) => 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_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 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_ray_hitter_create' | 'vrtalk_cmd_ray_hitter_update' | 'vrtalk_cmd_ray_hitter_delete' | 'vrtalk_cmd_ray_hitter_controller' | 'vrtalk_cmd_ray_hitter_editing_state_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;
@@ -73,6 +73,11 @@ export declare class PlayerComCommandTypeDefine {
     static readonly SPACE_FENCE_EDITING_STATE_UPDATE: PlayerComCommandType;
     static readonly SPACE_FENCE_GROUP_VISIBLE_UPDATE: PlayerComCommandType;
     static readonly SPACE_FENCE_GROUP_COLOR_UPDATE: PlayerComCommandType;
+    static readonly RAY_HITTER_CREATE: PlayerComCommandType;
+    static readonly RAY_HITTER_UPDATE: PlayerComCommandType;
+    static readonly RAY_HITTER_DELETE: PlayerComCommandType;
+    static readonly RAY_HITTER_CONTROLLER_MODIFY: PlayerComCommandType;
+    static readonly RAY_HITTER_EDITING_STATE_UPDATE: PlayerComCommandType;
     static readonly WORMHOLE_CREATE: PlayerComCommandType;
     static readonly WORMHOLE_UPDATE: PlayerComCommandType;
     static readonly WORMHOLE_DELETE: PlayerComCommandType;

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

@@ -15,6 +15,7 @@ export * from './player-com-message-sweep';
 export * from './player-com-message-target';
 export * from './player-com-message-trimmer';
 export * from './player-com-message-wormhole';
+export * from './player-com-message-ray-hitter';
 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-ray-hitter.d.ts

@@ -0,0 +1,5 @@
+import { XrRayHitter } from '../../model';
+export declare class PlayerComMessageRayHitter {
+    sendUpdate(rayHitterData: XrRayHitter): void;
+    sendOnClick(rayHitterId: string): 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_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_path_design_param_update' | '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_ray_hitter_update' | 'vrtalk_msg_ray_hitter_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_path_design_param_update' | '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;
@@ -29,6 +29,8 @@ export declare class PlayerComMessageTypeDefine {
     static readonly OBSTACLE_ON_CLICK: PlayerComMessageType;
     static readonly SPACE_FENCE_UPDATE: PlayerComMessageType;
     static readonly SPACE_FENCE_ON_CLICK: PlayerComMessageType;
+    static readonly RAY_HITTER_UPDATE: PlayerComMessageType;
+    static readonly RAY_HITTER_ON_CLICK: PlayerComMessageType;
     static readonly WORMHOLE_UPDATE: PlayerComMessageType;
     static readonly WORMHOLE_ON_CLICK: PlayerComMessageType;
     static readonly ASSET_LABEL_UPDATE: 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, 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 { PlayerComCommand, PlayerComCommandAssetLabel, PlayerComCommandAssetPointMark, PlayerComCommandAssetVolumeMark, PlayerComCommandAudio, PlayerComCommandCamera, PlayerComCommandComponent, PlayerComCommandCover, PlayerComCommandFloor, PlayerComCommandFov, PlayerComCommandInformation, PlayerComCommandInfoTemplate, PlayerComCommandLayer, PlayerComCommandLight, PlayerComCommandMarker, PlayerComCommandNavigation, PlayerComCommandObstacle, PlayerComCommandPlayer, PlayerComCommandRayHitter, 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, PlayerComMessageRayHitter, PlayerComMessageRenderer, PlayerComMessageSpaceFence, PlayerComMessageSticker, PlayerComMessageSweep, PlayerComMessageTarget, PlayerComMessageTrimmer, PlayerComMessageWormhole, PlayerComMessageDollyPath, PlayerComMessagePathDesign } from './com-message';
 import { PlayerComCommandSweep } from './com-command/player-com-command-sweep';
 /**
  * Player控制器
@@ -31,6 +31,7 @@ export declare class PlayerController {
     static commandAssetVolumeMark: PlayerComCommandAssetVolumeMark;
     static commandTarget: PlayerComCommandTarget;
     static commandWormhole: PlayerComCommandWormhole;
+    static commandRayHitter: PlayerComCommandRayHitter;
     static commandSpaceFence: PlayerComCommandSpaceFence;
     static commandMonitor: PlayerComCommandMonitor;
     static commandMessageCard: PlayerComCommandMessageCard;
@@ -53,6 +54,7 @@ export declare class PlayerController {
     static messageAssetVolumeMark: PlayerComMessageAssetVolumeMark;
     static messageTarget: PlayerComMessageTarget;
     static messageWormhole: PlayerComMessageWormhole;
+    static messageRayHitter: PlayerComMessageRayHitter;
     static messageSpaceFence: PlayerComMessageSpaceFence;
     static messageDollyPath: PlayerComMessageDollyPath;
     static messagePathDesign: PlayerComMessagePathDesign;