智能小程序 Ray 开发设备控制 API —— DP相关 API 合集（一）

updateDpName

更新设备 DP 名称。

引入

import { updateDpName } from '@ray-js/ray';

请求参数

参数	数据类型	说明	是否必填
devId	String	设备 ID	是
dpId	String	DP ID	是
name	String	DP 自定义名称	是

返回参数

• success

Boolean boolean

• fail

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

请求示例

import { updateDpName } from '@ray-js/ray';
 
updateDpName({
  devId: 'vdevo169477319679442',
  dpId: '21',
  name: 'work_mode',
})
  .then((res) => {
    console.log(res);
  })
  .catch(error => {
    console.log(error);
  });

返回示例

true

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

getDpsInfos

获取设备所有 DP 信息。

引入

import { getDpsInfos } from '@ray-js/ray';

请求参数

参数	数据类型	说明	是否必填
devId	String	设备 ID	是
gwId	String	网关 ID, 直连设备值同 devId，子设备则传网关的设备id	是

返回结果

• success

Array<dpInfo>

dpInfo

参数	数据类型	说明
code	String	DP Code
dpId	Number	DP ID
value	String	DP 值
time	Number	DP 最近上报时间
type	String	DP 类型

fail

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

请求示例

import { getDpsInfos } from '@ray-js/ray';
 
getDpsInfos({
  devId: 'vdevo169477319679442',
  gwId: 'vdevo169477319679442',
})
  .then(res => {
    console.log(res);
  })
  .catch(error => {
    console.log(error);
  });

返回示例

[{
  "dpId": 1,
  "value": "false",
  "code": "switch_led",
  "type": "bool",
  "time": 1695016796840
}, {
  "dpId": 2,
  "value": "white",
  "code": "work_mode",
  "type": "enum",
  "time": 1695016736328
}, {
  "dpId": 3,
  "value": "327",
  "code": "bright_value",
  "type": "value",
  "time": 1695005906565
}, {
  "dpId": 4,
  "value": "0",
  "code": "temp_value",
  "type": "value",
  "time": 1694773196845
}, {
  "dpId": 5,
  "value": "002600000000",
  "code": "colour_data",
  "type": "string",
  "time": 1695016233353
}, {
  "dpId": 6,
  "value": "",
  "code": "scene_data",
  "type": "string",
  "time": 1694773196845
}, {
  "dpId": 7,
  "value": "0",
  "code": "countdown",
  "type": "value",
  "time": 1694773196845
}, {
  "dpId": 8,
  "value": "",
  "code": "music_data",
  "type": "string",
  "time": 1694773196845
}, {
  "dpId": 30,
  "code": "rhythm_mode",
  "type": "raw",
  "time": 1694773196845
}, {
  "dpId": 31,
  "code": "sleep_mode",
  "type": "raw",
  "time": 1694773196845
}, {
  "dpId": 32,
  "code": "wakeup_mode",
  "type": "raw",
  "time": 1694773196845
}, {
  "dpId": 33,
  "code": "power_memory",
  "type": "raw",
  "time": 1694773196845
}, {
  "dpId": 34,
  "value": "false",
  "code": "do_not_disturb",
  "type": "bool",
  "time": 1694773196845
}, {
  "dpId": 35,
  "code": "switch_gradient",
  "type": "raw",
  "time": 1694773196845
}, {
  "dpId": 37,
  "code": "rtc_timer",
  "type": "raw",
  "time": 1694773196845
}, {
  "dpId": 38,
  "code": "timer_report",
  "type": "raw",
  "time": 1694773196845
}, {
  "dpId": 210,
  "code": "random_timing",
  "type": "raw",
  "time": 1694773196845
}]

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