@ray-js/robot-data-stream 0.0.17-beta.2 → 0.0.17-beta.4

package/lib/mqtt/index.d.ts

@@ -21,4 +21,5 @@ import { useDeviceModel } from './useDeviceModel';
 import { useFurnitureModel } from './useFurnitureModel';
 import { usePurifierSchedule } from './usePurifierSchedule';
 import { useCruise } from './useCruise';
-export { useCarpet, useCarpetClean, useVoice, MqttProvider, useDeviceModel, useFurnitureModel, useDevInfo, usePartMerge, usePartDivision, usePassword, useWifiMap, useQuiteHours, useVirtualArea, useSpotClean, useZoneClean, useSelectRoomClean, useVirtualWall, useSchedule, useHistoryMap, useRoomProperty, useResetMap, usePurifierSchedule, useCruise, };
+import { useMcsRoomInfo } from './useMcsRoomInfo';
+export { useCarpet, useCarpetClean, useVoice, MqttProvider, useDeviceModel, useFurnitureModel, useDevInfo, usePartMerge, usePartDivision, usePassword, useWifiMap, useQuiteHours, useVirtualArea, useSpotClean, useZoneClean, useSelectRoomClean, useVirtualWall, useSchedule, useHistoryMap, useRoomProperty, useResetMap, usePurifierSchedule, useCruise, useMcsRoomInfo, };

package/lib/mqtt/index.js

@@ -21,4 +21,5 @@ import { useDeviceModel } from './useDeviceModel';
 import { useFurnitureModel } from './useFurnitureModel';
 import { usePurifierSchedule } from './usePurifierSchedule';
 import { useCruise } from './useCruise';
-export { useCarpet, useCarpetClean, useVoice, MqttProvider, useDeviceModel, useFurnitureModel, useDevInfo, usePartMerge, usePartDivision, usePassword, useWifiMap, useQuiteHours, useVirtualArea, useSpotClean, useZoneClean, useSelectRoomClean, useVirtualWall, useSchedule, useHistoryMap, useRoomProperty, useResetMap, usePurifierSchedule, useCruise };
+import { useMcsRoomInfo } from './useMcsRoomInfo';
+export { useCarpet, useCarpetClean, useVoice, MqttProvider, useDeviceModel, useFurnitureModel, useDevInfo, usePartMerge, usePartDivision, usePassword, useWifiMap, useQuiteHours, useVirtualArea, useSpotClean, useZoneClean, useSelectRoomClean, useVirtualWall, useSchedule, useHistoryMap, useRoomProperty, useResetMap, usePurifierSchedule, useCruise, useMcsRoomInfo };

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

@@ -20,3 +20,4 @@ export * from './devInfoProtocol';
 export * from './roomPropertyProtocol';
 export * from './purifierScheduleProtocol';
 export * from './cruiseProtocol';
+export * from './mcsRoomInfoProtocol';

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

@@ -19,4 +19,5 @@ export * from './carpetCleanProtocol';
 export * from './devInfoProtocol';
 export * from './roomPropertyProtocol';
 export * from './purifierScheduleProtocol';
-export * from './cruiseProtocol';
+export * from './cruiseProtocol';
+export * from './mcsRoomInfoProtocol';

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

@@ -0,0 +1,18 @@
+import type { BaseResponse } from './base';
+export interface RequestMcsRoomInfoData {
+    /** 协议版本；默认 '1.0.0' */
+    version?: string;
+}
+/**
+ * McsRoomInfoQry 应答（RVC SDK Alexa 语音方案协议）。
+ * 注意：房间字段为 snake_case（与设备端 MCS_ROOM_INFO_S 结构体对应）。
+ */
+export interface McsRoomInfoResponse extends BaseResponse {
+    /** 当前地图 ID */
+    mapId: number;
+    /** 设备当前所在房间 ID（与 roomPropertyQry 的 ids 对应） */
+    curr_room_id: number;
+    /** 设备当前所在房间名称 */
+    curr_room_name: string;
+}
+export type TRequestMcsRoomInfo = (message?: RequestMcsRoomInfoData) => Promise<McsRoomInfoResponse>;

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

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

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

