@ray-js/robot-data-stream 0.0.17-beta.8 → 0.1.0-beta.0

package/lib/mqtt/type/protocols/index.js

@@ -1,3 +1,4 @@
+export * from './base';
 export * from './scheduleProtocol';
 export * from './carpetProtocol';
 export * from './zoneCleanProtocol';
@@ -20,4 +21,6 @@ export * from './devInfoProtocol';
 export * from './roomPropertyProtocol';
 export * from './purifierScheduleProtocol';
 export * from './cruiseProtocol';
-export * from './mcsRoomInfoProtocol';
+export * from './spotPolygonsProtocol';
+export * from './mcsRoomInfoProtocol';
+export * from './thresholdProtocol';

package/lib/mqtt/type/protocols/spotPolygonsProtocol.d.ts

@@ -0,0 +1,21 @@
+import type { BaseResponse } from './base';
+export interface SetSpotPolygonsData {
+    /** 定点位置坐标，格式为 "x,y" */
+    polygons: string[];
+    /** 定点位置名称，与 polygons 一一对应 */
+    spotNames: string[];
+    version?: string;
+}
+export interface RequestSpotPolygonsData {
+    version?: string;
+}
+export interface SpotPolygonsResponse extends BaseResponse {
+    /** 定点位置数量 */
+    num: number;
+    /** 定点位置坐标，格式为 "x,y" */
+    polygons: string[];
+    /** 定点位置名称，与 polygons 一一对应 */
+    spotNames: string[];
+}
+export type TRequestSpotPolygons = (message?: RequestSpotPolygonsData) => Promise<SpotPolygonsResponse>;
+export type TSetSpotPolygons = (message: SetSpotPolygonsData) => Promise<SpotPolygonsResponse>;

package/lib/mqtt/type/protocols/spotPolygonsProtocol.js

@@ -0,0 +1 @@
+export {};

package/lib/mqtt/type/protocols/thresholdProtocol.d.ts

@@ -0,0 +1,22 @@
+import type { BaseResponse, Point } from './base';
+export interface ThresholdItem {
+    /** 门槛的 4 个顶点，面板坐标系（未减地图原点） */
+    points: Point[];
+    /** 门槛类型：0 可通过门槛，1 不可通过门槛，2 坡道 */
+    type: number;
+    /** 门槛名称，协议预留字段，不传按空字符串下发 */
+    name?: string;
+}
+export interface SetThresholdData {
+    data: ThresholdItem[];
+    origin: Point;
+}
+export interface ThresholdResponse extends BaseResponse {
+    num: number;
+    polygons: string[];
+    types: number[];
+    names: string[];
+    mapId: number;
+}
+export type TRequestThreshold = () => Promise<ThresholdResponse>;
+export type TSetThreshold = (data: SetThresholdData) => Promise<ThresholdResponse>;

package/lib/mqtt/type/protocols/thresholdProtocol.js

@@ -0,0 +1 @@
+export {};

package/lib/mqtt/type/requestType.d.ts

@@ -46,6 +46,10 @@ export declare enum VirtualAreaEnum {
     query = "restrictedAreaQry",
     set = "restrictedAreaSet"
 }
