位置信息 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 小程序开发。