帮你快速理解、总结文档立即下载
文档中心>物联网开发平台>客户端 API>Android>TXIoTDeviceManager

TXIoTDeviceManager

最近更新时间：2026-07-30 12:00:38

我的收藏

本页目录：

概述

TXIoTDeviceManager 负责设备的绑定/解绑、房间归属、设备分享、指令下发、属性查询与别名修改等。TXIoTDeviceManager 通过 TXIoTEngine.getDeviceManager 获取实例，需在登录成功后调用。
说明：
设备必须先绑定到家庭后才能进行后续操作。绑定方式有两种：
(1) 通过 bindDevice 使用设备绑定签名直接绑定。
(2) 通过 bindDeviceSharedWithMe 接受他人分享的设备。

方法列表

方法签名
描述
绑定设备到家庭。
从家庭解绑设备。
将设备添加到房间。
将设备从房间移除。
获取家庭设备列表（支持分页）。
创建设备分享令牌。
绑定别人分享给我的设备。
取消绑定别人分享给我的设备。
获取设备已分享的用户列表。
移除设备已分享用户。
获取别人分享给我的设备列表（支持分页）。
向设备发送指令。
查询设备属性。
修改设备别名。

bindDevice

bindDevice
void bindDevice
(String familyId, String deviceBindSignature, TXIoTCallback<TXIoTDeviceInfo> callback)
绑定设备到家庭
参数
描述
familyId
String；家庭 ID。
deviceBindSignature
String；设备绑定签名。
callback
TXIoTCallback<TXIoTDeviceInfo>；异步回调，通过 onSuccess / onError 通知结果。

unbindDevice

unbindDevice
void unbindDevice
(String familyId, TXIoTDeviceId deviceId, TXIoTCallback<Void> callback)
从家庭解绑设备
参数
描述
familyId
String；家庭 ID。
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
callback
TXIoTCallback<Void>；异步回调，通过 onSuccess / onError 通知结果。

addDeviceToRoom

addDeviceToRoom
void addDeviceToRoom
(TXIoTDeviceId deviceId, String familyId, String roomId, TXIoTCallback<Void> callback)
将设备添加到房间
参数
描述
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
familyId
String；家庭 ID。
roomId
String；房间 ID。
callback
TXIoTCallback<Void>；异步回调，通过 onSuccess / onError 通知结果。

removeDeviceFromRoom

removeDeviceFromRoom
void removeDeviceFromRoom
(TXIoTDeviceId deviceId, String familyId, TXIoTCallback<Void> callback)
将设备从房间移除
参数
描述
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
familyId
String；家庭 ID。
callback
TXIoTCallback<Void>；异步回调，通过 onSuccess / onError 通知结果。

getDeviceList

getDeviceList
void getDeviceList
(String familyId, String nextPageToken, TXIoTCallback<TXIoTPageResult<TXIoTDeviceInfo>> callback)
获取家庭设备列表（支持分页）
参数
描述
familyId
String；家庭 ID。
nextPageToken
String；分页令牌，首次传空字符串。
callback
TXIoTCallback<TXIoTPageResult<TXIoTDeviceInfo>>；异步回调，通过 onSuccess / onError 通知结果。

createDeviceSharingToken

createDeviceSharingToken
void createDeviceSharingToken
(String family_id, TXIoTDeviceId deviceId, TXIoTCallback<String> callback)
创建设备分享令牌
参数
描述
family_id
String；家庭 ID。
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
callback
TXIoTCallback<String>；异步回调，通过 onSuccess / onError 通知结果。

bindDeviceSharedWithMe

bindDeviceSharedWithMe
void bindDeviceSharedWithMe
(TXIoTDeviceId deviceId, String shareToken, TXIoTCallback<Void> callback)
绑定别人分享给我的设备
参数
描述
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
shareToken
String；分享令牌。
callback
TXIoTCallback<Void>；异步回调，通过 onSuccess / onError 通知结果。

unbindDeviceSharedWithMe

unbindDeviceSharedWithMe
void unbindDeviceSharedWithMe
(TXIoTDeviceId deviceId, TXIoTCallback<Void> callback)
取消绑定别人分享给我的设备
参数
描述
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
callback
TXIoTCallback<Void>；异步回调，通过 onSuccess / onError 通知结果。

getDeviceSharedUsers

getDeviceSharedUsers
void getDeviceSharedUsers
(TXIoTDeviceId deviceId, TXIoTCallback<List<TXIoTUserInfo>> callback)
获取设备已分享的用户列表
参数
描述
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
callback
TXIoTCallback<List<TXIoTUserInfo>>；异步回调，通过 onSuccess / onError 通知结果。

removeDeviceSharedUser

removeDeviceSharedUser
void removeDeviceSharedUser
(TXIoTDeviceId deviceId, String userId, TXIoTCallback<Void> callback)
移除设备已分享用户
参数
描述
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
userId
String；用户 ID。
callback
TXIoTCallback<Void>；异步回调，通过 onSuccess / onError 通知结果。

getDeviceListSharedWithMe

getDeviceListSharedWithMe
void getDeviceListSharedWithMe
(String nextPageToken, TXIoTCallback<TXIoTPageResult<TXIoTDeviceInfo>> callback)
获取别人分享给我的设备列表（支持分页）
参数
描述
nextPageToken
String；分页令牌，首次传空字符串。
callback
TXIoTCallback<TXIoTPageResult<TXIoTDeviceInfo>>；异步回调，通过 onSuccess / onError 通知结果。

sendCommand

sendCommand
void sendCommand
(TXIoTDeviceId deviceId, String jsonData, TXIoTCallback<String> callback)
向设备发送指令
参数
描述
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
jsonData
String；JSON 格式的指令数据。
callback
TXIoTCallback<String>；异步回调，通过 onSuccess / onError 通知结果。

getProperties

getProperties
void getProperties
(TXIoTDeviceId deviceId, TXIoTCallback<String> callback)
查询设备属性
参数
描述
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
callback
TXIoTCallback<String>；异步回调，通过 onSuccess / onError 通知结果。

modifyAliasName

modifyAliasName
void modifyAliasName
(TXIoTDeviceId deviceId, String aliasName, TXIoTCallback<Void> callback)
修改设备别名
参数
描述
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
aliasName
String；设备别名。
callback
TXIoTCallback<Void>；异步回调，通过 onSuccess / onError 通知结果。
中国站