model-action 2.3.4 → 2.4.2

package/src/modules/SceneAsset.ts

@@ -6,12 +6,19 @@ import { Action, SendParam } from "./Action";
 /** 前端发往三维的 action */
 export type SceneAssetActionType =
     | "mapLocation"
+    | "mapPathTrack"
+    | "bindDevice"
+    | "focus"
     | "editSave"
     | "editCancel"
+    | "enableSceneEdit"
     | "disableSceneEdit";
 
-/** 资产大类：房间、POI 等 */
-export type SceneAssetType = "Room" | "POI" | string;
+/** 资产大类：房间、POI、巡更路线、路径点等 */
+export type SceneAssetType = "Room" | "POI" | "Routing" | "PathPoint" | string;
+
+/** 路线用途 */
+export type SceneAssetPathUseType = "videoPatrol" | string;
 
 /** 地图定位 — 房间在单层下的条目 */
 export interface RoomMapLocationParam {
@@ -59,17 +66,62 @@ export type SceneAssetMapLocationPayload =
         params: PoiMapLocationParam[];
     };
 
+/** 取点后搜索附近设备的参数 */
+export interface PathTrackEditParam {
+    /** 取点后搜索设备点位的半径（米） */
+    searchRangeAtPathPoint?: number;
+    /** 搜索的点位类型；不传或空默认 Camera */
+    searchDeviceType?: string;
+}
+
+/** 已有路线上的路径点（新增路线不传 points） */
+export interface PathTrackPointParam {
+    /** 点在路径上的下标，新生成时由三维返回给前端存储 */
+    id: string;
+    /** 点的坐标 */
+    location?: string;
+    /** 点关联的设备 */
+    linkId?: string;
+    /** 室外空值或省略；楼内为 `buildingId_floor` */
+    place?: string;
+}
+
+export type SceneAssetMapPathTrackPayload = {
+    action: "mapPathTrack";
+    type: "Routing";
+    /** 路线用途，如 videoPatrol = 视频巡更 */
+    useType: SceneAssetPathUseType;
+    id: string;
+    editParam?: PathTrackEditParam;
+    /** 编辑已有路线时传入；新增路线不传 */
+    points?: PathTrackPointParam[];
+};
+
 export type SceneAssetPayload =
     | SceneAssetMapLocationPayload
