小程序开发——获取设备信息 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);});

👉 立即开发。