帮你快速理解、总结文档立即下载

TXIoTFamilyManager

最近更新时间:2026-10-27 17:33:32
我的收藏

概述

TXIoTFamilyManager 负责家庭的创建/删除/更新、房间的创建/删除/重命名,以及家庭成员的邀请与管理。TXIoTFamilyManager 通过 TXIoTEngine.getFamilyManager 获取实例,需在登录成功后调用。
说明:
家庭是设备的顶层组织单元,房间是家庭下的二级分组。用户创建家庭后自动成为 ADMIN,可通过 createFamilyInviteToken 生成邀请令牌,其他用户通过 joinFamilyAsMember 加入。

方法列表

方法签名
描述
createFamily
创建家庭。
deleteFamily
删除家庭。
getFamilyList
获取当前用户的家庭列表。
updateFamilyInfo
更新家庭信息(如名称)。
createRoom
在指定家庭下创建房间。
deleteRoom
删除指定房间。
setRoomName
设置/修改房间名称。
getRoomList
获取指定家庭的房间列表。
createFamilyInviteToken
创建家庭邀请令牌。
joinFamilyAsMember
通过令牌加入家庭。
removeMemberFromFamily
从家庭中移除成员。
getMemberList
获取家庭成员列表。

createFamily

createFamily
createFamily
(name: string, callback: TXIoTCallback<TXIoTFamilyInfo>): void
创建家庭
参数
描述
name
string;家庭名称。
callback
TXIoTCallback<TXIoTFamilyInfo>;异步回调,通过 onSuccess / onError 通知结果。

deleteFamily

deleteFamily
deleteFamily
(familyId: string, callback: TXIoTCallback<void>): void
删除家庭
参数
描述
familyId
string;家庭 ID。
callback
TXIoTCallback<void>;异步回调,通过 onSuccess / onError 通知结果。

getFamilyList

getFamilyList
getFamilyList
(callback: TXIoTCallback<TXIoTFamilyInfo[]>): void
获取当前用户的家庭列表
参数
描述
callback
TXIoTCallback<TXIoTFamilyInfo[]>;异步回调,通过 onSuccess / onError 通知结果。

updateFamilyInfo

updateFamilyInfo
updateFamilyInfo
(newFamilyInfo: TXIoTFamilyInfo, callback: TXIoTCallback<void>): void
更新家庭信息(如名称)
参数
描述
newFamilyInfo
TXIoTFamilyInfo;家庭信息对象,familyId 必填。
callback
TXIoTCallback<void>;异步回调,通过 onSuccess / onError 通知结果。

createRoom

createRoom
createRoom
(familyId: string, name: string, callback: TXIoTCallback<TXIoTRoomInfo>): void
在指定家庭下创建房间
参数
描述
familyId
string;家庭 ID。
name
string;房间名称。
callback
TXIoTCallback<TXIoTRoomInfo>;异步回调,通过 onSuccess / onError 通知结果。

deleteRoom

deleteRoom
deleteRoom
(familyId: string, roomId: string, callback: TXIoTCallback<void>): void
删除指定房间
参数
描述
familyId
string;家庭 ID。
roomId
string;房间 ID。
callback
TXIoTCallback<void>;异步回调,通过 onSuccess / onError 通知结果。

setRoomName

setRoomName
setRoomName
(familyId: string, roomId: string, name: string, callback: TXIoTCallback<void>): void
设置/修改房间名称
参数
描述
familyId
string;家庭 ID。
roomId
string;房间 ID。
name
string;房间名称。
callback
TXIoTCallback<void>;异步回调,通过 onSuccess / onError 通知结果。

getRoomList

getRoomList
getRoomList
(familyId: string, callback: TXIoTCallback<TXIoTRoomInfo[]>): void
获取指定家庭的房间列表
参数
描述
familyId
string;家庭 ID。
callback
TXIoTCallback<TXIoTRoomInfo[]>;异步回调,通过 onSuccess / onError 通知结果。

createFamilyInviteToken

createFamilyInviteToken
createFamilyInviteToken
(familyId: string, callback: TXIoTCallback<string>): void
创建家庭邀请令牌
参数
描述
familyId
string;家庭 ID。
callback
TXIoTCallback<string>;异步回调,onSuccess 返回邀请令牌字符串。

joinFamilyAsMember

joinFamilyAsMember
joinFamilyAsMember
(inviteToken: string, callback: TXIoTCallback<void>): void
通过令牌加入家庭
参数
描述
inviteToken
string;邀请令牌。
callback
TXIoTCallback<void>;异步回调,通过 onSuccess / onError 通知结果。

removeMemberFromFamily

removeMemberFromFamily
removeMemberFromFamily
(familyId: string, userId: string, callback: TXIoTCallback<void>): void
从家庭中移除成员
参数
描述
familyId
string;家庭 ID。
userId
string;用户 ID,取 getMemberList 返回的 TXIoTUserInfo.userId 原值。
callback
TXIoTCallback<void>;异步回调,通过 onSuccess / onError 通知结果。

getMemberList

getMemberList
getMemberList
(familyId: string, callback: TXIoTCallback<TXIoTUserInfo[]>): void
获取家庭成员列表
参数
描述
familyId
string;家庭 ID。
callback
TXIoTCallback<TXIoTUserInfo[]>;异步回调,通过 onSuccess / onError 通知结果。
注意:
该接口不支持分页,单次最多返回 50 条成员记录。