model-action 1.0.24 → 2.0.0

package/src/modules/Camera.ts

@@ -0,0 +1,175 @@
+/**
+ * 相机操作方法
+ */
+import { Action, SendParam } from "./Action";
+
+// 相机视角信息
+export interface CameraViewInfo {
+    location?: string;      // 相机坐标，格式 "X=-2133.518,Y=-7095.674,Z=-1550.000"
+    rotation?: string;      // 相机旋转，格式 "P=-35.004208,Y=113.576096,R=0.000000"
+    armLength?: number;     // 相机臂长（用于调整视角的远近）
+    fov?: number;           // 相机视场角（选填）
+}
+
+// 相机视角操作类型
+type CameraViewActionType = 'get' | 'set' | 'default' | 'save' | 'flyTo';
+
+type CameraViewType = SendParam & {
+    cmd: "cameraView";
+    data: {
+        action: CameraViewActionType;
+        tag?: string;           // 保存视角的唯一标识
+        location?: string;      // 相机坐标
+        rotation?: string;      // 相机旋转
+        armLength?: number;     // 相机臂长
+        fov?: number;           // 相机视场角
+    };
+}
+
+export class CameraAction extends Action {
+    /**
+     * 获取当前视角的信息，位置，旋转和臂长还有相机的视域角
+     */
+    static get() {
+        const data: {
+            action: 'get';
+        } = {
+            action: 'get'
+        };
+
+        const param: CameraViewType = {
+            cmd: "cameraView",
+            data
+        };
+
+        this.sendParam(param, '获取当前视角信息');
+    }
+
+    /**
+     * 设置视角，并飞过去
+     * @param viewInfo 视角信息
+     */
+    static set(viewInfo: CameraViewInfo) {
+        const data: {
+            action: 'set';
+            location?: string;
+            rotation?: string;
+            armLength?: number;
+            fov?: number;
+        } = {
+            action: 'set'
+        };
+
+        // 如果提供了 location，则添加
+        if (viewInfo.location) {
+            data.location = viewInfo.location;
+        }
+
+        // 如果提供了 rotation，则添加
+        if (viewInfo.rotation) {
+            data.rotation = viewInfo.rotation;
+        }
+
+        // 如果提供了 armLength，则添加
+        if (viewInfo.armLength !== undefined) {
+            data.armLength = viewInfo.armLength;
+        }
+
+        // 如果提供了 fov，则添加
+        if (viewInfo.fov !== undefined) {
+            data.fov = viewInfo.fov;
+        }
+
+        const param: CameraViewType = {
+            cmd: "cameraView",
+            data
+        };
+
+        this.sendParam(param, '设置视角并飞过去');
+    }
+
+    /**
+     * 切换到默认视角
+     */
+    static default() {
+        const data: {
+            action: 'default';
+        } = {
+            action: 'default'
+        };
+
+        const param: CameraViewType = {
+            cmd: "cameraView",
+            data
+        };
+
+        this.sendParam(param, '切换到默认视角');
+    }
+
+    /**
+     * 保存视角
+     * @param tag 保存视角的唯一标识
+     * @param viewInfo 视角信息
+     */
+    static save(tag: string, viewInfo: CameraViewInfo) {
+        const data: {
+            action: 'save';
+            tag: string;
+            location?: string;
+            rotation?: string;
+            armLength?: number;
+            fov?: number;
+        } = {
+            action: 'save',
+            tag
+        };
+
+        // 如果提供了 location，则添加
+        if (viewInfo.location) {
+            data.location = viewInfo.location;
+        }
+
+        // 如果提供了 rotation，则添加
+        if (viewInfo.rotation) {
+            data.rotation = viewInfo.rotation;
+        }
+
+        // 如果提供了 armLength，则添加
+        if (viewInfo.armLength !== undefined) {
+            data.armLength = viewInfo.armLength;
+        }
+
+        // 如果提供了 fov，则添加
+        if (viewInfo.fov !== undefined) {
+            data.fov = viewInfo.fov;
+        }
+
+        const param: CameraViewType = {
+            cmd: "cameraView",
+            data
+        };
+
+        this.sendParam(param, `保存视角 - tag: ${tag}`);
+    }
+
+    /**
+     * 飞向tag标识的视角
+     * @param tag 视角的唯一标识（需要提前使用save保存）
+     */
+    static flyTo(tag: string) {
+        const data: {
+            action: 'flyTo';
+            tag: string;
+        } = {
+            action: 'flyTo',
+            tag
+        };
+
+        const param: CameraViewType = {
+            cmd: "cameraView",
+            data
+        };
+
+        this.sendParam(param, `飞向视角 - tag: ${tag}`);
+    }
+}

