小程序开发——获取设备信息 API(四)

ty.device.addDeviceToDesk

添加设备到桌面

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

请求参数

Object object

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

返回结果

  • success

无

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

请求示例

复制代码
ty.device.addDeviceToDesk({
  deviceId: '64710761ecfabcaaf553',
})
  .then((res) => {
    console.log(res);
  })
  .catch((error) => {
    console.log(error);
  });

👉 立即开发。

ty.device.getEncryptLocalKeyWithData

获取加密过的设备 localKey

BLE(thing)蓝牙大数据通道传输过程中需要用到的特殊加密操作

需引入DeviceKit,且在>=1.2.6版本才可使用

请求参数

Object object

属性 类型 默认值 必填 说明
deviceId string 是 大数据通道加密计算结构 deviceId 设备 id
keyDeviceId string 是 keyDeviceId 需要传输加密密钥的设备 Id
complete function 否 接口调用结束的回调函数(调用成功、失败都会执行)
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

返回结果

  • success

String string

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

请求示例

复制代码
ty.device.getEncryptLocalKeyWithData({
  deviceId: '64710761ecfabcaaf553',
  keyDeviceId: '64710761ecfabcaaf553',
})
  .then((res) => {
    console.log(res);
  })
  .catch((error) => {
    console.log(error);
  });

返回示例

复制代码
42954ff1dcc15a996b7f270f4767f594

ty.device.registerDeviceListListener

注册需要监听的设备列表的监听器

需引入DeviceKit,且在>=2.3.1版本才可使用

请求参数

Object object

属性 类型 默认值 必填 说明
deviceIdList Array 是 需注册的设备 id 列表
complete function 否 接口调用完成的回调函数(成功或失败都会执行)
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

返回结果

  • success

无

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

请求示例

复制代码
ty.device.registerDeviceListListener({
  deviceIdList: [ '64710761ecfabcaaf553' ]
});

ty.device.unregisterDeviceListListener

注销需要监听的设备列表的监听器

需引入DeviceKit,且在>=2.3.1版本才可使用

请求参数

Object object

属性 类型 默认值 必填 说明
complete function 否 接口调用结束的回调函数(调用成功、失败都会执行)
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

返回结果

  • success

无

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

请求示例

复制代码
ty.device.unregisterDeviceListListener();

👉 立即开发。

ty.device.onDeviceInfoUpdated

设备 dp 名字和设备名字更新时触发

需引入DeviceKit,且在>=1.2.6版本才可使用

请求参数

Function Callback

设备 dp 名字和设备名字更新时触发的回调函数

返回结果

Object object

属性 类型 默认值 必填 说明
deviceId string 是 deviceId 设备 id 支持跨面板获取其他的设备信息,当前面板可以传当前设备的 id 来进行获取
dps Object 否 dps

请求示例

复制代码
ty.device.onDeviceInfoUpdated((res) => {
  console.log(res);
})

返回示例

复制代码
{
  "dps": {
    "1": false,
    "9": 0,
    "38": "off",
    "40": "relay",
    "42": "",
    "43": "",
    "44": "invalid"
  },
  "deviceId": "vdevo167878067815995"
}

ty.device.offDeviceInfoUpdated

取消监听:设备 dp 名字和设备名字更新时触发

需引入DeviceKit,且在>=2.1.6版本才可使用

请求参数

Function Callback

取消监听:设备 dp 名字和设备名字更新时触发的回调函数

返回结果

无

请求示例

复制代码
ty.device.offDeviceInfoUpdated(() => {});

ty.device.onDeviceOnlineStatusUpdate

设备上下线状态变更

需引入DeviceKit,且在>=1.2.6版本才可使用

请求参数

Function Callback

设备上下线状态变更的回调函数

回调结果

Object object

属性 类型 默认值 必填 说明
online boolean 是 在线状态
deviceId string 是 设备 id
onlineType number 否 设备在线类型(预留,后期使用) Wi-Fi online 1 << 0 Local online 1 << 1 Bluetooth LE online 1 << 2 Bluetooth LE mesh online 1 << 3

请求示例

复制代码
ty.device.onDeviceOnlineStatusUpdate((res) => {
  console.log(res);
})

返回示例

复制代码
{
  "online": true,
  "deviceId": "vdevo167878067815995"
}

ty.device.offDeviceOnlineStatusUpdate

取消监听:设备上下线状态变更

需引入DeviceKit,且在>=2.1.6版本才可使用

参数

function callback

取消监听:设备上下线状态变更的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
online boolean 是 在线状态
deviceId string 是 设备 id
onlineType number 是 设备在线类型(预留,后期使用) Wi-Fi online 1 << 0 Local online 1 << 1 Bluetooth LE online 1 << 2 Bluetooth LE mesh online 1 << 3

👉 立即开发。

相关推荐
星落梦生6 小时前
SpringAOP基础笔记(7)
java·开发语言
Flynt6 小时前
AI 写的 Three.js 大屏,为什么越跑越卡?我在 Node 里复现了它的内存曲线
前端·ai编程·three.js
曹牧8 小时前
Java:“刷新雪崩”
java·开发语言
郝学胜-神的一滴8 小时前
Effective STL 条款03:容器中的对象复制要廉价且正确
开发语言·数据结构·c++·算法·rpc·stl
一个游离的指针8 小时前
Vue2:vue-router
前端·javascript·vue.js
西西弗Sisyphus9 小时前
C++ explicit 关键字工程实践
开发语言·c++
用户45141942932210 小时前
2026 Vue 生态分析:底层重写了一遍,升级却几乎零成本
vue.js
凌晨三点说晚安10 小时前
理解 JavaScript 对象、原型与包装类
javascript
郝学胜-神的一滴11 小时前
Effective Python 条款35:用类封装替代生成器异常注入
开发语言·人工智能·python·金融·pandas·scikit-learn·matplotlib
火山引擎和TA的超级拍档们11 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端