@@ -97,6 +97,9 @@ export declare enum PurifierScheduleEnum {
     set = "purifierScheduleSet"
 }
 export declare enum CruiseEnum {
-    query = "cruiseQry",
-    set = "cruiseSet"
+    query = "purifierCruiseQry",
+    set = "purifierCruiseSet"
+}
+export declare enum McsRoomInfoEnum {
+    query = "McsRoomInfoQry"
 }

package/lib/mqtt/type/requestType.js

@@ -146,9 +146,15 @@ export let PurifierScheduleEnum = /*#__PURE__*/function (PurifierScheduleEnum) {
   return PurifierScheduleEnum;
 }({});
 
-// 巡航（通用：移动空气净化器、移动垃圾桶等移动设备）
+// 巡航（面板通用能力，设备侧使用净化器巡航协议）
 export let CruiseEnum = /*#__PURE__*/function (CruiseEnum) {
-  CruiseEnum["query"] = "cruiseQry";
-  CruiseEnum["set"] = "cruiseSet";
+  CruiseEnum["query"] = "purifierCruiseQry";
+  CruiseEnum["set"] = "purifierCruiseSet";
   return CruiseEnum;
+}({});
+
+// 设备当前所在房间（MCS 房间信息；RVC SDK Alexa 语音方案协议，通常仅在任务中查询）
+export let McsRoomInfoEnum = /*#__PURE__*/function (McsRoomInfoEnum) {
+  McsRoomInfoEnum["query"] = "McsRoomInfoQry";
+  return McsRoomInfoEnum;
 }({});

package/lib/mqtt/useMcsRoomInfo.d.ts

@@ -0,0 +1,9 @@
+import { type TRequestMcsRoomInfo } from './type/protocols/mcsRoomInfoProtocol';
+/**
+ * 自定义 Hook，用于查询设备当前所在房间（mapId / currNameId / currName）。
+ * 面板通常仅在设备处于任务中时查询，用于展示「当前位置」。
+ * @returns 包含 requestMcsRoomInfo 函数的对象
+ */
+export declare const useMcsRoomInfo: () => {
+    requestMcsRoomInfo: TRequestMcsRoomInfo;
+};

package/lib/mqtt/useMcsRoomInfo.js

@@ -0,0 +1,43 @@
+// 设备当前所在房间（MCS 房间信息）
+import { useContext } from 'react';
+import { handleMqttError, useStructuredMessage } from './hooks/useStructuredMessage';
+import { SingletonContext } from './mqttProvider';
+import { McsRoomInfoEnum } from './type';
+/**
+ * 自定义 Hook，用于查询设备当前所在房间（mapId / currNameId / currName）。
+ * 面板通常仅在设备处于任务中时查询，用于展示「当前位置」。
+ * @returns 包含 requestMcsRoomInfo 函数的对象
+ */
+export const useMcsRoomInfo = () => {
+  const {
+    useMqtt
+  } = useContext(SingletonContext);
+  const {
+    sendStructuredMessage
+  } = useStructuredMessage();
+
+  /**
+   * 查询设备当前所在房间
+   * @param message 可选参数，包含版本号
+   * @returns Promise<McsRoomInfoResponse> 响应结果
+   */
+
+  return {
+    requestMcsRoomInfo: 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(McsRoomInfoEnum.query, message, resolve, error => reject(handleMqttError(error, 'Failed to request mcs room info')));
+        } catch (error) {
+          reject(handleMqttError(error, 'Failed to request mcs room info'));
+        }
+      });
+    }
+  };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ray-js/robot-data-stream",
-  "version": "0.0.17-beta.2",
+  "version": "0.0.17-beta.4",
   "description": "扫地机P2P数据流标准化组件",
   "main": "lib/index",
   "files": [