智能小程序 Ray 开发设备信息 API —— getDeviceListByDevIds API 详解

getDeviceListByDevIds

通过设备 id 队列获取设备的设备信息队列, 用于批量获取设备信息。

引入

import { device } from '@ray-js/ray';
const { getDeviceListByDevIds } = device;

需引入DeviceKit，且在>=3.3.0 @ray-js/ray >= 0.9.0版本才可使用

请求参数

Object object

属性	类型	默认值	必填	说明
deviceIds	array		是	deviceId 设备 ids
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

返回结果

• success

属性	类型	说明
deviceInfos	Array<DeviceInfo>	设备信息队列

DeviceInfo

属性	类型	说明
schema	array	产品信息，schema，功能定义都在里面
dps	any	dps 设备的功能点状态，可以根据对应的 dpid 拿到具体的状态值去做业务逻辑
attribute	number	attribute 产品属性定义，在 backend-ng 平台上可查到对应配置，使用二进制位运算的方式进行管理
capability	number	capability 产品能力值，在 backend-ng 平台上可以查询对应的勾选项，整体业务逻辑会根据该数据进行划分 区分设备类型也可以根据该属性进行调整，按二进制位运算的方式进行管理
dpName	any	dpName 自定义 dp 的名字，通常在面板里会使用到
ability	number	ability 目前业务很少使用，用于区分特殊类型的设备
icon	string	icon 设备的 icon url
devId	string	devId 设备的唯一 id
verSw	string	verSw 设备固件版本号
isShare	boolean	isShare 是否为分享设备，true 则是分享设备
bv	string	bv 设备的基线版本号
uuid	string	uuid 设备的固件唯一标识
panelConfig	any	panelConfig 产品面板里的配置项，通常在 涂鸦开发者平台上可以查看到对应的配置
activeTime	number	activeTime 设备激活时间，时间戳
devAttribute	number	devAttribute 设备的业务能力拓展，二进制位的方式进行运算
pcc	string	pcc Thing 自研蓝牙 mesh 产品的分类标识
nodeId	string	nodeId 子设备的短地址
parentId	string	parentId 上级节点 id，子设备/或蓝牙 mesh 设备通常会有该字段，用于内部寻找相关的网关或上级模型来进行业务处理
category	string	category 产品的分类
standSchemaModel	object	standSchemaModel 标准产品功能集定义模型
productId	string	productId 设