@ray-js/robot-map-sdk 0.0.3-beta-29 → 0.0.3-beta-31

package/dist/constant/methods.js

@@ -1 +1 @@
-const e=["areRoomsAdjacent","getForbiddenSweepZones","getForbiddenMopZones","getCleanZones","getVirtualWalls","getSpots","getViewportCenterPoint","getMapCenterPoint","getWallPointsByViewportCenter","getForbiddenSweepZonePointsByViewportCenter","getForbiddenMopZonePointsByViewportCenter","getCleanZonePointsByViewportCenter","getSpotPointByViewportCenter","getEffectiveDividerPoints","getDividerEndPoints","isPointInAnyRoom","resetPanZoom","snapshot","snapshotByData"],o=["onMapFirstDrawed","onMapDrawed","onPathDrawed","onRoomPropertiesDrawed","onClickRoom","onClickRoomProperties","onRemoveForbiddenSweepZone","onRemoveForbiddenMopZone","onRemoveCleanZone","onRemoveVirtualWall","onUpdateForbiddenSweepZone","onUpdateForbiddenMopZone","onUpdateCleanZone","onUpdateVirtualWall","onUpdateSpot","onUpdateDivider","onClickForbiddenSweepZone","onClickForbiddenMopZone","onClickCleanZone","onClickVirtualWall","onClickSpot","onClickDetectedObject","onClickCustomElement"];export{e as MAP_API_METHODS,o as MAP_CALLBACK_METHODS};
+const e=["areRoomsAdjacent","getForbiddenSweepZones","getForbiddenMopZones","getCleanZones","getVirtualWalls","getSpots","getViewportCenterPoint","getMapCenterPoint","getWallPointsByViewportCenter","getForbiddenSweepZonePointsByViewportCenter","getForbiddenMopZonePointsByViewportCenter","getCleanZonePointsByViewportCenter","getSpotPointByViewportCenter","getEffectiveDividerPoints","getDividerEndPoints","isNearChargerOrRobot","isPointInAnyRoom","resetPanZoom","snapshot","snapshotByData"],o=["onMapFirstDrawed","onMapDrawed","onPathDrawed","onRoomPropertiesDrawed","onClickRoom","onClickRoomProperties","onRemoveForbiddenSweepZone","onRemoveForbiddenMopZone","onRemoveCleanZone","onRemoveVirtualWall","onUpdateForbiddenSweepZone","onUpdateForbiddenMopZone","onUpdateCleanZone","onUpdateVirtualWall","onUpdateSpot","onUpdateDivider","onClickForbiddenSweepZone","onClickForbiddenMopZone","onClickCleanZone","onClickVirtualWall","onClickSpot","onClickDetectedObject","onClickCustomElement"];export{e as MAP_API_METHODS,o as MAP_CALLBACK_METHODS};

package/dist/index.d.ts

@@ -1448,7 +1448,7 @@ declare type Managers = {
     roomsManager: RoomManager;
 };
 
-export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "isPointInAnyRoom", "resetPanZoom", "snapshot", "snapshotByData"];
+export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "isNearChargerOrRobot", "isPointInAnyRoom", "resetPanZoom", "snapshot", "snapshotByData"];
 
 export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapDrawed", "onPathDrawed", "onRoomPropertiesDrawed", "onClickRoom", "onClickRoomProperties", "onRemoveForbiddenSweepZone", "onRemoveForbiddenMopZone", "onRemoveCleanZone", "onRemoveVirtualWall", "onUpdateForbiddenSweepZone", "onUpdateForbiddenMopZone", "onUpdateCleanZone", "onUpdateVirtualWall", "onUpdateSpot", "onUpdateDivider", "onClickForbiddenSweepZone", "onClickForbiddenMopZone", "onClickCleanZone", "onClickVirtualWall", "onClickSpot", "onClickDetectedObject", "onClickCustomElement"];
 
@@ -1616,6 +1616,20 @@ export declare interface MapApi {
      * @returns 是否所有指定的房间都相邻（连通）
      */
     areRoomsAdjacent(roomIds: number[]): boolean;
+    /**
+     * 判断一个点是否与充电桩或机器人距离小于阈值。
+     *
+     * @param points - 点坐标数组
+     * @param thresholdMeters - 阈值距离，单位米
+     * @param options - 配置选项
+     * @param options.checkCharger - 是否检查与充电桩的距离，默认为 true
+     * @param options.checkRobot - 是否检查与机器人的距离，默认为 false
+     * @returns 是否在判定范围内（true 表示过近，false 表示距离足够）
+     */
+    isNearChargerOrRobot(points: Point[], thresholdMeters: number, options?: {
+        checkCharger?: boolean;
+        checkRobot?: boolean;
+    }): boolean;
     /**
      * 判断一个点是否在任意房间内
      *
@@ -2021,6 +2035,25 @@ declare class MapApplication extends Application implements MapApi {
      *
      */
     isPointInAnyRoom(point: Point): RoomData | null;
+    /**
+     * 判断点、墙体或区域是否距离充电桩或机器人位置过近
+     *
+     * 根据给定的坐标集合（点1个、墙体2个点或区域4个点）和判定阈值，
+     * 计算其与充电桩和/或机器人位置的最小距离，判断是否在阈值范围内。
+     *
+     * @param points - 点（1个）、墙体（2个点）或区域（4个点）的坐标集合（原点坐标系）
+     * @param thresholdMeters - 判定阈值，单位为米
+     * @param options - 配置选项
+     * @param options.checkCharger - 是否检查与充电桩的距离，默认为 true
+     * @param options.checkRobot - 是否检查与机器人的距离，默认为 false
+     * @returns 是否在判定范围内（true 表示过近，false 表示距离足够）
+     *
+     */
+    isNearChargerOrRobot(points: Point[], thresholdMeters: number, options?: {
+        checkCharger?: boolean;
+        checkRobot?: boolean;
+    }): boolean;
+    /* Excluded from this release type: calculateMinDistanceToGeometry */
     /* Excluded from this release type: isPointInAnyRoomStructuredInternal */
     /* Excluded from this release type: isPointInAnyRoomRasterInternal */
     /* Excluded from this release type: areStructuredRoomsAdjacentInternal */
@@ -2546,6 +2579,7 @@ declare class Path extends Container {
     private chargePath;
     private transitionsPath;
     private mopPath;
+    private debugPoints;
     private pathData;
     private lastPointCount;
     private lastDrawnPosition;
@@ -2583,6 +2617,11 @@ declare class Path extends Container {
      * @param pathPoints 路径点数组
      */
     private drawPathSegments;
+    /**
+     * 调试模式下绘制路径点方块
+     * @param pathPoints 路径点数组
+     */
+    private drawDebugPoints;
     updatePositionByOrigin(x: number, y: number): void;
     /**
      * 全量绘制路径
@@ -2787,6 +2826,14 @@ declare class Robot extends Container {
      * 立即绘制到指定位置（无动画）
      */
     draw({ x, y, rotation }: IconPoint): Promise<void>;
+    /**
+     * 获取机器人当前位置（相对坐标系）
+     * @returns 机器人当前位置，如果尚未绘制则返回 null
+     */
+    getCurrentPosition(): {
+        x: number;
+        y: number;
+    } | null;
     /**
      * 添加移动目标到队列（带动画）
      */