+export declare enum ThresholdEnum {
+    query = "thresholdQry",
+    set = "thresholdSet"
+}
 export declare enum VoiceLanguageEnum {
     query = "voiceLanguageQry",
     set = "voiceLanguageSet"
@@ -100,6 +104,10 @@ export declare enum CruiseEnum {
     query = "purifierCruiseQry",
     set = "purifierCruiseSet"
 }
+export declare enum SpotPolygonsEnum {
+    query = "spotPolygonsQry",
+    set = "spotPolygonsSet"
+}
 export declare enum McsRoomInfoEnum {
     query = "McsRoomInfoQry"
 }

package/lib/mqtt/type/requestType.js

@@ -66,6 +66,13 @@ export let VirtualAreaEnum = /*#__PURE__*/function (VirtualAreaEnum) {
   return VirtualAreaEnum;
 }({});
 
+// 门槛
+export let ThresholdEnum = /*#__PURE__*/function (ThresholdEnum) {
+  ThresholdEnum["query"] = "thresholdQry";
+  ThresholdEnum["set"] = "thresholdSet";
+  return ThresholdEnum;
+}({});
+
 // 语音语言枚举
 export let VoiceLanguageEnum = /*#__PURE__*/function (VoiceLanguageEnum) {
   VoiceLanguageEnum["query"] = "voiceLanguageQry";
@@ -153,6 +160,13 @@ export let CruiseEnum = /*#__PURE__*/function (CruiseEnum) {
   return CruiseEnum;
 }({});
 
+// 定点位置
+export let SpotPolygonsEnum = /*#__PURE__*/function (SpotPolygonsEnum) {
+  SpotPolygonsEnum["query"] = "spotPolygonsQry";
+  SpotPolygonsEnum["set"] = "spotPolygonsSet";
+  return SpotPolygonsEnum;
+}({});
+
 // 设备当前所在房间（MCS 房间信息；RVC SDK Alexa 语音方案协议，通常仅在任务中查询）
 export let McsRoomInfoEnum = /*#__PURE__*/function (McsRoomInfoEnum) {
   McsRoomInfoEnum["query"] = "McsRoomInfoQry";

package/lib/mqtt/useCarpet.js

@@ -78,7 +78,9 @@ export const useCarpet = () => {
           const sendData = pickBy(processedData, value => value !== undefined);
           sendStructuredMessage(CarpetEnum.update, {
             carpetInfo: sendData
-          }, resolve, error => reject(handleMqttError(error, 'Failed to update carpet')), CarpetEnum.update);
+          }, resolve, error => reject(handleMqttError(error, 'Failed to update carpet')), {
+            responseType: CarpetEnum.update
+          });
         } catch (error) {
           reject(handleMqttError(error, 'Failed to update carpet'));
         }
@@ -91,7 +93,9 @@ export const useCarpet = () => {
             carpetInfo: {
               ids: data.ids
             }
-          }, resolve, error => reject(handleMqttError(error, 'Failed to delete carpet')), CarpetEnum.delete);
+          }, resolve, error => reject(handleMqttError(error, 'Failed to delete carpet')), {
+            responseType: CarpetEnum.delete
+          });
         } catch (error) {
           reject(handleMqttError(error, 'Failed to delete carpet'));
         }
