智能小程序 Ray 开发设备信息 API —— 位置信息和告警 API 汇总

位置信息 API 

saveCustomizePosition

创建设备自定义位置信息。

说明：当天气接口不适用于设备配网经纬度时，可通过自定义设备经纬度获取实时天气，例如户外穿戴设备。

请求参数

参数	数据类型	说明	是否必填
devId	String	设备 ID	是
lon	String	经度	是
lat	String	纬度	是
locationName	String	位置名称（目前没用，不影响天气返回结果）	否

返回结果

Boolean boolean

请求示例

import { saveCustomizePosition } from '@ray-js/ray';
 
saveCustomizePosition({
  devId: `${YOUR_DEVICE_ID}`,
  lon: '113.2333',
  lat: '23.1666',
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

true;

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。 

getCustomizePosition

设备自定义位置信息获取。

请求参数

参数	数据类型	说明	是否必填
devId	String	设备 ID	是

返回结果

参数	数据类型	说明
lon	String	经度
lat	String	纬度

请求示例

import { getCustomizePosition } from '@ray-js/ray';
 
getCustomizePosition({
  devId: `${YOUR_DEVICE_ID}`,
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

{
  "lon": "113.2333",
  "lat": "23.1666"
}

getDevAlarmList

注意：
如需使用告警接口请先为产品配置告警，具体操作参见 设置告警。

根据设备 ID 查询告警列表信息。

请求参数

参数	数据类型	说明	是否必填
devId	String	设备 ID	是

返回结果

Object object

参数	数据类型	说明
auditStatus	Number	审核状态
boundForPanel	Boolean	是否被场景面板绑定
boundForWiFiPanel	Boolean	是否被 WIFI 场景面板绑定
enabled	Boolean	是否启用
i18nData	{ name: { en: string; zh: string }	多语言数据体
id	String	规则 ID
localLinkage	Boolean	是否为本地联动
name	String	规则名称
newLocalScene	Boolean	是否为 APP 管控本地联动
stickyOnTop	Boolean	场景是否显示在首页

请求示例

import { getDevAlarmList } from '@ray-js/ray';
import { hooks } from '@ray-js/panel-sdk';
const { useDevInfo } = hooks;
 
const devInfo = useDevInfo();
 
getDevAlarmList(devInfo.devId)
  .then((response) => {
    console.log(response);
    console.log(JSON.stringify(response));
  })
  .catch();

返回示例

{
  "auditStatus": 1,
  "boundForPanel": false,
  "boundForWiFiPanel": false,
  "enabled": true,
  "i18nData": {"name": { "en": "", "zh": "" }, "content": { "en": "", "zh": "" }},
  "id": "35ix",
  "iotAutoAlarm": false,
  "isLogicRule": false,
  "localLinkage": false,
  "name": "Wi-Fi 人体红外报警",
  "newLocalScene": false,
  "stickyOnTop": false
  }

setAlarmSwitch

注意：
如需使用告警接口请先为产品配置告警，具体操作参见 设置告警。

启用或者禁用设备的告警。

请求参数

参数	数据类型	说明	是否必填
devId	String	设备 ID	是
disabled	Boolean	是否禁用	否
ruleIds	String	规则 ID 串	是

返回结果

Boolean boolean

请求示例

import { setAlarmSwitch } from '@ray-js/ray';
 
setAlarmSwitch({
  devId: 'vdevo159297901023732',
  disabled: true, // 告警全部开启时，参数值为 false
  ruleIds: '3TIXnerlNHeJAugm,8skS74SGlVkwSdbD', // 告警全部开启时，该字段为空字符串
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回结果

true;

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。