@ray-js/api 1.7.69 → 1.7.71

package/lib/cloud/device.d.ts

@@ -1,28 +1,89 @@
-import { IGetDpsInfos, IUpdateDpName, IUpdateGroupDpName, IGetWeatherQuality, IGetWeathers, ISaveCustomizePosition, IGetCustomizePosition, IGetDpsInfosResponse, IGetGroupDpsInfosResponse, IGetWeatherQualityResponse, IGetCustomizePositionResponse, IGetWeathersResponse, IGetDevProperty, IGetDevPropertyResponse, ISaveDevProperty } from './interface';
+import { IGetDpsInfos, IUpdateDpName, IUpdateGroupDpName, IGetWeatherQuality, IGetWeathers, ISaveCustomizePosition, IGetCustomizePosition, IGetDpsInfosResponse, IGetGroupDpsInfosResponse, IGetWeatherQualityResponse, IGetCustomizePositionResponse, IGetWeathersResponse, IGetDevProperty, IGetDevPropertyResponse, ISaveDevProperty, ISaveDevPropertyResponse } from './interface';
 /**
- * 获取设备所有 DP 信息
- * @param {string} gwId 网关Id, 直连设备值同 devId，子设备则传网关的设备id
- * @param {string} devId 设备Id
+ * 获取设备所有 DP 信息，通常用于获取设备 DP 名称，配合 updateDpName 使用
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns DP 信息数组，每个元素包含 code、dpId、value、time、type、name
+ * @example 基础用法
+ * ```ts
+ * import { getDpsInfos } from '@ray-js/ray';
+ *
+ * getDpsInfos({
+ *   devId: 'vdevo169477319679442',
+ *   gwId: 'vdevo169477319679442',
+ * }).then((res) => {
+ *   console.log('DP 信息:', res);
+ * }).catch((error) => {
+ *   console.error(error);
+ * });
+ * ```
  */
 declare const getDpsInfos: (params: IGetDpsInfos) => Promise<IGetDpsInfosResponse[]>;
 /**
  * 更新设备 DP 名称
- * @param {string} devId 设备Id
- * @param {string} dpId dpId
- * @param {string} name dp自定义名称
- * @param {string} gwId 设备Id, 可不传
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 是否成功更新
+ * @example 基础用法
+ * ```ts
+ * import { updateDpName } from '@ray-js/ray';
+ *
+ * updateDpName({
+ *   devId: 'vdevo169477319679442',
+ *   dpId: '21',
+ *   name: 'work_mode',
+ * }).then((res) => {
+ *   console.log('更新结果:', res);
+ * }).catch((error) => {
+ *   console.error(error);
+ * });
+ * ```
  */
 declare const updateDpName: (params: IUpdateDpName) => Promise<boolean>;
 /**
- * 获取群组设备所有 DP 信息
- * @param {string} groupId 群组id
+ * 获取群组设备所有 DP 信息，通常用于获取群组设备 DP 名称，配合 updateGroupDpName 使用
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param groupId - 群组 ID
+ * @returns DP 信息对象，包含 code、dpId、value、name、time、type
+ * @example 基础用法
+ * ```ts
+ * import { getGroupDpsInfos } from '@ray-js/ray';
+ *
+ * getGroupDpsInfos('1').then((response) => {
+ *   console.log('群组 DP 信息:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 declare const getGroupDpsInfos: (groupId: string) => Promise<IGetGroupDpsInfosResponse>;
 /**
  * 更新群组设备 DP 名称
- * @param {string} groupId 群组id
- * @param {string} dpId dpId
- * @param {string} name dp自定义名称
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 是否成功更新群组设备 DP 名称
+ * @example 基础用法
+ * ```ts
+ * import { updateGroupDpName } from '@ray-js/ray';
+ *
+ * updateGroupDpName({
+ *   group: '1',
+ *   dpId: '20',
+ *   name: 'switch_led',
+ * }).then((response) => {
+ *   console.log('更新结果:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 declare const updateGroupDpName: (params: IUpdateGroupDpName) => Promise<boolean>;
 /**
@@ -38,28 +99,98 @@ declare const getWeatherQuality: (params: IGetWeatherQuality) => Promise<IGetWea
  */
 declare const getWeathers: (params: IGetWeathers) => Promise<IGetWeathersResponse>;
 /**
- * 创建设备自定义位置信息
- * @param {string} devId 设备Id
- * @param {string} lon 经度
- * @param {string} lat 纬度
- * @param {string} locationName 位置名称（目前没用，不影响天气返回结果）
+ * 创建设备自定义位置信息。当天气接口不适用于设备配网经纬度时，可通过自定义设备经纬度获取实时天气，例如户外穿戴设备。
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 是否成功保存
+ * @example 基础用法
+ * ```ts
+ * import { saveCustomizePosition } from '@ray-js/ray';
+ *
+ * saveCustomizePosition({
+ *   devId: 'your_device_id',
+ *   lon: '113.2333',
+ *   lat: '23.1666',
+ * }).then((response) => {
+ *   console.log('保存结果:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 declare const saveCustomizePosition: (params: ISaveCustomizePosition) => Promise<boolean>;
 /**
  * 设备自定义位置信息获取
- * @param {string} devId 设备Id
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 包含 lon（经度）和 lat（纬度）的位置信息对象
+ * @example 基础用法
+ * ```ts
+ * import { getCustomizePosition } from '@ray-js/ray';
+ *
+ * getCustomizePosition({
+ *   devId: 'your_device_id',
+ * }).then((response) => {
+ *   console.log('位置信息:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 declare const getCustomizePosition: (params: IGetCustomizePosition) => Promise<IGetCustomizePositionResponse>;
 /**
- * 获取设备属性
- * @param {string} devId 设备Id
+ * 获取自定义设置的设备属性数据，可通过 saveDevProperty 写入
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 设备属性数据数组
+ * @example 基础用法
+ * ```ts
+ * import { getDevProperty } from '@ray-js/ray';
+ *
+ * getDevProperty({
+ *   devId: 'your_device_id',
+ *   bizType: 0,
+ *   code: 'hello',
+ * }).then((response) => {
+ *   console.log('设备属性:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 declare const getDevProperty: (params: IGetDevProperty) => Promise<IGetDevPropertyResponse>;
 /**
- * 保存设备属性
- * @param {string} devId 设备Id
+ * 写入自定义设置的设备属性数据，保存后可通过 getDevProperty 获取
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 是否成功保存
+ * @example 基础用法
+ * ```ts
+ * import { saveDevProperty } from '@ray-js/ray';
+ *
+ * saveDevProperty({
+ *   devId: 'your_device_id',
+ *   bizType: 0,
+ *   propertyList: JSON.stringify([
+ *     { code: 'hello', value: 'world' },
+ *     { code: 'foo', value: 'bar' },
+ *   ]),
+ * }).then((response) => {
+ *   console.log('保存结果:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
-declare const saveDevProperty: (params: ISaveDevProperty) => Promise<boolean>;
+declare const saveDevProperty: (params: ISaveDevProperty) => Promise<ISaveDevPropertyResponse>;
 export interface GetRemoteLocalRelationParams {
     /**
      * 遥控器设备id

package/lib/cloud/device.js

@@ -3,9 +3,25 @@ import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import { requestCloud } from '../';
 import { THING } from '../constants';
 /**
- * 获取设备所有 DP 信息
- * @param {string} gwId 网关Id, 直连设备值同 devId，子设备则传网关的设备id
- * @param {string} devId 设备Id
+ * 获取设备所有 DP 信息，通常用于获取设备 DP 名称，配合 updateDpName 使用
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns DP 信息数组，每个元素包含 code、dpId、value、time、type、name
+ * @example 基础用法
+ * ```ts
+ * import { getDpsInfos } from '@ray-js/ray';
+ *
+ * getDpsInfos({
+ *   devId: 'vdevo169477319679442',
+ *   gwId: 'vdevo169477319679442',
+ * }).then((res) => {
+ *   console.log('DP 信息:', res);
+ * }).catch((error) => {
+ *   console.error(error);
+ * });
+ * ```
  */
 const getDpsInfos = params => {
   return requestCloud({
@@ -17,10 +33,25 @@ const getDpsInfos = params => {
 
 /**
  * 更新设备 DP 名称
- * @param {string} devId 设备Id
- * @param {string} dpId dpId
- * @param {string} name dp自定义名称
- * @param {string} gwId 设备Id, 可不传
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 是否成功更新
+ * @example 基础用法
+ * ```ts
+ * import { updateDpName } from '@ray-js/ray';
+ *
+ * updateDpName({
+ *   devId: 'vdevo169477319679442',
+ *   dpId: '21',
+ *   name: 'work_mode',
+ * }).then((res) => {
+ *   console.log('更新结果:', res);
+ * }).catch((error) => {
+ *   console.error(error);
+ * });
+ * ```
  */
 const updateDpName = params => {
   return requestCloud({
@@ -31,8 +62,22 @@ const updateDpName = params => {
 };
 
 /**
- * 获取群组设备所有 DP 信息
- * @param {string} groupId 群组id
+ * 获取群组设备所有 DP 信息，通常用于获取群组设备 DP 名称，配合 updateGroupDpName 使用
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param groupId - 群组 ID
+ * @returns DP 信息对象，包含 code、dpId、value、name、time、type
+ * @example 基础用法
+ * ```ts
+ * import { getGroupDpsInfos } from '@ray-js/ray';
+ *
+ * getGroupDpsInfos('1').then((response) => {
+ *   console.log('群组 DP 信息:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 const getGroupDpsInfos = groupId => {
   return requestCloud({
@@ -46,9 +91,25 @@ const getGroupDpsInfos = groupId => {
 
 /**
  * 更新群组设备 DP 名称
- * @param {string} groupId 群组id
- * @param {string} dpId dpId
- * @param {string} name dp自定义名称
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 是否成功更新群组设备 DP 名称
+ * @example 基础用法
+ * ```ts
+ * import { updateGroupDpName } from '@ray-js/ray';
+ *
+ * updateGroupDpName({
+ *   group: '1',
+ *   dpId: '20',
+ *   name: 'switch_led',
+ * }).then((response) => {
+ *   console.log('更新结果:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 const updateGroupDpName = params => {
   return requestCloud({
@@ -85,11 +146,26 @@ const getWeathers = params => {
 };
 
 /**
- * 创建设备自定义位置信息
- * @param {string} devId 设备Id
- * @param {string} lon 经度
- * @param {string} lat 纬度
- * @param {string} locationName 位置名称（目前没用，不影响天气返回结果）
+ * 创建设备自定义位置信息。当天气接口不适用于设备配网经纬度时，可通过自定义设备经纬度获取实时天气，例如户外穿戴设备。
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 是否成功保存
+ * @example 基础用法
+ * ```ts
+ * import { saveCustomizePosition } from '@ray-js/ray';
+ *
+ * saveCustomizePosition({
+ *   devId: 'your_device_id',
+ *   lon: '113.2333',
+ *   lat: '23.1666',
+ * }).then((response) => {
+ *   console.log('保存结果:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 const saveCustomizePosition = params => {
   return requestCloud({
@@ -101,7 +177,23 @@ const saveCustomizePosition = params => {
 
 /**
  * 设备自定义位置信息获取
- * @param {string} devId 设备Id
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 包含 lon（经度）和 lat（纬度）的位置信息对象
+ * @example 基础用法
+ * ```ts
+ * import { getCustomizePosition } from '@ray-js/ray';
+ *
+ * getCustomizePosition({
+ *   devId: 'your_device_id',
+ * }).then((response) => {
+ *   console.log('位置信息:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 const getCustomizePosition = params => {
   return requestCloud({
@@ -112,8 +204,26 @@ const getCustomizePosition = params => {
 };
 
 /**
- * 获取设备属性
- * @param {string} devId 设备Id
+ * 获取自定义设置的设备属性数据，可通过 saveDevProperty 写入
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 设备属性数据数组
+ * @example 基础用法
+ * ```ts
+ * import { getDevProperty } from '@ray-js/ray';
+ *
+ * getDevProperty({
+ *   devId: 'your_device_id',
+ *   bizType: 0,
+ *   code: 'hello',
+ * }).then((response) => {
+ *   console.log('设备属性:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 const getDevProperty = params => {
   return requestCloud({
@@ -124,8 +234,29 @@ const getDevProperty = params => {
 };
 
 /**
- * 保存设备属性
- * @param {string} devId 设备Id
+ * 写入自定义设置的设备属性数据，保存后可通过 getDevProperty 获取
+ *
+ * @public
+ * @since @ray-js/ray 1.5.2
+ * @param params - 请求参数
+ * @returns 是否成功保存
+ * @example 基础用法
+ * ```ts
+ * import { saveDevProperty } from '@ray-js/ray';
+ *
+ * saveDevProperty({
+ *   devId: 'your_device_id',
+ *   bizType: 0,
+ *   propertyList: JSON.stringify([
+ *     { code: 'hello', value: 'world' },
+ *     { code: 'foo', value: 'bar' },
+ *   ]),
+ * }).then((response) => {
+ *   console.log('保存结果:', response);
+ * }).catch((err) => {
+ *   console.error(err);
+ * });
+ * ```
  */
 const saveDevProperty = params => {
   return requestCloud({

package/lib/cloud/gateway.d.ts

@@ -1,4 +1,258 @@
+/// <reference path="../../@types/GroupCITestKit.d.ts" />
 /// <reference path="../../@types/gateway.d.ts" />
+/**
+ * @public
+ */
+export declare const hasParamsMethod: typeof ty.groupcitest.hasParamsMethod;
+/**
+ * @public
+ */
+export declare const richDocMethod: typeof ty.groupcitest.richDocMethod;
+/**
+ * 下发更新 LQI 指令，用于刷新网关子设备的信号质量值
+ * @param params.devId 子设备 ID
+ * @returns 是否下发成功
+ * @public
+ * @since @ray-js/ray 1.7.60
+ * @example
+ * ```typescript
+ * import { gateway } from '@ray-js/ray';
+ *
+ * const refreshLQI = async () => {
+ *   try {
+ *     const success = await gateway.sendCmdForRefreshDeviceLQI({
+ *       devId: 'sub_device_001',
+ *     });
+ *     console.log('下发刷新LQI指令:', success);
+ *   } catch (err) {
+ *     console.error('下发失败:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare const sendCmdForRefreshDeviceLQI: typeof ty.gateway.sendCmdForRefreshDeviceLQI;
+/**
+ * 获取设备最新 LQI（链路质量指示）信息
+ * @param params.devId 子设备 ID
+ * @param params.offsetTime 时间偏移量，单位为毫秒
+ * @returns 设备 LQI 信息列表
+ * @public
+ * @since @ray-js/ray 1.7.60
+ * @example
+ * ```typescript
+ * import { gateway } from '@ray-js/ray';
+ *
+ * const fetchLQI = async () => {
+ *   try {
+ *     const lqiList = await gateway.getLastDeviceLQI({
+ *       devId: 'sub_device_001',
+ *       offsetTime: 60000,
+ *     });
+ *     lqiList.forEach(item => {
+ *       console.log(`设备: ${item.deviceName}, LQI: ${item.lqi}`);
+ *     });
+ *   } catch (err) {
+ *     console.error('获取LQI失败:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare const getLastDeviceLQI: typeof ty.gateway.getLastDeviceLQI;
+/**
+ * 查询设备高级能力，返回设备支持的扩展能力键值对
+ * @param params.devId 设备 ID
+ * @returns 设备高级能力键值对
+ * @public
+ * @since @ray-js/ray 1.7.60
+ * @example
+ * ```typescript
+ * import { gateway } from '@ray-js/ray';
+ *
+ * const querySeniorAbility = async () => {
+ *   try {
+ *     const abilities = await gateway.getSeniorAbility({
+ *       devId: 'device_001',
+ *     });
+ *     console.log('设备高级能力:', abilities);
+ *   } catch (err) {
+ *     console.error('查询失败:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare const getSeniorAbility: typeof ty.gateway.getSeniorAbility;
+/**
+ * 获取网关子设备数量限制，包括各类型子设备的上限
+ * @param params.devId 设备 ID
+ * @returns 子设备数量限制信息
+ * @public
+ * @since @ray-js/ray 1.7.60
+ * @example
+ * ```typescript
+ * import { gateway } from '@ray-js/ray';
+ *
+ * const fetchSubDevLimit = async () => {
+ *   try {
+ *     const limit = await gateway.getGatewaySubDevLimit({
+ *       devId: 'gateway_001',
+ *     });
+ *     console.log('子设备上限:', limit.max);
+ *     console.log('蓝牙子设备上限:', limit.blu);
+ *     console.log('Zigbee子设备上限:', limit.zig);
+ *   } catch (err) {
+ *     console.error('获取失败:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare const getGatewaySubDevLimit: typeof ty.gateway.getGatewaySubDevLimit;
+/**
+ * Mesh 类设备拖拽，将子设备从一个 Mesh 网络移动到另一个
+ * @param params.nodeIds 需要拖拽的子设备 ID 列表
+ * @param params.sourceMeshId 原 Mesh ID 或网关 ID
+ * @param params.targetMeshId 目标 Mesh ID 或网关 ID
+ * @returns 拖拽结果，包含已在目标网关下的设备列表
+ * @public
+ * @since @ray-js/ray 1.7.60
+ * @example
+ * ```typescript
+ * import { gateway } from '@ray-js/ray';
+ *
+ * const moveMeshDevices = async () => {
+ *   try {
+ *     const result = await gateway.updateRelationMesh({
+ *       nodeIds: ['node_001', 'node_002'],
+ *       sourceMeshId: 'mesh_source',
+ *       targetMeshId: 'mesh_target',
+ *     });
+ *     if (result.repeatNodeIds.length > 0) {
+ *       console.log('已在目标网关下的设备:', result.repeatNodeIds);
+ *     }
+ *   } catch (err) {
+ *     console.error('拖拽失败:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare const updateRelationMesh: typeof ty.gateway.updateRelationMesh;
+/**
+ * 蓝牙单点类设备拖拽，将蓝牙子设备从一个网关移动到另一个
+ * @param params.nodes 需要拖拽的子设备 ID 与 UUID 列表
+ * @param params.sourceMeshId 原网关 ID
+ * @param params.targetMeshId 目标网关 ID
+ * @returns 拖拽结果，包含已在目标网关下的设备列表
+ * @public
+ * @since @ray-js/ray 1.7.60
+ * @example
+ * ```typescript
+ * import { gateway } from '@ray-js/ray';
+ *
+ * const moveBlueDevices = async () => {
+ *   try {
+ *     const result = await gateway.updateRelationBlue({
+ *       nodes: [
+ *         { devId: 'blue_dev_001', uuid: 'uuid_001' },
+ *         { devId: 'blue_dev_002', uuid: 'uuid_002' },
+ *       ],
+ *       sourceMeshId: 'gateway_source',
+ *       targetMeshId: 'gateway_target',
+ *     });
+ *     if (result.repeatNodeIds.length > 0) {
+ *       console.log('已在目标网关下的设备:', result.repeatNodeIds);
+ *     }
+ *   } catch (err) {
+ *     console.error('拖拽失败:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare const updateRelationBlue: typeof ty.gateway.updateRelationBlue;
+/**
+ * Beacon 类设备拖拽，将 Beacon 子设备从一个网关移动到另一个
+ * @param params.nodes 需要拖拽的子设备 ID 与 MAC 列表
+ * @param params.sourceMeshId 原网关 ID
+ * @param params.targetMeshId 目标网关 ID
+ * @returns 拖拽结果，包含已在目标网关下的设备列表
+ * @public
+ * @since @ray-js/ray 1.7.60
+ * @example
+ * ```typescript
+ * import { gateway } from '@ray-js/ray';
+ *
+ * const moveBeaconDevices = async () => {
+ *   try {
+ *     const result = await gateway.updateRelationBeacon({
+ *       nodes: [
+ *         { devId: 'beacon_dev_001', mac: 'AA:BB:CC:DD:EE:01' },
+ *         { devId: 'beacon_dev_002', mac: 'AA:BB:CC:DD:EE:02' },
+ *       ],
+ *       sourceMeshId: 'gateway_source',
+ *       targetMeshId: 'gateway_target',
+ *     });
+ *     if (result.repeatNodeIds.length > 0) {
+ *       console.log('已在目标网关下的设备:', result.repeatNodeIds);
+ *     }
+ *   } catch (err) {
+ *     console.error('拖拽失败:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare const updateRelationBeacon: typeof ty.gateway.updateRelationBeacon;
+/**
+ * 获取网关的能力信息，包括信号质量、性能指标和子设备数量上限
+ * @param params.devIds 设备 ID 拼成的字符串，以逗号分隔
+ * @returns 网关能力信息列表
+ * @public
+ * @since @ray-js/ray 1.7.60
+ * @example
+ * ```typescript
+ * import { gateway } from '@ray-js/ray';
+ *
+ * const fetchGatewayAbility = async () => {
+ *   try {
+ *     const abilities = await gateway.getGatewayAbility({
+ *       devIds: 'gateway_001,gateway_002',
+ *     });
+ *     abilities.forEach(item => {
+ *       console.log(`设备: ${item.devId}, 能力值: ${item.capability}, LQI: ${item.lqi}`);
+ *     });
+ *   } catch (err) {
+ *     console.error('获取失败:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare const getGatewayAbility: typeof ty.gateway.getGatewayAbility;
+/**
+ * 获取设备安全日志，支持分页查询
+ * @param params.queryStr 查询条件字符串
+ * @returns 设备日志数据，包含日志列表和分页信息
+ * @public
+ * @since @ray-js/ray 1.7.60
+ * @example
+ * ```typescript
+ * import { gateway } from '@ray-js/ray';
+ *
+ * const fetchDeviceLog = async () => {
+ *   try {
+ *     const logData = await gateway.getSecurityDeviceLog({
+ *       queryStr: 'device_001',
+ *     });
+ *     console.log('总数:', logData.totalCount);
+ *     logData.datas.forEach(log => {
+ *       console.log(`DP: ${log.dpName}, 值: ${log.value}, 时间: ${log.eventTime}`);
+ *     });
+ *     if (logData.hasNext) {
+ *       console.log('还有更多数据');
+ *     }
+ *   } catch (err) {
+ *     console.error('获取日志失败:', err);
+ *   }
+ * };
+ * ```
+ */
+export declare const getSecurityDeviceLog: typeof ty.gateway.getSecurityDeviceLog;
 export declare const gateway: {
     sendCmdForRefreshDeviceLQI: typeof ty.gateway.sendCmdForRefreshDeviceLQI;
     getLastDeviceLQI: typeof ty.gateway.getLastDeviceLQI;