@@ -101,7 +105,9 @@ export const useCarpet = () => {
       let data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
       return new Promise((resolve, reject) => {
         try {
-          sendStructuredMessage(CarpetEnum.query, data, resolve, error => reject(handleMqttError(error, 'Failed to query carpet')), CarpetEnum.query);
+          sendStructuredMessage(CarpetEnum.query, data, resolve, error => reject(handleMqttError(error, 'Failed to query carpet')), {
+            responseType: CarpetEnum.query
+          });
         } catch (error) {
           reject(handleMqttError(error, 'Failed to query carpet'));
         }
@@ -121,7 +127,9 @@ export const useCarpet = () => {
             ids: carpetInfo.ids,
             type: carpetInfo.type
           };
-          sendStructuredMessage(CarpetEnum.set, sendData, resolve, error => reject(handleMqttError(error, 'Failed to set carpet')), CarpetEnum.query);
+          sendStructuredMessage(CarpetEnum.set, sendData, resolve, error => reject(handleMqttError(error, 'Failed to set carpet')), {
+            responseType: CarpetEnum.query
+          });
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set carpet'));
         }

package/lib/mqtt/useCarpetClean.js

@@ -27,7 +27,9 @@ export const useCarpetClean = () => {
     requestCarpetClean: () => {
       return new Promise((resolve, reject) => {
         try {
-          sendStructuredMessage(CarpetCleanEnum.query, {}, resolve, error => reject(handleMqttError(error, 'Failed to request carpet clean')), CarpetCleanEnum.query);
+          sendStructuredMessage(CarpetCleanEnum.query, {}, resolve, error => reject(handleMqttError(error, 'Failed to request carpet clean')), {
+            responseType: CarpetCleanEnum.query
+          });
         } catch (error) {
           reject(handleMqttError(error, 'Failed to request carpet clean'));
         }
@@ -38,7 +40,9 @@ export const useCarpetClean = () => {
         try {
           sendStructuredMessage(CarpetCleanEnum.set, {
             ids: data
-          }, resolve, error => reject(handleMqttError(error, 'Failed to set carpet clean')), CarpetCleanEnum.set);
+          }, resolve, error => reject(handleMqttError(error, 'Failed to set carpet clean')), {
+            responseType: CarpetCleanEnum.set
+          });
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set carpet clean'));
         }

package/lib/mqtt/useCruise.js

@@ -2,6 +2,7 @@
 import { useContext } from 'react';
 import { handleMqttError, useStructuredMessage } from './hooks/useStructuredMessage';
 import { SingletonContext } from './mqttProvider';
+import { createCruisePayload } from './cruise';
 import { CruiseEnum } from './type';
 /**
  * 自定义 Hook，用于移动设备巡航状态查询与控制（如移动空气净化器、移动垃圾桶）
@@ -55,7 +56,9 @@ export const useCruise = () => {
             reject(new Error('cruiseType is required when cmd is "start"'));
             return;
           }
-          sendStructuredMessage(CruiseEnum.set, message, resolve, error => reject(handleMqttError(error, 'Failed to set cruise')), CruiseEnum.query // 响应类型是 query，不是 set
+          sendStructuredMessage(CruiseEnum.set, createCruisePayload(message), resolve, error => reject(handleMqttError(error, 'Failed to set cruise')), {
+            responseType: CruiseEnum.query
+          } // 响应类型是 query，不是 set
           );
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set cruise'));

package/lib/mqtt/useCustomCommand.d.ts

@@ -0,0 +1,39 @@
+import { BaseResponse } from './type/protocols/base';
+/**
+ * 自定义指令选项
+ */
+export interface CustomCommandOptions {
+    /**
+     * 响应匹配的事件名（reqType）。
+     * 缺省与下发 reqType 同名；set 类指令的回复走 qry 事件名、
+     * 或回复 reqType 与下发不同名（如 aiObjectIgnoreSet → aiObjectIgnoreRst）时必填。
+     */
+    responseType?: string;
+    /** 超时时间（毫秒），默认 10000 */
+    timeout?: number;
+    /** 协议版本号，默认 '1.0.0' */
+    version?: string;
+}
+/**
+ * 自定义指令发送函数类型
+ */
+export type TSendCustomCommand = <TRes extends BaseResponse = BaseResponse>(reqType: string, data?: Record<string, any>, options?: CustomCommandOptions) => Promise<TRes>;
+/**
+ * 自定义指令 Hook：在 MqttProvider 内任意组件使用，获得 sendCustomCommand。
+ *
+ * 与内置 hook 同一契约：返回 Promise 命令函数，loading / 重试 / toast 由业务侧自理。
+ * 走 MQTT + LAN JSON socket 双通道（复用 preferredChannel 策略）；
+ * DP command_trans 二进制路线不支持（useMqtt=false 时直接 reject）。
+ * 响应按 reqType + taskId 双匹配，同 reqType 并发下发不会互相串包。
+ *
+ * @example
+ * ```typescript
+ * const { sendCustomCommand } = useCustomCommand();
+ *
+ * // 下发查询并等待回复
+ * const res = await sendCustomCommand<PeakValleyResponse>('peakValleyChargeQry');
+ * ```
+ */
+export declare const useCustomCommand: () => {
+    sendCustomCommand: TSendCustomCommand;
+};

package/lib/mqtt/useCustomCommand.js

@@ -0,0 +1,45 @@
+// 自定义指令：不经过内置 hook 的任意 reqType 下发出口
+import { useCallback } from 'react';
+import { handleMqttError, useStructuredMessage } from './hooks/useStructuredMessage';
+
+/**
+ * 自定义指令选项
+ */
+
+/**
+ * 自定义指令发送函数类型
+ */
+
+/**
+ * 自定义指令 Hook：在 MqttProvider 内任意组件使用，获得 sendCustomCommand。
+ *
+ * 与内置 hook 同一契约：返回 Promise 命令函数，loading / 重试 / toast 由业务侧自理。
+ * 走 MQTT + LAN JSON socket 双通道（复用 preferredChannel 策略）；
+ * DP command_trans 二进制路线不支持（useMqtt=false 时直接 reject）。
+ * 响应按 reqType + taskId 双匹配，同 reqType 并发下发不会互相串包。
+ *
+ * @example
+ * ```typescript
+ * const { sendCustomCommand } = useCustomCommand();
+ *
+ * // 下发查询并等待回复
+ * const res = await sendCustomCommand<PeakValleyResponse>('peakValleyChargeQry');
+ * ```
+ */
+export const useCustomCommand = () => {
+  const {
+    sendStructuredMessage
+  } = useStructuredMessage();
+  const sendCustomCommand = useCallback(function (reqType) {
+    let data = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+    return new Promise((resolve, reject) => {
+      sendStructuredMessage(reqType, data,
+      // Promise 的 resolve 入参是 TRes 的超集（含 PromiseLike），收窄传给发送层
+      resolve, error => reject(handleMqttError(error, `Failed to send custom command ${reqType}`)), options);
+    });
+  }, [sendStructuredMessage]);
+  return {
+    sendCustomCommand
+  };
+};

package/lib/mqtt/useDeviceModel.js

@@ -36,7 +36,9 @@ export const useDeviceModel = () => {
         try {
           sendStructuredMessage(DeviceModelEnum.set, {
             modelInfos: data
-          }, resolve, error => reject(handleMqttError(error, 'Failed to set device model')), DeviceModelEnum.query);
+          }, resolve, error => reject(handleMqttError(error, 'Failed to set device model')), {
+            responseType: DeviceModelEnum.query
+          });
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set device model'));
         }

package/lib/mqtt/useFurnitureModel.js

@@ -36,7 +36,9 @@ export const useFurnitureModel = () => {
         try {
           sendStructuredMessage(FurnitureModelEnum.set, {
             modelInfos: data
-          }, resolve, error => reject(handleMqttError(error, 'Failed to set furniture model')), FurnitureModelEnum.query);
+          }, resolve, error => reject(handleMqttError(error, 'Failed to set furniture model')), {
+            responseType: FurnitureModelEnum.query
+          });
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set furniture model'));
         }

package/lib/mqtt/useHistoryMap.js

@@ -48,7 +48,9 @@ export const useHistoryMap = () => {
             if (useMqtt) {
               sendStructuredMessage(DeleteMapEnum.set, {
                 mapId
-              }, resolve, error => reject(handleMqttError(error, 'Failed to delete history map')), DeleteMapEnum.rst // 响应类型是 rst，不是 set
+              }, resolve, error => reject(handleMqttError(error, 'Failed to delete history map')), {
+                responseType: DeleteMapEnum.rst
+              } // 响应类型是 rst，不是 set
               );
               return;
             }
@@ -81,7 +83,9 @@ export const useHistoryMap = () => {
               urlLen: url.length
             };
             if (useMqtt) {
-              sendStructuredMessage(UseMapEnum.set, mapData, resolve, error => reject(handleMqttError(error, 'Failed to change current map')), UseMapEnum.query // 响应类型是 query，不是 set
+              sendStructuredMessage(UseMapEnum.set, mapData, resolve, error => reject(handleMqttError(error, 'Failed to change current map')), {
+                responseType: UseMapEnum.query
+              } // 响应类型是 query，不是 set
               );
               return;
             }
@@ -113,7 +117,9 @@ export const useHistoryMap = () => {
       return new Promise((resolve, reject) => {
         try {
           if (useMqtt) {
-            sendStructuredMessage(SaveCurrentMapEnum.set, data, resolve, error => reject(handleMqttError(error, 'Failed to save current map')), SaveCurrentMapEnum.query // 响应类型是 query，不是 set
+            sendStructuredMessage(SaveCurrentMapEnum.set, data, resolve, error => reject(handleMqttError(error, 'Failed to save current map')), {
+              responseType: SaveCurrentMapEnum.query
+            } // 响应类型是 query，不是 set
             );
             return;
           }

package/lib/mqtt/usePartDivision.js

@@ -36,7 +36,9 @@ export const usePartDivision = () => {
             sendStructuredMessage(PartDivisionEnum.set, {
               lines: [pointStr],
               ids: [roomId]
-            }, resolve, error => reject(handleMqttError(error, 'Failed to set part division')), PartDivisionEnum.query);
+            }, resolve, error => reject(handleMqttError(error, 'Failed to set part division')), {
+              responseType: PartDivisionEnum.query
+            });
             return;
           }
           const roomIdNumber = typeof roomId === 'string' ? Number(roomId) : roomId;

package/lib/mqtt/usePartMerge.js

@@ -31,7 +31,9 @@ export const usePartMerge = () => {
           if (useMqtt) {
             sendStructuredMessage(PartMergeEnum.set, {
               ids
-            }, resolve, error => reject(handleMqttError(error, 'Failed to set part merge')), PartMergeEnum.query // 响应类型是 query，不是 set
+            }, resolve, error => reject(handleMqttError(error, 'Failed to set part merge')), {
+              responseType: PartMergeEnum.query
+            } // 响应类型是 query，不是 set
             );
             return;
           }

package/lib/mqtt/usePassword.js

@@ -64,7 +64,9 @@ export const usePassword = () => {
             oldPassword: params.oldPassword ? md5(params.oldPassword).toString() : undefined,
             taskId: (_params$taskId = params.taskId) !== null && _params$taskId !== void 0 ? _params$taskId : String(Date.now())
           };
-          sendStructuredMessage(PasswordEnum.set, passwordData, resolve, error => reject(handleMqttError(error, 'Failed to set password')), PasswordEnum.rst // 响应类型是 rst，不是 set
+          sendStructuredMessage(PasswordEnum.set, passwordData, resolve, error => reject(handleMqttError(error, 'Failed to set password')), {
+            responseType: PasswordEnum.rst
+          } // 响应类型是 rst，不是 set
           );
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set password'));
@@ -86,7 +88,9 @@ export const usePassword = () => {
             password: md5(params.password).toString(),
             taskId: (_params$taskId2 = params.taskId) !== null && _params$taskId2 !== void 0 ? _params$taskId2 : String(Date.now())
           };
-          sendStructuredMessage(PasswordEnum.check, passwordData, resolve, error => reject(handleMqttError(error, 'Failed to check password')), PasswordEnum.checkRst // 响应类型是 checkRst，不是 check
+          sendStructuredMessage(PasswordEnum.check, passwordData, resolve, error => reject(handleMqttError(error, 'Failed to check password')), {
+            responseType: PasswordEnum.checkRst
+          } // 响应类型是 checkRst，不是 check
           );
         } catch (error) {
           reject(handleMqttError(error, 'Failed to check password'));

package/lib/mqtt/usePurifierSchedule.js

@@ -55,7 +55,9 @@ export const usePurifierSchedule = () => {
           }
           sendStructuredMessage(PurifierScheduleEnum.set, _objectSpread(_objectSpread({}, message), {}, {
             num: (_message$num = message.num) !== null && _message$num !== void 0 ? _message$num : message.list.length
-          }), resolve, error => reject(handleMqttError(error, 'Failed to set purifier schedule')), PurifierScheduleEnum.query // 响应类型是 query，不是 set
+          }), resolve, error => reject(handleMqttError(error, 'Failed to set purifier schedule')), {
+            responseType: PurifierScheduleEnum.query
+          } // 响应类型是 query，不是 set
           );
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set purifier schedule'));

package/lib/mqtt/useQuiteHours.js

@@ -52,7 +52,9 @@ export const useQuiteHours = () => {
               time: [`${h0},${m0}`, `${h1},${m1}`],
               active,
               day
-            }, resolve, error => reject(handleMqttError(error, 'Failed to set quiet hours')), QuietHoursEnum.query // 响应类型是 query，不是 set
+            }, resolve, error => reject(handleMqttError(error, 'Failed to set quiet hours')), {
+              responseType: QuietHoursEnum.query
+            } // 响应类型是 query，不是 set
             );
             return;
           }

package/lib/mqtt/useResetMap.js

@@ -28,7 +28,9 @@ export const useResetMap = () => {
       return new Promise((resolve, reject) => {
         try {
           if (useMqtt) {
-            sendStructuredMessage(ResetCurrMapEnum.set, {}, resolve, error => reject(handleMqttError(error, 'Failed to reset map')), ResetCurrMapEnum.query // 响应类型是 query，不是 set
+            sendStructuredMessage(ResetCurrMapEnum.set, {}, resolve, error => reject(handleMqttError(error, 'Failed to reset map')), {
+              responseType: ResetCurrMapEnum.query
+            } // 响应类型是 query，不是 set
             );
             return;
           }

package/lib/mqtt/useRoomProperty.js

@@ -73,7 +73,9 @@ export const useRoomProperty = () => {
           }), data.polygons && {
             polygons: data.polygons
           }), pickWaterFields(len, data.cisterns, data.waterValues));
-          sendStructuredMessage(RoomPropertyEnum.set, sendData, resolve, error => reject(handleMqttError(error, 'Failed to set room property')), RoomPropertyEnum.query // 响应类型是 query，不是 set
+          sendStructuredMessage(RoomPropertyEnum.set, sendData, resolve, error => reject(handleMqttError(error, 'Failed to set room property')), {
+            responseType: RoomPropertyEnum.query
+          } // 响应类型是 query，不是 set
           );
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set room property'));

package/lib/mqtt/useSchedule.js

@@ -65,7 +65,9 @@ export const useSchedule = () => {
           if (useMqtt) {
             sendStructuredMessage(ScheduleEnum.set, _objectSpread(_objectSpread({}, message), {}, {
               list
-            }), resolve, error => reject(handleMqttError(error, 'Failed to set schedule')), ScheduleEnum.query // 响应类型是 query，不是 set
+            }), resolve, error => reject(handleMqttError(error, 'Failed to set schedule')), {
+              responseType: ScheduleEnum.query
+            } // 响应类型是 query，不是 set
             );
             return;
           }

package/lib/mqtt/useSelectRoomClean.js

@@ -107,7 +107,9 @@ export const useSelectRoomClean = () => {
               routePreferences: prefs.map(p => p !== null && p !== void 0 ? p : 'standard')
             }), {}, {
               num: rooms.length
-            }), resolve, error => reject(handleMqttError(error, 'Failed to set room clean')), RoomCleanSetEnum.query // 响应类型是 query，不是 set
+            }), resolve, error => reject(handleMqttError(error, 'Failed to set room clean')), {
+              responseType: RoomCleanSetEnum.query
+            } // 响应类型是 query，不是 set
             );
             return;
           }