+    | SceneAssetMapPathTrackPayload
     | {
         action: "editSave";
+        type?: SceneAssetType;
+        /** 房间/POI 为三维 sceneId；巡更路线可不传，三维取当前编辑数据 */
+        id?: string;
+    }
+    | {
+        action: "editCancel";
+        type?: SceneAssetType;
+        id?: string;
+    }
+    | {
+        action: "bindDevice";
         type: SceneAssetType;
-        /** 三维返回的 sceneId */
+        /** 路径点 index（添加点时三维返回） */
         id: string;
+        editParam?: PathTrackEditParam;
     }
     | {
-        action: "editCancel";
+        action: "focus";
         type: SceneAssetType;
+        /** 路径点 index */
         id: string;
     }
     | {
@@ -92,18 +144,54 @@ export interface SceneAssetOnAssetSelectedData {
     location: string;
 }
 
-/** 三维推送：单个资产修改后的结果 */
+/** 三维推送：单个资产修改后的结果（房间/POI 等） */
 export interface SceneAssetOnEditAssetData {
     action: "OnEditAsset";
     type: SceneAssetType;
-    id: string;
-    sceneId: string;
+    id?: string;
+    sceneId?: string;
+    /** 路径点场景下为点的 index */
+    index?: string;
+    location: string;
+}
+
+/** 路径点附近搜索到的设备 */
+export interface PathPointLinkDevice {
+    sceneId?: string;
+    linkId: string;
+    type: string;
+    label?: string;
+}
+
+/** 三维回传的路径点信息 */
+export interface PathPointPushInfo {
+    index: string;
     location: string;
+    place?: string;
+    linkDevices?: PathPointLinkDevice[];
+}
+
+/** 三维推送：Alt+左键取路径点 */
+export interface SceneAssetOnAddPathPointData {
+    action: "OnAddPathPoint";
+    type: SceneAssetType;
+    id: string;
+    point: PathPointPushInfo;
+}
+
+/** 三维推送：路径点重绑设备结果 */
+export interface SceneAssetBindDeviceData {
+    action: "bindDevice";
+    type: SceneAssetType;
+    id: string;
+    point: PathPointPushInfo;
 }
 
 export type SceneAssetPushData =
     | SceneAssetOnAssetSelectedData
-    | SceneAssetOnEditAssetData;
+    | SceneAssetOnEditAssetData
+    | SceneAssetOnAddPathPointData
+    | SceneAssetBindDeviceData;
 
 /** 三维经 sceneAsset 推送的通用消息壳（无 requestId） */
 export interface SceneAssetPushMessage<
@@ -188,15 +276,61 @@ export class SceneAssetAction extends Action {
     }
 
     /**
-     * 前端编辑框「保存」后通知三维
-     * @param id 三维返回的 sceneId
+     * 进入巡更路线编辑。路线列表「添加」或某一行「编辑」时调用。
+     * 新增路线不传 `points`；编辑已有路线且有点数据时再传。
      */
-    static editSave(id: string, type: SceneAssetType = "Room") {
-        const data: Extract<SceneAssetPayload, { action: "editSave" }> = {
-            action: "editSave",
+    static mapPathTrack(
+        id: string,
+        editParam?: PathTrackEditParam,
+        points?: PathTrackPointParam[],
+        useType: SceneAssetPathUseType = "videoPatrol"
+    ) {
+        const data: SceneAssetMapPathTrackPayload = {
+            action: "mapPathTrack",
+            type: "Routing",
+            useType,
+            id
+        };
+        if (editParam) {
+            data.editParam = { ...editParam };
+            if (!data.editParam.searchDeviceType?.trim()) {
+                delete data.editParam.searchDeviceType;
+            }
+        }
+        if (points?.length) {
+            data.points = points;
+        }
+
+        const sendParam: SceneAssetParamType = {
+            cmd: "sceneAsset",
+            data
+        };
+        return this.sendParam(
+            sendParam,
+            `进入巡更路线编辑 - ${useType} id: ${id}${points?.length ? ` points: ${points.length}` : "（新增）"}`
+        );
+    }
+
+    /**
+     * 重新绑定路径点附近设备（已有路线上的「重绑」）
+     * @param id 路径点 index
+     */
+    static bindDevice(
+        id: string,
+        editParam?: PathTrackEditParam,
+        type: SceneAssetType = "Routing"
+    ) {
+        const data: Extract<SceneAssetPayload, { action: "bindDevice" }> = {
+            action: "bindDevice",
             type,
             id
         };
+        if (editParam) {
+            data.editParam = { ...editParam };
+            if (!data.editParam.searchDeviceType?.trim()) {
+                delete data.editParam.searchDeviceType;
+            }
+        }
 
         const sendParam: SceneAssetParamType = {
             cmd: "sceneAsset",
@@ -204,17 +338,17 @@ export class SceneAssetAction extends Action {
         };
         return this.sendParam(
             sendParam,
-            `场景资产编辑保存 - ${type} sceneId: ${id}`
+            `场景资产重绑设备 - ${type} pointIndex: ${id}`
         );
     }
 
     /**
-     * 前端编辑框「取消」后通知三维
-     * @param id 三维返回的 sceneId
+     * 定位到路径上指定 index 的点，并展示编辑轴
+     * @param id 路径点 index
      */
-    static editCancel(id: string, type: SceneAssetType = "Room") {
-        const data: Extract<SceneAssetPayload, { action: "editCancel" }> = {
-            action: "editCancel",
+    static focusPathPoint(id: string, type: SceneAssetType = "Routing") {
+        const data: Extract<SceneAssetPayload, { action: "focus" }> = {
+            action: "focus",
             type,
             id
         };
@@ -225,7 +359,51 @@ export class SceneAssetAction extends Action {
         };
         return this.sendParam(
             sendParam,
-            `场景资产编辑取消 - ${type} sceneId: ${id}`
+            `场景资产定位路径点 - ${type} pointIndex: ${id}`
+        );
+    }
+
+    /**
+     * 前端编辑框「保存」后通知三维。
+     * 巡更路线可不传 `id`，三维取当前编辑数据。
+     * @param id 三维返回的 sceneId；Routing 可省略
+     */
+    static editSave(id?: string, type: SceneAssetType = "Room") {
+        const data: Extract<SceneAssetPayload, { action: "editSave" }> = {
+            action: "editSave",
+            type
+        };
+        if (id) data.id = id;
+
+        const sendParam: SceneAssetParamType = {
+            cmd: "sceneAsset",
+            data
+        };
+        return this.sendParam(
+            sendParam,
+            `场景资产编辑保存 - ${type}${id ? ` id: ${id}` : ""}`
+        );
+    }
+
+    /**
+     * 前端编辑框「取消」后通知三维。
+     * 巡更路线可不传 `id`。
+     * @param id 三维返回的 sceneId；Routing 可省略
+     */
+    static editCancel(id?: string, type: SceneAssetType = "Room") {
+        const data: Extract<SceneAssetPayload, { action: "editCancel" }> = {
+            action: "editCancel",
+            type
+        };
+        if (id) data.id = id;
+
+        const sendParam: SceneAssetParamType = {
+            cmd: "sceneAsset",
+            data
+        };
+        return this.sendParam(
+            sendParam,
+            `场景资产编辑取消 - ${type}${id ? ` id: ${id}` : ""}`
         );
     }
 

package/src/modules/Status.ts

@@ -1,150 +1,165 @@
-/**
- * 状态操作方法
- */
-import { Action } from "./Action";
-
-// 状态信息
-export interface StatusInfo {
-    id: string;      // 唯一标识
-    state: string;   // 状态值：normal | alarm | color=FFFFFF
-}
-
-// Status命令类型（不继承SendParam，因为data中没有action字段）
-type StatusType = {
-    cmd: "status";
-    data: {
-        isLocation?: boolean;  // 是否定位到第一个ID对应的设备，默认false
-        type?: string;         // 变换状态的类型，非必须，如"POI"
-        infos: StatusInfo[];   // 要切换状态的设备的数据
-    };
-}
-
-export class StatusAction extends Action {
-    /**
-     * 切换指定ID的模型、POI等的状态
-     * @param infos 状态信息数组，包含id和state
-     * @param options 可选参数
-     * @param options.isLocation 是否定位到第一个ID对应的设备，默认false
-     * @param options.type 变换状态的类型，如"POI"
-     */
-    static statusChange(
-        infos: StatusInfo[],
-        options?: {
-            isLocation?: boolean;
-            type?: string;
-        }
-    ) {
-        const data: {
-            isLocation?: boolean;
-            type?: string;
-            infos: StatusInfo[];
-        } = {
-            infos
-        };
-
-        // 如果提供了 isLocation，则添加（默认false，所以只有为true时才添加）
-        if (options?.isLocation !== undefined) {
-            data.isLocation = options.isLocation;
-        }
-
-        // 如果提供了 type，则添加
-        if (options?.type) {
-            data.type = options.type;
-        }
-
-        const param: StatusType = {
-            cmd: "status",
-            data
-        };
-
-        // 生成描述信息
-        let msg = '切换状态';
-        if (options?.type) {
-            msg = `切换${options.type}状态`;
-        }
-        if (infos.length === 1) {
-            msg += ` - ID: ${infos[0].id}, 状态: ${infos[0].state}`;
-        } else {
-            msg += ` - 共${infos.length}个设备`;
-        }
-
-        // 使用类型断言调用sendParam，因为StatusType不严格符合SendParam（缺少action字段）
-        return this.sendParam(param as any, msg);
-    }
-
-    /**
-     * 设置设备为正常状态
-     * @param id 设备ID
-     * @param options 可选参数
-     */
-    static setNormal(
-        id: string,
-        options?: {
-            isLocation?: boolean;
-            type?: string;
-        }
-    ) {
-        this.statusChange([{ id, state: 'normal' }], options);
-    }
-
-    /**
-     * 设置设备为报警状态
-     * @param id 设备ID
-     * @param options 可选参数
-     */
-    static setAlarm(
-        id: string,
-        options?: {
-            isLocation?: boolean;
-            type?: string;
-        }
-    ) {
-        this.statusChange([{ id, state: 'alarm' }], options);
-    }
-
-    /**
-     * 设置设备颜色
-     * @param id 设备ID
-     * @param color 颜色值，格式如 "FFFFFF" 或 "93050C"（不需要#前缀）
-     * @param options 可选参数
-     */
-    static setColor(
-        id: string,
-        color: string,
-        options?: {
-            isLocation?: boolean;
-            type?: string;
-        }
-    ) {
-        // 移除可能的#前缀
-        const colorValue = color.startsWith('#') ? color.slice(1) : color;
-        this.statusChange([{ id, state: `color=${colorValue}` }], options);
-    }
-
-    /**
-     * 批量设置多个设备的状态
-     * @param statusMap 状态映射，key为设备ID，value为状态值（normal | alarm | color值）
-     * @param options 可选参数
-     */
-    static batchSetStatus(
-        statusMap: Record<string, string>,
-        options?: {
-            isLocation?: boolean;
-            type?: string;
-        }
-    ) {
-        const infos: StatusInfo[] = [];
-        for (const id in statusMap) {
-            if (statusMap.hasOwnProperty(id)) {
-                const state = statusMap[id];
-                // 如果state是颜色值（6位十六进制），自动添加color=前缀
-                let finalState = state;
-                if (/^[0-9A-Fa-f]{6}$/.test(state) && !state.startsWith('color=')) {
-                    finalState = `color=${state}`;
-                }
-                infos.push({ id, state: finalState });
-            }
-        }
-        this.statusChange(infos, options);
-    }
+/**
+ * 状态操作方法
+ */
+import { Action } from "./Action";
+
+// 状态信息
+export interface StatusInfo {
+    id: string;      // 唯一标识
+    state: string;   // 状态值：normal | alarm | color=FFFFFF
+}
+
+// Status命令类型（不继承SendParam，因为data中没有action字段）
+type StatusType = {
+    cmd: "status";
+    data: {
+        isLocation?: boolean;  // 是否定位到第一个ID对应的设备，默认false
+        type?: string;         // 变换状态的类型，非必须，如"POI"
+        infos: StatusInfo[];   // 要切换状态的设备的数据
+    };
+}
+
+export class StatusAction extends Action {
+    /**
+     * 切换指定ID的模型、POI等的状态
+     * @param infos 状态信息数组，包含id和state
+     * @param options 可选参数
+     * @param options.isLocation 是否定位到第一个ID对应的设备，默认false
+     * @param options.type 变换状态的类型，如"POI"
+     */
+    static statusChange(
+        infos: StatusInfo[],
+        options?: {
+            isLocation?: boolean;
+            type?: string;
+        }
+    ) {
+        const data: {
+            isLocation?: boolean;
+            type?: string;
+            infos: StatusInfo[];
+        } = {
+            infos
+        };
+
+        // 如果提供了 isLocation，则添加（默认false，所以只有为true时才添加）
+        if (options?.isLocation !== undefined) {
+            data.isLocation = options.isLocation;
+        }
+
+        // 如果提供了 type，则添加
+        if (options?.type) {
+            data.type = options.type;
+        }
+
+        const param: StatusType = {
+            cmd: "status",
+            data
+        };
+
+        // 生成描述信息
+        let msg = '切换状态';
+        if (options?.type) {
+            msg = `切换${options.type}状态`;
+        }
+        if (infos.length === 1) {
+            msg += ` - ID: ${infos[0].id}, 状态: ${infos[0].state}`;
+        } else {
+            msg += ` - 共${infos.length}个设备`;
+        }
+
+        // 使用类型断言调用sendParam，因为StatusType不严格符合SendParam（缺少action字段）
+        return this.sendParam(param as any, msg);
+    }
+
+    /**
+     * 设置设备为正常状态
+     * @param id 设备ID
+     * @param options 可选参数
+     */
+    static setNormal(
+        id: string,
+        options?: {
+            isLocation?: boolean;
+            type?: string;
+        }
+    ) {
+        this.statusChange([{ id, state: 'normal' }], options);
+    }
+
+    /**
+     * 设置设备为离线状态
+     * @param id 设备ID
+     * @param options 可选参数
+     */
+    static setOffline(
+        id: string,
+        options?: {
+            isLocation?: boolean;
+            type?: string;
+        }
+    ) {
+        this.statusChange([{ id, state: 'offline' }], options);
+    }
+
+    /**
+     * 设置设备为报警状态
+     * @param id 设备ID
+     * @param options 可选参数
+     */
+    static setAlarm(
+        id: string,
+        options?: {
+            isLocation?: boolean;
+            type?: string;
+        }
+    ) {
+        this.statusChange([{ id, state: 'alarm' }], options);
+    }
+
+    /**
+     * 设置设备颜色
+     * @param id 设备ID
+     * @param color 颜色值，格式如 "FFFFFF" 或 "93050C"（不需要#前缀）
+     * @param options 可选参数
+     */
+    static setColor(
+        id: string,
+        color: string,
+        options?: {
+            isLocation?: boolean;
+            type?: string;
+        }
+    ) {
+        // 移除可能的#前缀
+        const colorValue = color.startsWith('#') ? color.slice(1) : color;
+        this.statusChange([{ id, state: `color=${colorValue}` }], options);
+    }
+
+    /**
+     * 批量设置多个设备的状态
+     * @param statusMap 状态映射，key为设备ID，value为状态值（normal | alarm | color值）
+     * @param options 可选参数
+     */
+    static batchSetStatus(
+        statusMap: Record<string, string>,
+        options?: {
+            isLocation?: boolean;
+            type?: string;
+        }
+    ) {
+        const infos: StatusInfo[] = [];
+        for (const id in statusMap) {
+            if (statusMap.hasOwnProperty(id)) {
+                const state = statusMap[id];
+                // 如果state是颜色值（6位十六进制），自动添加color=前缀
+                let finalState = state;
+                if (/^[0-9A-Fa-f]{6}$/.test(state) && !state.startsWith('color=')) {
+                    finalState = `color=${state}`;
+                }
+                infos.push({ id, state: finalState });
+            }
+        }
+        this.statusChange(infos, options);
+    }
 }