package/src/modules/Environment.ts

@@ -0,0 +1,81 @@
+/**
+ * 场景环境操作方法
+ */
+import { Action, SendParam } from "./Action";
+
+type EnvironmentActionType = 'DayNight' | 'Weather' | 'Time'
+
+type EnvironmentType = SendParam & {
+    cmd: "environment";
+    data: {
+        action: EnvironmentActionType;
+        type: string;
+        [key: string]: any;
+    };
+}
+
+export class EnvironmentAction extends Action {
+    /**
+     * 昼夜切换
+     * @param type 0 = 白天，1 = 夜晚
+     */
+    static dayNight(type: "0" | "1") {
+        const data: {
+            action: 'DayNight';
+            type: string;
+        } = {
+            action: 'DayNight',
+            type
+        };
+
+        const param: EnvironmentType = {
+            cmd: "environment",
+            data
+        };
+        
+        const dayNightDesc = type === '0' ? '白天' : '夜晚';
+        this.sendParam(param, `昼夜切换 - ${dayNightDesc}`)
+    }
+
+    /**
+     * 天气切换
+     * @param type 天气类型：晴、阴、小雨、大雨、小雪、大雪、雾
+     */
+    static weather(type: string) {
+        const data: {
+            action: 'Weather';
+            type: string;
+        } = {
+            action: 'Weather',
+            type
+        };
+
+        const param: EnvironmentType = {
+            cmd: "environment",
+            data
+        };
+        
+        this.sendParam(param, `天气切换 - ${type}`)
+    }
+
+    /**
+     * 时间切换
+     * @param type 时间格式，如 "12:00"
+     */
+    static time(type: string) {
+        const data: {
+            action: 'Time';
+            type: string;
+        } = {
+            action: 'Time',
+            type
+        };
+
+        const param: EnvironmentType = {
+            cmd: "environment",
+            data
+        };
+        
+        this.sendParam(param, `时间切换 - ${type}`)
+    }
+}

package/src/modules/Focus.ts

@@ -0,0 +1,33 @@
+/**
+ * 聚焦操作方法
+ */
+import { Action } from "./Action";
+
+type FocusType = {
+    cmd: "focus";
+    data: {
+        id: string;
+    };
+}
+
+export class FocusAction extends Action {
+    /**
+     * 飞到指定ID的物体附近
+     * @param id 物体的ID（如POI、模型等）
+     */
+    static focus(id: string) {
+        const data: {
+            id: string;
+        } = {
+            id
+        };
+
+        const param: FocusType = {
+            cmd: "focus",
+            data
+        };
+
+        // 注意：focus 命令不需要 action 字段，直接发送参数
+        this.sendParam(param as any, `飞到指定物体附近 - id: ${id}`);
+    }
+}

package/src/modules/Poi.ts

@@ -1,168 +1,245 @@
-
 /**
  * POI点方法
  */
