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

ty.device.getShareDeviceInfo

获取共享设备信息

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

请求参数

Object object

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

返回结果

• success

属性	类型	说明
name	string	姓名
mobile	string	手机号
email	string	邮件

• fail

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

请求示例

ty.device.getShareDeviceInfo({
  deviceId: 'vdevo165649418612782',
})
  .then((res) => {
    console.log(res);
  })
  .catch((error) => {
    console.log(error);
  });

返回示例

{
  "name": "设备详情小程序",
  "email": "cn500**il.fr"
}

ty.device.getSupportedThirdPartyServices

获取设备支持的三方服务

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

请求参数

Object object

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

返回结果

• success

属性	类型	说明
services	Array<ThirdPartyService>	服务列表

• fail

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

请求示例

ty.device.getSupportedThirdPartyServices({
  deviceId: '64710761ecfabcaaf553',
})
  .then((res) => {
    console.log(res);
  })
  .catch((error) => {
    console.log(error);
  });

返回示例

{
  "services": [{
    "attributeKey": "DUEROS_SUPPORT",
    "attributeSign": 19,
    "serviceId": 9,
    "iconUrl": "https://images.tuyacn.com/app/thirdparty/du@3x.png",
    "originJson": {
      "id": 9,
      "attributeSign": 19,
      "url": "https://app-third.tuyacn.com/thirdCode?platform=dueros",
      "iconV2": "https://images.tuyacn.com/app/thirdparty/du@3x.png",
      "iconMini": "https://images.tuyacn.comnull",
      "remark": "小度",
      "iconShow": "0",
      "group": "1",
      "icon": "https://images.tuyacn.com/app/thirdparty/du@3x.png",
      "nameKey": "personal_speech_service_dueros",
      "newRemark": "小度",
      "attributeKey": "DUEROS_SUPPORT"
    },
    "name": "小度",
    "url": "https://app-third.tuyacn.com/thirdCode?platform=dueros"
  }]
}

👉 立即开发。 

ty.device.isDeviceSupportOfflineReminder

设备是否支持离线提醒

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

请求参数

Object object

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

返回结果

• success

属性	类型	说明
isSupport	boolean	support 是否支持设备离线提醒

• fail

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

请求示例

ty.device.isDeviceSupportOfflineReminder({
  deviceId: 'vdevo165649418612782',
})
  .then((res) => {
    console.log(res);
  })
  .catch((error) => {
    console.log(error);
  });

返回示例

  {
    isSupport: true
  }

ty.device.syncDeviceInfo

同步设备信息

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

请求参数

Object object

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

返回结果

• success

无

• fail

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

请求示例

ty.device.syncDeviceInfo({
  deviceId: '64710761ecfabcaaf553'
})
  .then((res) => {
    console.log(res);
  })
  .catch((error) => {
    console.log(error);
  });

👉 立即开发。 

ty.device.renameDeviceName

修改设备名称

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

请求参数

Object object

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

返回结果

• success

无

• fail

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

请求示例

ty.device.renameDeviceName({
  deviceId: '64710761ecfabcaaf553',
  name: 'device-f553',
})
  .then((res) => {
    console.log(res);
  })
  .catch((error) => {
    console.log(error);
  });

ty.device.toggleDeviceOfflineReminder

离线提醒开关

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

请求参数

Object object

属性	类型	默认值	必填	说明
deviceId	string		是	deviceId 设备 id
state	number		是	state 设备离线提醒的开关状态 0:关 1:开
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

返回结果

• success

无

• fail

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

请求示例

ty.device.toggleDeviceOfflineReminder({
  deviceId: 'vdevo165649418612782',
  state: 1, 
})
  .then((res) => {
    console.log(res);
  })
  .catch((error) => {
    console.log(error);
  });

👉 立即开发。