@ray-js/robot-map-sdk 0.0.9-beta.4 → 0.0.9

package/dist/constant/methods.js

@@ -1 +1 @@
-const e=["areRoomsAdjacent","getForbiddenSweepZones","getForbiddenMopZones","getCleanZones","getVirtualWalls","getSpots","getWayPoints","getViewportCenterPoint","getMapCenterPoint","getWallPointsByViewportCenter","getForbiddenSweepZonePointsByViewportCenter","getForbiddenMopZonePointsByViewportCenter","getCleanZonePointsByViewportCenter","getSpotPointByViewportCenter","getEffectiveDividerPoints","getDividerEndPoints","isNearChargerOrRobot","isPointInAnyRoom","isWallIntersectsAnyRoom","isZoneIntersectsAnyRoom","resetPanZoom","snapshot","snapshotByData","getCustomCarpets","forceEndGesture"],o=["onMapFirstDrawed","onMapDrawed","onPathDrawed","onRoomPropertiesDrawed","onClickRoom","onClickRoomProperties","onRemoveForbiddenSweepZone","onRemoveForbiddenMopZone","onRemoveCleanZone","onRemoveVirtualWall","onUpdateForbiddenSweepZone","onUpdateForbiddenMopZone","onUpdateCleanZone","onUpdateVirtualWall","onUpdateSpot","onUpdateWayPoint","onUpdateDivider","onClickForbiddenSweepZone","onClickForbiddenMopZone","onClickCleanZone","onClickVirtualWall","onClickSpot","onClickWayPoint","onClickDetectedObject","onClickCustomElement","onClickMap","onClickCarpet","onDeleteCarpet","onUpdateCustomCarpet","onDeleteCustomCarpet","onGestureStart","onGestureEnd","onClickRobot","onClickChargingStation"];export{e as MAP_API_METHODS,o as MAP_CALLBACK_METHODS};
+const e=["areRoomsAdjacent","getForbiddenSweepZones","getForbiddenMopZones","getCleanZones","getVirtualWalls","getSpots","getWayPoints","getViewportCenterPoint","getMapCenterPoint","getWallPointsByViewportCenter","getForbiddenSweepZonePointsByViewportCenter","getForbiddenMopZonePointsByViewportCenter","getCleanZonePointsByViewportCenter","getSpotPointByViewportCenter","getEffectiveDividerPoints","getDividerEndPoints","isNearChargerOrRobot","isPointInAnyRoom","isWallIntersectsAnyRoom","isZoneIntersectsAnyRoom","resetPanZoom","snapshot","snapshotByData","getCustomCarpets","forceEndGesture","getFurniturePointsByViewportCenter"],o=["onMapFirstDrawed","onMapDrawed","onPathDrawed","onRoomPropertiesDrawed","onClickRoom","onClickRoomProperties","onRemoveForbiddenSweepZone","onRemoveForbiddenMopZone","onRemoveCleanZone","onRemoveVirtualWall","onUpdateForbiddenSweepZone","onUpdateForbiddenMopZone","onUpdateCleanZone","onUpdateVirtualWall","onUpdateSpot","onUpdateWayPoint","onUpdateDivider","onClickForbiddenSweepZone","onClickForbiddenMopZone","onClickCleanZone","onClickVirtualWall","onClickSpot","onClickWayPoint","onClickDetectedObject","onClickCustomElement","onClickMap","onClickCarpet","onDeleteCarpet","onUpdateCustomCarpet","onDeleteCustomCarpet","onGestureStart","onGestureEnd","onClickRobot","onClickChargingStation","onRemoveFurniture","onUpdateFurniture","onClickFurniture"];export{e as MAP_API_METHODS,o as MAP_CALLBACK_METHODS};

package/dist/index.d.ts

@@ -15,6 +15,8 @@ import { DividerConfig as DividerConfig_2 } from '..';
 import { EditControlManager } from '../managers/EditControlManager';
 import { Emitter } from 'mitt';
 import { FederatedPointerEvent } from 'pixi.js';
+import { FurnitureConfig as FurnitureConfig_2 } from '..';
+import { FurnitureManager } from '../managers/FurnitureManager';
 import { Graphics } from 'pixi.js';
 import { HeatmapManager } from '../managers/HeatmapManager';
 import { Interaction } from './Interaction';