package/lib/mqtt/useSpotClean.js

@@ -80,7 +80,9 @@ export const useSpotClean = () => {
               names
             }), spotNames && {
               spotNames
-            }), resolve, error => reject(handleMqttError(error, 'Failed to set spot clean')), SpotCleanEnum.query // 响应类型是 query，不是 set
+            }), resolve, error => reject(handleMqttError(error, 'Failed to set spot clean')), {
+              responseType: SpotCleanEnum.query
+            } // 响应类型是 query，不是 set
             );
             return;
           }

package/lib/mqtt/useSpotPolygons.d.ts

@@ -0,0 +1,9 @@
+import { type TRequestSpotPolygons, type TSetSpotPolygons } from './type/protocols/spotPolygonsProtocol';
+/**
+ * 自定义 Hook，用于定点位置查询与设置
+ * @returns 包含 requestSpotPolygons 和 setSpotPolygons 函数的对象
+ */
+export declare const useSpotPolygons: () => {
+    requestSpotPolygons: TRequestSpotPolygons;
+    setSpotPolygons: TSetSpotPolygons;
+};

package/lib/mqtt/useSpotPolygons.js

@@ -0,0 +1,50 @@
+import { useContext } from 'react';
+import { handleMqttError, useStructuredMessage } from './hooks/useStructuredMessage';
+import { SingletonContext } from './mqttProvider';
+import { createSpotPolygonsPayload } from './spotPolygons';
+import { SpotPolygonsEnum } from './type';
+/**
+ * 自定义 Hook，用于定点位置查询与设置
+ * @returns 包含 requestSpotPolygons 和 setSpotPolygons 函数的对象
+ */
+export const useSpotPolygons = () => {
+  const {
+    useMqtt
+  } = useContext(SingletonContext);
+  const {
+    sendStructuredMessage
+  } = useStructuredMessage();
+  return {
+    requestSpotPolygons: function () {
+      let message = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {
+        version: '1.0.0'
+      };
+      return new Promise((resolve, reject) => {
+        try {
+          if (!useMqtt) {
+            reject(new Error('useMqtt is not used'));
+            return;
+          }
+          sendStructuredMessage(SpotPolygonsEnum.query, message, resolve, error => reject(handleMqttError(error, 'Failed to request spot polygons')));
+        } catch (error) {
+          reject(handleMqttError(error, 'Failed to request spot polygons'));
+        }
+      });
+    },
+    setSpotPolygons: message => {
+      return new Promise((resolve, reject) => {
+        try {
+          if (!useMqtt) {
+            reject(new Error('useMqtt is not used'));
+            return;
+          }
+          sendStructuredMessage(SpotPolygonsEnum.set, createSpotPolygonsPayload(message), resolve, error => reject(handleMqttError(error, 'Failed to set spot polygons')), {
+            responseType: SpotPolygonsEnum.query
+          });
+        } catch (error) {
+          reject(handleMqttError(error, 'Failed to set spot polygons'));
+        }
+      });
+    }
+  };
+};

