概述
TXIoTDeviceManager 负责设备的绑定/解绑、房间归属、设备分享、指令下发、属性查询与别名修改、设备 VoIP 通知等。TXIoTDeviceManager 通过 TXIoTEngine.getDeviceManager 获取实例，需在登录成功后调用。
说明：
设备必须先绑定到家庭后才能进行后续操作。绑定方式有两种：
1. 通过
bindDevice 使用设备绑定签名直接绑定。2. 通过
bindDeviceSharedWithMe 接受他人分享的设备。方法列表
方法签名 | 描述 |
绑定设备到家庭。 | |
从家庭解绑设备。 | |
将设备添加到房间。 | |
获取设备 VoIP 授权票据。 | |
注册设备 VoIP 通知。 | |
注销设备 VoIP 通知。 | |
获取设备 VoIP 授权用户列表。 | |
将设备从房间移除。 | |
获取家庭设备列表（支持分页）。 | |
创建设备分享令牌。 | |
绑定别人分享给我的设备。 | |
取消绑定别人分享给我的设备。 | |
获取设备已分享的用户列表。 | |
移除设备已分享用户。 | |
获取别人分享给我的设备列表（支持分页）。 | |
向设备发送指令。 | |
查询设备属性。 | |
修改设备别名。 |
bindDevice
bindDevice
bindDevice | (familyId, deviceBindSignature) |
unbindDevice
unbindDevice
unbindDevice | (familyId, deviceId) |
从家庭解绑设备
参数 | 描述 |
familyId | string；家庭 ID。 |
deviceId |
返回值 | 描述 |
Promise<void> | 操作结果。 |
addDeviceToRoom
addDeviceToRoom
addDeviceToRoom | (deviceId, familyId, roomId) |
将设备添加到房间
参数 | 描述 |
deviceId | |
familyId | string；家庭 ID。 |
roomId | string；房间 ID。 |
返回值 | 描述 |
Promise<void> | 操作结果。 |
requestVoIPSnTicket
requestVoIPSnTicket
requestVoIPSnTicket | (deviceId, modelId, appId) |
获取设备 VoIP 授权票据
返回的 sn/snTicket 供小程序自行调用
wx.requestDeviceVoIP 完成微信侧授权弹窗（插件上下文无此 API）。参数 | 描述 |
deviceId | |
modelId | string；微信公众平台「设备接入」分配的 model_id。 |
appId | string；小程序 AppID。 |
返回值 | 描述 |
Promise<Object> | 包含 sn（设备序列号）与 snTicket（VoIP 授权票据）字段。 |
registerVoIPNotificationForDevice
registerVoIPNotificationForDevice
registerVoIPNotificationForDevice | (deviceId, modelId, appId, wxOpenId) |
注册设备 VoIP 通知
调用前需先通过
requestVoIPSnTicket 获取票据，并调用 wx.requestDeviceVoIP 完成微信侧授权弹窗。参数 | 描述 |
deviceId | |
modelId | string；微信公众平台「设备接入」分配的 model_id。 |
appId | string；小程序 AppID。 |
wxOpenId | string；当前用户微信 OpenID。 |
返回值 | 描述 |
Promise<void> | 操作结果。 |
unregisterVoIPNotificationForDevice
unregisterVoIPNotificationForDevice
unregisterVoIPNotificationForDevice | (deviceId, modelId, appId, wxOpenId) |
注销设备 VoIP 通知
参数 | 描述 |
deviceId | |
modelId | string；微信公众平台「设备接入」分配的 model_id。 |
appId | string；小程序 AppID。 |
wxOpenId | string；当前用户微信 OpenID。 |
返回值 | 描述 |
Promise<void> | 操作结果。 |
getAuthorizedVoIPUserList
getAuthorizedVoIPUserList
getAuthorizedVoIPUserList | (deviceId) |
获取设备 VoIP 授权用户列表
参数 | 描述 |
deviceId |
返回值 | 描述 |
Promise<List<String>> | 已授权用户的微信 OpenID 列表。 |
removeDeviceFromRoom
removeDeviceFromRoom
removeDeviceFromRoom | (deviceId, familyId) |
将设备从房间移除
参数 | 描述 |
deviceId | |
familyId | string；家庭 ID。 |
返回值 | 描述 |
Promise<void> | 操作结果。 |
getDeviceList
getDeviceList
getDeviceList | (familyId, nextPageToken) |
获取家庭设备列表（支持分页）
参数 | 描述 |
familyId | string；家庭 ID。 |
nextPageToken | string；分页令牌，首次传空字符串。 |
返回值 | 描述 |
设备列表。 |
createDeviceSharingToken
createDeviceSharingToken
createDeviceSharingToken | (familyId, deviceId) |
创建设备分享令牌
参数 | 描述 |
familyId | string；家庭 ID。 |
deviceId |
返回值 | 描述 |
Promise<string> | 分享令牌。 |
bindDeviceSharedWithMe
bindDeviceSharedWithMe
bindDeviceSharedWithMe | (deviceId, shareToken) |
绑定别人分享给我的设备
参数 | 描述 |
deviceId | |
shareToken | string；分享令牌。 |
返回值 | 描述 |
Promise<void> | 操作结果。 |
unbindDeviceSharedWithMe
unbindDeviceSharedWithMe
unbindDeviceSharedWithMe | (deviceId) |
getDeviceSharedUsers
getDeviceSharedUsers
getDeviceSharedUsers | (deviceId) |
获取设备已分享的用户列表
参数 | 描述 |
deviceId |
返回值 | 描述 |
用户列表。 |
removeDeviceSharedUser
removeDeviceSharedUser
removeDeviceSharedUser | (deviceId, userId) |
移除设备已分享用户
参数 | 描述 |
deviceId | |
userId | string；用户 ID。 |
返回值 | 描述 |
Promise<void> | 操作结果。 |
getDeviceListSharedWithMe
getDeviceListSharedWithMe
getDeviceListSharedWithMe | (nextPageToken) |
获取别人分享给我的设备列表（支持分页）
参数 | 描述 |
nextPageToken | string；分页令牌，首次传空字符串。 |
返回值 | 描述 |
设备列表。 |
sendCommand
sendCommand
sendCommand | (deviceId, jsonData) |
向设备发送指令
参数 | 描述 |
deviceId | |
jsonData | string；JSON 格式的指令数据。 |
返回值 | 描述 |
Promise<string> | 设备返回的应答数据字符串。 |
getProperties
getProperties
getProperties | (deviceId) |
modifyAliasName
modifyAliasName
modifyAliasName | (deviceId, aliasName) |
修改设备别名
参数 | 描述 |
deviceId | |
aliasName | string；设备别名。 |
返回值 | 描述 |
Promise<void> | 操作结果。 |