-import { Action, LocationItem, RequiredSome, SendParam } from "./Action";
-
-type PoiActionType = 'show' | 'hide' | 'add' | 'delete' | 'update' | 'getInfo' | 'status'
-type PoiType = {
-    action: PoiActionType,          //方法
-    id?: string,                //POI点UE中的ID
-    type?: string,              //POI类型
-    typeChild?: string,         //POI子类型
-    text?: string,              //POI标题
-    location?: LocationItem,        //POI在场景中的坐标格式
-    place?: string,              //POI所在位置
-    description?: string,        //POI描述
-    linkId?: string,             //POI关联设备ID
-    floorNum?: string,           //总楼层
-    lowestFloor?: string,         //最低楼层
-    state?: 'normal' | 'alarm'
-} & SendParam
-
-type IdList = Array<{
-    id: string;
-    state: 'normal' | 'alarm'
-}>
+import { Action, SendParam } from "./Action";
+
+type PoiActionType = 'show' | 'hide' | 'showAll' | 'hideAll' | 'add' | 'remove' | 'update' | 'find'
+
+// POI基础信息
+export interface PoiBaseInfo {
+    id: string;             // POI的ID
+    type: string;           // POI类型，如 "Camera"
+    label: string;          // 标签
+    location: string;        // 位置，格式 "X=0.0,Y=0.0,Z=0.0"
+    rotation: string;       // 旋转，格式 "P=-35.004208,Y=113.576096,R=0.000000"
+    scale: number;          // 缩放
+    place: string;          // 地方
+    linkId: string;         // 链接ID
+    category: string;       // 分类，如 "Camera"
+    description: string;     // 描述
+    hasMesh: boolean;       // 是否有网格
+}
+
+// POI更新信息（不包含type字段）
+export type PoiUpdateInfo = Omit<PoiBaseInfo, 'type'>
+
+type PoiType = SendParam & {
+    cmd: "POI";
+    data: {
+        action: PoiActionType;
+        [key: string]: any;
+    };
+}
 
 export class PoiAction extends Action {
     /**
-      * 添加poi
-      * @param {*} type 相机type
-      * @param {*} location poi点位置
-      * @param {*} text POI标题
-      * @param {*} place POI所在位置
-      * @param {*} description POI描述
-      * @param {*} linkId POI关联的设备ID
-      */
-    static poiAdd(type: PoiType['type'] = 'Camera', location: LocationItem, text: PoiType['text'] = '', place: PoiType['place'] = '', description: PoiType['description'] = '', linkId: PoiType['linkId'] = '') {
-        const param: RequiredSome<PoiType, 'action' | 'type' | 'location'> = {
+     * 显隐指定id的POI
+     * @param action 操作类型：show 显示 | hide 隐藏
+     * @param id POI的ID
+     */
+    static poiShowHide(
+        action: 'show' | 'hide',
+        id: string
+    ) {
+        const data: {
+            action: 'show' | 'hide';
+            id: string;
+        } = {
+            action,
+            id
+        };
+
+        const param: PoiType = {
             cmd: "POI",
-            action: "add",
-            type,
-            text,
-            location,
-            place,
-            description,
-            linkId
-        };
-        this.sendParam(param, '新增POI')
+            data
+        };
+        
+        const actionMap = {
+            show: '显示指定POI',
+            hide: '隐藏指定POI'
+        };
+        this.sendParam(param, actionMap[action])
     }
 
     /**
-     * 更新poi
-     * @param {*} type 相机type
-     * @param {*} location poi点位置
-     * @param {*} text POI标题
-     * @param {*} place POI所在位置
-     * @param {*} description POI描述
-     * @param {*} linkId POI关联的设备ID
+     * 显隐指定类型和地方的POI
+     * @param action 操作类型：show 显示 | hide 隐藏
+     * @param type POI类型，如 "Camera"、"JK" 等
+     * @param place 地方，如 "A_1F"，如果不传place字段，三维自动判断是显示楼里的还是楼外的
      */
-    static poiUpdate(type: PoiType['type'] = 'Camera', location: LocationItem, text: PoiType['text'] = '', place: PoiType['place'] = '', description: PoiType['description'] = '', linkId: PoiType['linkId'] = '') {
-        const param: RequiredSome<PoiType, 'action' | 'type' | 'location'> = {
+    static poiShowHideByType(
+        action: 'show' | 'hide',
+        type: string,
+        place?: string
+    ) {
+        const data: {
+            action: 'show' | 'hide';
+            type: string;
+            place?: string;
+        } = {
+            action,
+            type
+        };
+
+        // 如果提供了 place，则添加
+        if (place) {
+            data.place = place;
+        }
+
+        const param: PoiType = {
             cmd: "POI",
-            action: "update",
-            type,
-            text,
-            location,
-            place,
-            description,
-            linkId
-        };
-        this.sendParam(param, '更新POI')
+            data
+        };
+        
+        const actionMap = {
+            show: '显示指定类型POI',
+            hide: '隐藏指定类型POI'
+        };
+        this.sendParam(param, actionMap[action])
     }
 
     /**
-    * 删除poi
-    * @param {*} id 点ID
-    */
-    static poiDel(id: string) {
+     * 显示所有POI
+     */
+    static poiShowAll() {
+        const data: {
+            action: 'showAll';
+        } = {
+            action: 'showAll'
+        };
+
         const param: PoiType = {
             cmd: "POI",
-            action: "delete",
-            id,
+            data
         };
-        this.sendParam(param, '删除POI')
+        this.sendParam(param, '显示所有POI')
     }
 
     /**
-     * 显示poi
-     * @param {*} id POI的ID
-     * @param {*} type 相机type
-     * @param {*} place POI所在位置
+     * 隐藏所有POI
      */
-    static poiShow(id: PoiType['id'], type: PoiType['type'], place: PoiType['place']) {
+    static poiHideAll() {
+        const data: {
+            action: 'hideAll';
+        } = {
+            action: 'hideAll'
+        };
+
         const param: PoiType = {
             cmd: "POI",
-            action: "show",
-            type,
-            place
+            data
         };
-        if (id) {
-            param['id'] = id
-        }
-
-        this.sendParam(param, '显示POI')
+        this.sendParam(param, '隐藏所有POI')
     }
 
     /**
-    * 隐藏poi
-    * @param {*} id POI的ID
-    * @param {*} type 相机type
-    * @param {*} place POI所在位置
-    */
-    static poiHide(id: PoiType['id'], type: PoiType['type'], place: PoiType['place']) {
+     * 添加POI点
+     * @param baseInfos POI基础信息数组
+     */
+    static poiAdd(baseInfos: PoiBaseInfo[]) {
+        const data: {
+            action: 'add';
+            baseInfos: PoiBaseInfo[];
+        } = {
+            action: 'add',
+            baseInfos
+        };
+
         const param: PoiType = {
             cmd: "POI",
-            action: "hide",
-            type,
-            place
+            data
         };
-        if (id) {
-            param['id'] = id
-        }
-
-        this.sendParam(param, '隐藏POI')
+        this.sendParam(param, '添加POI点')
     }
 
     /**
-     * 把所有的POI恢复到Normal状态
-     * @param {*} state normal一般状态 alarm 告警状态
+     * 删除POI点
+     * @param id POI的ID、linkId或type，根据传入的值删除对应的POI
      */
-    static poiNormal(state: 'normal' | 'alarm') {
+    static poiRemove(id: string) {
+        const data: {
+            action: 'remove';
+            id: string;
+        } = {
+            action: 'remove',
+            id
+        };
+
         const param: PoiType = {
             cmd: "POI",
-            action: "status",
-            state
+            data
         };
-        this.sendParam(param, `恢复poi至${state}状态`)
+        this.sendParam(param, '删除POI点')
     }
 
     /**
-     * 切换指定ID设备的poi状态
-     * @param {*} ids 设备ID列表
-     * @param {*} isLocation 是否定位到第一个ID对应的设备
+     * 更新POI点
+     * @param baseInfos POI更新信息数组（不包含type字段）
      */
-    static poiSwitchStatus(ids: IdList, isLocation: boolean = false) {
-        const param = {
-            cmd: "status",
-            isLocation,
-            type: 'POI',
-            ids
-        }
-        this.sendParam(param, `切换poi至指定状态`)
+    static poiUpdate(baseInfos: PoiUpdateInfo[]) {
+        const data: {
+            action: 'update';
+            baseInfos: PoiUpdateInfo[];
+        } = {
+            action: 'update',
+            baseInfos
+        };
+
+        const param: PoiType = {
+            cmd: "POI",
+            data
+        };
+        this.sendParam(param, '更新POI点')
     }
 
     /**
-     * 获取指定POI
-     * @param {*} type 相机type
+     * 获取POI点信息
+     * @param id 可选，POI的ID，如果提供则获取指定ID的POI信息
+     * @param type 可选，POI类型，如 "Camera"，如果提供则获取指定类型的POI信息
+     * @param place 可选，地方，如 "A_1F"，如果提供则获取指定地方指定类型的POI信息
      */
-    static poiGetInfo(type: PoiType['type'] = 'Camera') {
+    static poiFind(id?: string, type?: string, place?: string) {
+        const data: {
+            action: 'find';
+            id?: string;
+            type?: string;
+            place?: string;
+        } = {
+            action: 'find'
+        };
+
+        // 如果提供了 id，则添加
+        if (id) {
+            data.id = id;
+        }
+
+        // 如果提供了 type，则添加
+        if (type) {
+            data.type = type;
+        }
+
+        // 如果提供了 place，则添加
+        if (place) {
+            data.place = place;
+        }
+
         const param: PoiType = {
             cmd: "POI",
-            action: "getInfo",
-            type,
+            data
         };
-        this.sendParam(param, '获取POI信息')
+        
+        // 根据参数组合生成不同的描述
+        let msg = '获取POI点信息';
+        if (id) {
+            msg = '获取指定ID的POI信息';
+        } else if (type && place) {
+            msg = '获取指定地方指定类型的POI信息';
+        } else if (type) {
+            msg = '获取指定类型的POI信息';
+        } else {
+            msg = '获取所有POI信息';
+        }
+        
+        this.sendParam(param, msg)
     }
 }