model-action 2.1.0 → 2.2.1

package/src/modules/SingleMesh.ts

@@ -0,0 +1,89 @@
+/**
+ * 模型单体化：将指定模型转为可操作实例，支持 init / add / remove。
+ * POI 替代方案请走 POI 接口；本接口生成的是场景内模型实例。
+ */
+import { Action, SendParam } from "./Action";
+
+export type SingleMeshOp = "init" | "add" | "remove";
+
+/**
+ * 接口使用场景区分：Normal 通用；JF 等由项目约定。
+ * 无特殊场景可不传，三维按通用处理。
+ */
+export type SingleMeshSceneType = "Normal" | "JF" | string;
+
+/** 设备模型类型，如服务器、交换机，项目约定 */
+export type SingleMeshDeviceModelType = "Service" | "Switch" | string;
+
+/** 设备类别：机柜 | 机柜内设备 等 */
+export type SingleMeshDeviceCategory = "Cabinet" | "CDevice" | string;
+
+export interface SingleMeshDevice {
+    id: string;
+    name: string;
+    type: SingleMeshDeviceModelType;
+    /** 非必须，内置可补全 */
+    category?: SingleMeshDeviceCategory;
+    /** 如机柜内设备填所属机柜 id */
+    parentId?: string;
+    parentCategory?: SingleMeshDeviceCategory;
+    /** 在父设备上的槽口，机柜内设备按项目必传 */
+    socketOnParent?: string;
+}
+
+export interface SingleMeshScene {
+    /** 场景/机房编码，项目约定；不传则当前场景 */
+    sceneCode?: string;
+    sceneName?: string;
+    devices: SingleMeshDevice[];
+}
+
+export type SingleMeshPayload =
+    | {
+          action: "add";
+          scenes: SingleMeshScene[];
+          sceneType?: SingleMeshSceneType;
+      }
+    | {
+          action: "init" | "remove";
+          scenes: SingleMeshScene[];
+      };
+
+type SingleMeshParamType = SendParam & {
+    cmd: "singleMesh";
+    data: SingleMeshPayload;
+};
+
+export class SingleMeshAction extends Action {
+    private static emit(data: SingleMeshPayload, log: string) {
+        return this.sendParam(
+            { cmd: "singleMesh", data } as SingleMeshParamType,
+            log
+        );
+    }
+
+    /** 初始化场景内单体化数据 */
+    static init(scenes: SingleMeshScene[]) {
+        return this.emit({ action: "init", scenes }, "单体化 init");
+    }
+
+    /**
+     * 增加单体化设备/模型
+     * @param sceneType 非必须；机房等特殊场景传如 JF，默认不传为通用 Normal
+     */
+    static add(scenes: SingleMeshScene[], sceneType?: SingleMeshSceneType) {
+        const data: Extract<SingleMeshPayload, { action: "add" }> = {
+            action: "add",
+            scenes
+        };
+        if (sceneType != null && sceneType !== "") {
+            data.sceneType = sceneType;
+        }
+        return this.emit(data, `单体化 add${sceneType ? ` (${sceneType})` : ""}`);
+    }
+
+    /** 移除单体化实例 */
+    static remove(scenes: SingleMeshScene[]) {
+        return this.emit({ action: "remove", scenes }, "单体化 remove");
+    }
+}

package/src/modules/Window.ts

@@ -0,0 +1,128 @@
+/**
+ * 弹框：三维内置弹框或外部弹框（返回屏幕坐标比例供前端自绘，可随锚点移动）。
+ * 内置样式需按项目单独开发，本包只负责协议与发送。
+ */
+import { Action, SendParam } from "./Action";
+
+/** create / remove / update / move */
+export type WindowCrudAction = "create" | "remove" | "update" | "move";
+
+export type WindowActionType = WindowCrudAction | "getWindowDetails";
+
+/** buildIn：三维内弹框；buildOut：前端弹框（接收屏幕坐标比例） */
+export type WindowPopType = "buildIn" | "buildOut";
+
+/** 弹框详情行：属性 / 事件 / 服务 */
+export type WindowDetailRowType = "attr" | "event" | "service";
+
+/** windowInfo.params 单项 */
+export interface WindowDetailParam {
+    /** 默认 attr；为空时三维会按 attr 处理 */
+    type?: WindowDetailRowType;
+    id?: string;
+    value?: string;
+    name?: string;
+    unit?: string;
+    textColor?: string;
+    textSize?: number;
+    /** 文本是否有背景（协议字段名如此） */
+    hasBlackground?: boolean;
+    alertIs?: boolean;
+    alertTime?: string;
+}
+
+/** 弹框主体配置 */
+export interface WindowInfo {
+    /** 设备所在场景编码，按项目约定，非必须 */
+    sceneCode?: string;
+    /** 弹框唯一 id，不传由三维生成 */
+    id?: string;
+    /** 绑定的三维资产模型 id */
+    linkAssetId?: string;
+    /** 标题 */
+    name?: string;
+    /** 设备/弹框类型 */
+    type?: string;
+    /** 世界坐标；不传则可用 linkAssetId 对应资产坐标 */
+    position?: string;
+    /** 相对锚点偏移，用于微调 */
+    localPosition?: string;
+    /** 详情内容；列表时每项一行 */
+    params?: WindowDetailParam[];
+}
+
+export type WindowPayload =
+    | {
+          action: WindowCrudAction;
+          popType: WindowPopType;
+          windowInfo: WindowInfo;
+      }
+    | {
+          action: "getWindowDetails";
+          /** 如机柜、机柜设备 */
+          type: string;
+          id: string;
+          /** 注意：与 windowInfo.sceneCode 不同，此处协议字段名为 senceCode */
+          senceCode: string;
+      };
+
+type WindowParamType = SendParam & {
+    cmd: "window";
+    data: WindowPayload;
+};
+
+export class WindowAction extends Action {
+    private static crud(
+        action: WindowCrudAction,
+        popType: WindowPopType,
+        windowInfo: WindowInfo,
+        log: string
+    ) {
+        const data: Extract<WindowPayload, { action: WindowCrudAction }> = {
+            action,
+            popType,
+            windowInfo
+        };
+        return this.sendParam(
+            { cmd: "window", data } as WindowParamType,
+            log
+        );
+    }
+
+    static createWindow(popType: WindowPopType, windowInfo: WindowInfo) {
+        return this.crud("create", popType, windowInfo, `弹框创建 - ${popType}`);
+    }
+
+    static removeWindow(popType: WindowPopType, windowInfo: WindowInfo) {
+        return this.crud("remove", popType, windowInfo, `弹框移除 - ${popType}`);
+    }
+
+    static updateWindow(popType: WindowPopType, windowInfo: WindowInfo) {
+        return this.crud("update", popType, windowInfo, `弹框更新 - ${popType}`);
+    }
+
+    static moveWindow(popType: WindowPopType, windowInfo: WindowInfo) {
+        return this.crud("move", popType, windowInfo, `弹框移动 - ${popType}`);
+    }
+
+    /**
+     * 查询弹框详情（按设备类型、设备 id、场景）
+     * @param senceCode 协议字段名与 sceneCode 拼写不一致，与三维约定保持一致
+     */
+    static getWindowDetails(
+        type: string,
+        id: string,
+        senceCode: string
+    ) {
+        const data: Extract<WindowPayload, { action: "getWindowDetails" }> = {
+            action: "getWindowDetails",
+            type,
+            id,
+            senceCode
+        };
+        return this.sendParam(
+            { cmd: "window", data } as WindowParamType,
+            `获取弹框详情 - type: ${type} id: ${id}`
+        );
+    }
+}