package/lib/mqtt/useThreshold.d.ts

@@ -0,0 +1,10 @@
+import { type TRequestThreshold, type TSetThreshold } from './type/protocols';
+/**
+ * 自定义 Hook，用于门槛管理（可通过门槛 / 不可通过门槛 / 坡道）
+ * 门槛协议仅支持 MQTT / LAN 结构化消息通道，未启用 useMqtt 时直接 reject
+ * @returns 包含 requestThreshold 和 setThreshold 函数的对象
+ */
+export declare const useThreshold: () => {
+    requestThreshold: TRequestThreshold;
+    setThreshold: TSetThreshold;
+};

package/lib/mqtt/useThreshold.js

@@ -0,0 +1,90 @@
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.for-each.js";
+// 门槛（可通过门槛 / 不可通过门槛 / 坡道）
+import { useContext } from 'react';
+import { pointsToString } from '../utils';
+import { handleMqttError, useStructuredMessage } from './hooks/useStructuredMessage';
+import { SingletonContext } from './mqttProvider';
+import { ThresholdEnum } from './type';
+// 门槛
+
+/**
+ * 自定义 Hook，用于门槛管理（可通过门槛 / 不可通过门槛 / 坡道）
+ * 门槛协议仅支持 MQTT / LAN 结构化消息通道，未启用 useMqtt 时直接 reject
+ * @returns 包含 requestThreshold 和 setThreshold 函数的对象
+ */
+export const useThreshold = () => {
+  const {
+    useMqtt
+  } = useContext(SingletonContext);
+  const {
+    sendStructuredMessage
+  } = useStructuredMessage();
+
+  /**
+   * 请求门槛数据
+   * @returns Promise<ThresholdResponse> 响应结果
+   */
+
+  /**
+   * 设置门槛数据（全量覆盖，传空数组表示清空全部门槛）
+   * @param message 包含门槛设置参数的对象
+   * @param message.data 门槛的数据数组，每项含 4 个顶点、类型与可选名称
+   * @param message.origin 原点坐标
+   * @returns Promise<ThresholdResponse> 响应结果
+   */
+
+  return {
+    requestThreshold: () => {
+      return new Promise((resolve, reject) => {
+        try {
+          if (!useMqtt) {
+            reject(new Error('useMqtt is not used'));
+            return;
+          }
+          sendStructuredMessage(ThresholdEnum.query, {}, resolve, error => reject(handleMqttError(error, 'Failed to request threshold')));
+        } catch (error) {
+          reject(handleMqttError(error, 'Failed to request threshold'));
+        }
+      });
+    },
+    setThreshold: message => {
+      return new Promise((resolve, reject) => {
+        try {
+          if (!useMqtt) {
+            reject(new Error('useMqtt is not used'));
+            return;
+          }
+          const {
+            data,
+            origin
+          } = message;
+          const polygons = [];
+          const types = [];
+          const names = [];
+          data.forEach(_ref => {
+            let {
+              points,
+              type,
+              name
+            } = _ref;
+            polygons.push(pointsToString(points, origin));
+            types.push(type);
+            names.push(name !== null && name !== void 0 ? name : '');
+          });
+          sendStructuredMessage(ThresholdEnum.set, {
+            num: data.length,
+            polygons,
+            types,
+            names
+          }, resolve, error => reject(handleMqttError(error, 'Failed to set threshold')), {
+            responseType: ThresholdEnum.query
+          } // 响应类型是 query，不是 set
+          );
+        } catch (error) {
+          reject(handleMqttError(error, 'Failed to set threshold'));
+        }
+      });
+    }
+  };
+};