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

ty.device.addDeviceToDesk

添加设备到桌面

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

请求参数

Object object

返回结果

• success

无

• fail

请求示例

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

返回结果

• success

String string

• fail

请求示例

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

返回结果

• success

无

• fail

请求示例

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

ty.device.unregisterDeviceListListener

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

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

请求参数

Object object

返回结果

• success

无

• fail

请求示例

ty.device.unregisterDeviceListListener();

👉 立即开发。 

ty.device.onDeviceInfoUpdated

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

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

请求参数

Function Callback

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

返回结果

Object object

请求示例

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

请求示例

ty.device.onDeviceOnlineStatusUpdate((res) => {
  console.log(res);
})

返回示例

{
  "online": true,
  "deviceId": "vdevo167878067815995"
}

ty.device.offDeviceOnlineStatusUpdate

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

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

参数

function callback

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

回调参数 Object res

👉 立即开发。