@@ -536,6 +538,9 @@ export declare type AppConfig = {
     /** 控制元素配置 */
     controls: ControlsConfig
 
+    /** 家具配置 */
+    furniture: FurnitureConfig
+
     /** 分割线配置 */
     divider: DividerConfig
 
@@ -923,6 +928,7 @@ declare class AppService {
         enableChargingStationClick?: boolean;
     };
     get controlsConfig(): ControlsConfig_2;
+    get furnitureConfig(): FurnitureConfig_2;
     get dividerConfig(): DividerConfig_2;
     get detectedObjectConfig(): {
         height: number;
@@ -947,6 +953,7 @@ declare class AppService {
     get customElementsManager(): CustomElementsManager;
     get roomsManager(): RoomManager;
     get editControlManager(): EditControlManager;
+    get furnitureManager(): FurnitureManager;
     get runtime(): RuntimeConfig_2;
     get runtimeSnapshot(): {
         readonly dividingRoomId: number;
@@ -960,6 +967,7 @@ declare class AppService {
         readonly editingSpotIds: readonly string[];
         readonly editingWayPointIds: readonly string[];
         readonly editingCarpetIds: readonly string[];
+        readonly editingFurnitureIds: readonly string[];
         readonly mapRotation: number;
         readonly roomPropertyFoldIds: readonly number[];
         readonly roomSelectionMode: "checkmark" | "order";
@@ -974,6 +982,7 @@ declare class AppService {
         readonly showChargingStation: boolean;
         readonly showRoomFloorType: boolean;
         readonly showCarpet: boolean;
+        readonly showDetectedObjects: boolean;
         readonly selectRoomIds: readonly number[];
         readonly showChargingStationRing: boolean;
         readonly showRobotRing: boolean;
@@ -1338,6 +1347,16 @@ declare type Components = {
     interaction: Interaction_2;
 };
 
+/** 控制层内可排序元素 */
+export declare type ControlRenderItem =
+| 'forbiddenSweepZone'
+| 'forbiddenMopZone'
+| 'cleanZone'
+| 'virtualWall'
+| 'spot'
+| 'wayPoint'
+| 'divider'
+
 /**
  * 控制元素配置
  */
@@ -1372,6 +1391,8 @@ export declare type ControlsConfig = {
     textFontFamily: string
     /** 文本字体粗细 */
     textFontWeight: TextStyleFontWeight
+    /** 控制层内部渲染顺序（从下到上） */
+    renderOrder: ControlRenderItem[]
     /** 禁扫区域配置 */
     forbiddenSweepZone: ZoneConfig
     /** 禁拖区域配置 */
@@ -1396,12 +1417,17 @@ declare class ControlsManager_2 {
     private spotMap;
     private wayPointMap;
     private divider;
+    private controlContainers;
     private unsubscribeFns;
     constructor(appService: AppService);
     /**
      * 根据地图原点更新所有区域位置
      */
     updatePositionByOrigin(x: number, y: number): void;
+    updateRenderOrder(): void;
+    private initializeControlContainers;
+    private applyRenderOrder;
+    private addToControlLayer;
     /**
      * 绘制扫地禁区
      */
@@ -1467,7 +1493,7 @@ declare class ControlsManager_2 {
      */
     private drawZones;
     /**
-     * 添加新区域到 LAYER_CONTROLS
+     * 添加新区域到 controls 子容器
      */
     private addNewZone;
     /**
@@ -1507,7 +1533,7 @@ declare class ControlsManager_2 {
      */
     private isWallDataEqual;
     /**
-     * 添加新定点清扫到 LAYER_CONTROLS
+     * 添加新定点清扫到 controls 子容器
      */
     private addNewSpot;
     /**
@@ -1544,7 +1570,7 @@ declare class ControlsManager_2 {
      */
     getWayPoints(): WayPointParam[];
     /**
-     * 添加新途径点到 LAYER_CONTROLS
+     * 添加新途径点到 controls 子容器
      */
     private addNewWayPoint;
     /**
@@ -1966,6 +1992,7 @@ export declare type DeepPartialRuntimeConfig = DeepPartial<RuntimeConfig>
 declare class DetectedObjectManager_2 {
     private appService;
     private detectedObjectMap;
+    private unsubscribeShowDetectedObjects;
     constructor(appService: AppService);
     /**
      * 根据地图原点更新所有检测物体位置
@@ -1975,6 +2002,7 @@ declare class DetectedObjectManager_2 {
      * 绘制检测物体
      */
     drawDetectedObjects(objects: DetectedObjectParam[]): Promise<void>;
+    private applyLayerVisibility;
     /**
      * 清除所有检测物体
      */
@@ -2640,6 +2668,79 @@ declare class Free extends Graphics {
     destroy(options?: DestroyOptions | boolean): void;
 }
 
+/** 家具素材配置 */
+export declare type FurnitureAsset = {
+    /** 家具类型编号，匹配 FurnitureParam.furnitureType */
+    type: number
+    /** 图片 URL */
+    src: string
+    /** 默认宽度 (米，用于生成初始 points，内部根据 resolution 转换为像素) */
+    width: number
+    /** 默认高度 (米，用于生成初始 points，内部根据 resolution 转换为像素) */
+    height: number
+}
+
+/** 家具配置 */
+export declare type FurnitureConfig = {
+    /** 家具素材列表 */
+    assets: FurnitureAsset[]
+    /** 全局透明度 (0-1, 默认 1) */
+    opacity: number
+    /** 图标容器填充颜色 */
+    iconWrapperFillColor: ColorSource
+    /** 轮廓偏移 */
+    outlineOffset: number
+    /** 轮廓描边颜色 */
+    outlineStrokeColor: ColorSource
+    /** 轮廓描边宽度 */
+    outlineStrokeWidth: number
+    /** 轮廓填充颜色 */
+    outlineFillColor: ColorSource
+    /** 轮廓是否虚线 */
+    outlineDashed: boolean
+    /** 轮廓虚线数组 */
+    outlineDashArray: [number, number]
+    /** 是否显示尺寸文本 */
+    showSizeText: boolean
+    /** 文本颜色 */
+    textColor: ColorSource
+    /** 文本位置 */
+    textPosition: 'top' | 'right' | 'bottom' | 'left'
+    /** 文本偏移 */
+    textOffset: number
+    /** 缩放按钮允许的最小缩放倍数 (相对初始尺寸, 默认 0.5; 设为 0 表示不限制最小) */
+    minScaleRatio: number
+    /** 缩放按钮允许的最大缩放倍数 (相对初始尺寸, 默认 2; 设为 Infinity 表示不限制最大) */
+    maxScaleRatio: number
+    /** 点击旋转方向: 'cw' 顺时针 | 'ccw' 逆时针 (默认 'cw') */
+    rotateDirection: 'cw' | 'ccw'
+}
+
+declare class FurnitureManager_2 {
+    private appService;
+    private furnitureMap;
+    private unsubscribeFns;
+    constructor(appService: AppService);
+    updatePositionByOrigin(x: number, y: number): void;
+    drawFurnitures(items: FurnitureParam[]): Promise<void>;
+    private addFurniture;
+    private removeFurniture;
+    private clearAll;
+    private updateEditState;
+    private isDataEqual;
+    destroy(): void;
+}
+
+/** 家具参数 */
+export declare type FurnitureParam = {
+    /** 家具ID */
+    id: string
+    /** 家具类型编号，匹配 config.furniture.assets 中的 type */
+    furnitureType: number
+    /** 四个顶点坐标 (顺时针: 左上→右上→右下→左下) */
+    points: Point[]
+}
+
 /**
  * GIF 类型自定义元素参数
  * 保持现有逻辑
@@ -3010,12 +3111,13 @@ declare type Managers = {
     customElementsManager: CustomElementsManager_2;
     roomsManager: RoomManager_2;
     customCarpetManager: CustomCarpetManager;
+    furnitureManager: FurnitureManager_2;
     editControlManager: EditControlManager_2;
 };
 
-export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getWayPoints", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "isNearChargerOrRobot", "isPointInAnyRoom", "isWallIntersectsAnyRoom", "isZoneIntersectsAnyRoom", "resetPanZoom", "snapshot", "snapshotByData", "getCustomCarpets", "forceEndGesture"];
+export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getWayPoints", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "isNearChargerOrRobot", "isPointInAnyRoom", "isWallIntersectsAnyRoom", "isZoneIntersectsAnyRoom", "resetPanZoom", "snapshot", "snapshotByData", "getCustomCarpets", "forceEndGesture", "getFurniturePointsByViewportCenter"];
 
-export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapDrawed", "onPathDrawed", "onRoomPropertiesDrawed", "onClickRoom", "onClickRoomProperties", "onRemoveForbiddenSweepZone", "onRemoveForbiddenMopZone", "onRemoveCleanZone", "onRemoveVirtualWall", "onUpdateForbiddenSweepZone", "onUpdateForbiddenMopZone", "onUpdateCleanZone", "onUpdateVirtualWall", "onUpdateSpot", "onUpdateWayPoint", "onUpdateDivider", "onClickForbiddenSweepZone", "onClickForbiddenMopZone", "onClickCleanZone", "onClickVirtualWall", "onClickSpot", "onClickWayPoint", "onClickDetectedObject", "onClickCustomElement", "onClickMap", "onClickCarpet", "onDeleteCarpet", "onUpdateCustomCarpet", "onDeleteCustomCarpet", "onGestureStart", "onGestureEnd", "onClickRobot", "onClickChargingStation"];
+export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapDrawed", "onPathDrawed", "onRoomPropertiesDrawed", "onClickRoom", "onClickRoomProperties", "onRemoveForbiddenSweepZone", "onRemoveForbiddenMopZone", "onRemoveCleanZone", "onRemoveVirtualWall", "onUpdateForbiddenSweepZone", "onUpdateForbiddenMopZone", "onUpdateCleanZone", "onUpdateVirtualWall", "onUpdateSpot", "onUpdateWayPoint", "onUpdateDivider", "onClickForbiddenSweepZone", "onClickForbiddenMopZone", "onClickCleanZone", "onClickVirtualWall", "onClickSpot", "onClickWayPoint", "onClickDetectedObject", "onClickCustomElement", "onClickMap", "onClickCarpet", "onDeleteCarpet", "onUpdateCustomCarpet", "onDeleteCustomCarpet", "onGestureStart", "onGestureEnd", "onClickRobot", "onClickChargingStation", "onRemoveFurniture", "onUpdateFurniture", "onClickFurniture"];
 
 /**
  * 地图 API 接口定义
@@ -3254,6 +3356,35 @@ export declare interface MapApi {
         offsetX?: number;
         offsetY?: number;
     }): Point[];
+    /**
+     * 绘制家具
+     *
+     * 通过 diff 机制驱动家具的增删改：
+     * - 新 ID 会被添加
+     * - 已有 ID 的数据变化会被更新
+     * - 不在列表中的已有 ID 会被移除
+     * - 传入空数组即清空所有家具
+     *
+     * @param items - 家具数据数组
+     */
+    drawFurnitures(items: FurnitureParam[]): void;
+    /**
+     * 基于视口中心生成家具顶点坐标
+     *
+     * 根据当前视口中心位置和指定的家具类型，生成家具的四个顶点坐标。
+     * 初始尺寸来源于 config.furniture.assets 中对应类型的 width/height。
+     *
+     * @param options - 配置选项
+     * @param options.furnitureType - 家具类型编号，匹配 config.furniture.assets 中的 type
+     * @param options.offsetX - X方向像素偏移，默认为 0
+     * @param options.offsetY - Y方向像素偏移，默认为 0
+     * @returns 家具的四个顶点坐标数组
+     */
+    getFurniturePointsByViewportCenter(options?: {
+        furnitureType?: number;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
     /**
      * 基于视口中心生成定点清扫的点坐标
      *
@@ -3354,6 +3485,7 @@ export declare interface MapApi {
      * @param data.forbiddenMopZones - 可选的禁拖区域数组
      * @param data.virtualWalls - 可选的虚拟墙数组
      * @param data.detectedObjects - 可选的 AI 物体检测数据数组
+     * @param data.furnitures - 可选的家具数据数组
      * @param runtime - 可选的运行时配置 (如是否显示机器人、充电桩等状态)
      * @param options - 截图配置选项
      * @param options.backgroundColor - 指定生成截图时的背景颜色。若不指定，将默认使用 `global.config.backgroundColor`。
@@ -3368,6 +3500,7 @@ export declare interface MapApi {
         forbiddenMopZones?: ZoneParam[];
         virtualWalls?: VirtualWallParam[];
         detectedObjects?: DetectedObjectParam[];
+        furnitures?: FurnitureParam[];
     }, runtime?: DeepPartialRuntimeConfig, options?: {
         backgroundColor?: ColorSource;
     }): Promise<string>;
@@ -3464,6 +3597,11 @@ declare class MapApplication extends Application implements MapApi {
      * @returns void
      */
     drawCustomCarpets(carpets: CustomCarpetParam[]): Promise<void>;
+    /**
+     * 绘制家具
+     * @param items - 家具参数数组
+     */
+    drawFurnitures(items: FurnitureParam[]): Promise<void>;
     /**
      * 绘制热力图
      * @param param - 绘制参数
@@ -3747,6 +3885,14 @@ declare class MapApplication extends Application implements MapApi {
         offsetX?: number;
         offsetY?: number;
     }): Point;
+    /**
+     * 基于视口中心生成家具顶点坐标
+     */
+    getFurniturePointsByViewportCenter(options?: {
+        furnitureType?: number;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
     /**
      * 判断指定的房间是否相邻（连通）
      *
@@ -3846,7 +3992,7 @@ declare class MapApplication extends Application implements MapApi {
      * @returns Promise<string> Base64 格式的图片数据
      *
      */
-    snapshotByData({ map, path, roomProperties, customElements, forbiddenSweepZones, forbiddenMopZones, virtualWalls, detectedObjects, }: {
+    snapshotByData({ map, path, roomProperties, customElements, forbiddenSweepZones, forbiddenMopZones, virtualWalls, detectedObjects, furnitures, }: {
         map: string;
         path?: string;
         roomProperties?: RoomProperty[];
@@ -3855,6 +4001,7 @@ declare class MapApplication extends Application implements MapApi {
         forbiddenMopZones?: ZoneParam[];
         virtualWalls?: VirtualWallParam[];
         detectedObjects?: DetectedObjectParam[];
+        furnitures?: FurnitureParam[];
     }, runtime?: DeepPartialRuntimeConfig, options?: {
         backgroundColor?: ColorSource;
     }): Promise<string>;
@@ -4179,6 +4326,26 @@ export declare interface MapCallbacks {
      *
      */
     onUpdateCustomCarpet?: (carpet: CustomCarpetParam) => void;
+    /**
+     * 点击家具删除按钮的回调
+     *
+     * @param id - 被删除的家具ID
+     */
+    onRemoveFurniture?: (id: string) => void;
+    /**
+     * 更新家具的回调
+     *
+     * 当用户操作家具（如拖拽、缩放、旋转）后触发。
+     *
+     * @param furniture - 更新后的家具数据
+     */
+    onUpdateFurniture?: (furniture: FurnitureParam) => void;
+    /**
+     * 点击家具回调
+     *
+     * @param furniture - 被点击的家具数据
+     */
+    onClickFurniture?: (furniture: FurnitureParam) => void;
     onGestureStart?: () => void;
     /**
      * 手势交互结束回调
@@ -5240,6 +5407,8 @@ export declare type RuntimeConfig = {
     editingWayPointIds: string[]
     /** 正在编辑的地毯ID列表 */
     editingCarpetIds: string[]
+    /** 正在编辑的家具ID列表 */
+    editingFurnitureIds: string[]
     /** 地图旋转角度（度） */
     mapRotation: number
     /** 房间属性折叠的房间ID列表 */
@@ -5268,6 +5437,8 @@ export declare type RuntimeConfig = {
     showRoomFloorType: boolean
     /** 是否显示地毯 */
     showCarpet: boolean
+    /** 是否显示 AI 检测物体 */
+    showDetectedObjects: boolean
     /** 选中的房间ID列表 */
     selectRoomIds: number[]
     /** 是否显示充电桩预警圈 */