小程序开发——获取设备信息 API（二）

最新推荐文章于 2025-06-16 16:34:22 发布

原创

最新推荐文章于 2025-06-16 16:34:22 发布 · 1.1k 阅读

27 ·

CC 4.0 BY-SA版权

文章标签：

#javascript #前端 #vue.js #App #API #小程序 #开发语言

本文详细介绍了DeviceKit库中的几个关键API，包括获取群组设备数量、设备离线提醒状态、在线类型检查、子设备ID获取以及产品信息查询，展示了如何通过这些接口进行设备管理和状态监控。

ty.device.getDeviceNumWithDpCode

根据 dpCode 获取群组下具备此 dpCode 的设备数量。如果是一个分享的群组，请通过接口获取。

需引入DeviceKit，且在>=2.4.0版本才可使用

请求参数

Object object

属性	类型	必填	说明
groupId	`string`	是	groupId 群组 id
dpCode	`string`	是	dpCode 内容
complete	`function`	否	接口调用结束的回调函数（调用成功、失败都会执行）
success	`function`	否	接口调用成功的回调函数
fail	`function`	否	接口调用失败的回调函数

返回结果

success

属性	类型	说明
devieNum	`number`	devieNum 设备数量

fail

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

请求示例

ty.device.getDeviceNumWithDpCode({
  groupId: '12894745',
  dpCode: 'switch_1',
})
  .then((res) => {
    console.log(res);
  })
  .catch((error) => {
    console.log(error);
  });

返回示例

{
  "devieNum": 0
}

ty.device.getDeviceOfflineReminderState

获取设备离线提醒的开关状态

需引入DeviceKit，且在>=2.2.0版本才可使用

请求参数

Object object

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