家庭管理

TXIoTFamilyManager *familyManager = [[TXIoTEngine getInstance] getFamilyManager];
if (familyManager == nil) {
    // SDK 未登录或登录已过期，请先完成登录。
    return;
}

TXIoTCallback<NSArray<TXIoTFamilyInfo *> *> *listCallback = [[TXIoTCallback alloc] init];
listCallback.onSuccess = ^(NSArray<TXIoTFamilyInfo *> *familyList) {
    if (familyList.count == 0) {
        // 新账号尚无家庭，创建一个默认家庭。
        TXIoTCallback<TXIoTFamilyInfo *> *createCallback = [[TXIoTCallback alloc] init];
        createCallback.onSuccess = ^(TXIoTFamilyInfo *familyInfo) {
            NSString *familyId = familyInfo.familyId;
        };
        createCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
            // 创建家庭失败，请检查家庭名称是否为空。
        };
        [familyManager createFamily:@"我的家" callback:createCallback];
        return;
    }
    TXIoTFamilyInfo *family = familyList.firstObject;
    NSString *familyId = family.familyId;
    BOOL isAdmin = (family.role == TXIoTFamilyRoleAdmin);
};
listCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 查询家庭列表失败，请根据错误码和错误信息处理。
};
[familyManager getFamilyList:listCallback];

// 管理员：创建邀请 Token。
TXIoTCallback<NSString *> *tokenCallback = [[TXIoTCallback alloc] init];
tokenCallback.onSuccess = ^(NSString *inviteToken) {
    // 通过业务自有渠道把 inviteToken 发送给被邀请用户。
};
tokenCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 创建邀请 Token 失败，请确认当前用户是该家庭的管理员。
};
[familyManager createFamilyInviteToken:familyId callback:tokenCallback];

// 被邀请用户：使用邀请 Token 加入家庭。
TXIoTVoidCallback *joinCallback = [[TXIoTVoidCallback alloc] init];
joinCallback.onSuccess = ^{
    // 加入成功，重新调用 getFamilyList 即可看到该家庭。
};
joinCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 加入失败，请检查邀请 Token 是否为空或已过期。
};
[familyManager joinFamilyAsMember:inviteToken callback:joinCallback];

// 先查询成员列表，再基于返回的 userId 执行移除或退出。
TXIoTCallback<NSArray<TXIoTUserInfo *> *> *memberCallback = [[TXIoTCallback alloc] init];
memberCallback.onSuccess = ^(NSArray<TXIoTUserInfo *> *memberList) {
    if (memberList.count == 0) {
        return;
    }
    TXIoTUserInfo *self = [[TXIoTEngine getInstance] getLoginUserInfo];
    NSString *targetUserId = memberList.firstObject.userId;
    BOOL isSelf = [targetUserId isEqualToString:self.userId];
    // isSelf 为 YES 时语义是「退出家庭」，否则是「管理员移除成员」。

    TXIoTVoidCallback *removeCallback = [[TXIoTVoidCallback alloc] init];
    removeCallback.onSuccess = ^{
        // 操作成功，请刷新成员列表或家庭列表。
    };
    removeCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
        // 操作失败，请确认权限，并确认 userId 取自 getMemberList。
    };
    [familyManager removeMemberFromFamily:familyId
                                  userId:targetUserId
                                callback:removeCallback];
};
memberCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 查询成员列表失败，请根据错误码和错误信息处理。
};
[familyManager getMemberList:familyId callback:memberCallback];

// 修改家庭名称：familyId 定位家庭，name 为新名称。
TXIoTFamilyInfo *newInfo = [[TXIoTFamilyInfo alloc] init];
newInfo.familyId = familyId;
newInfo.name = @"度假别墅";
TXIoTVoidCallback *updateCallback = [[TXIoTVoidCallback alloc] init];
updateCallback.onSuccess = ^{
    // 修改成功，可直接更新本地 UI。
};
updateCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 修改失败，请检查家庭名称是否为空。
};
[familyManager updateFamilyInfo:newInfo callback:updateCallback];

// 删除家庭（建议先弹窗二次确认）。
TXIoTVoidCallback *deleteCallback = [[TXIoTVoidCallback alloc] init];
deleteCallback.onSuccess = ^{
    // 删除成功，请刷新家庭列表并切换到其他家庭。
};
deleteCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 删除失败，请确认当前用户是该家庭的管理员。
};
[familyManager deleteFamily:familyId callback:deleteCallback];

// 创建房间。
TXIoTCallback<TXIoTRoomInfo *> *createCallback = [[TXIoTCallback alloc] init];
createCallback.onSuccess = ^(TXIoTRoomInfo *roomInfo) {
    NSString *roomId = roomInfo.roomId;
    // 后续可按「设备的房间归属」小节把设备加入该房间。
};
createCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 创建房间失败，请检查房间名称是否为空。
};
[familyManager createRoom:familyId name:@"客厅" callback:createCallback];

// 查询房间列表。
TXIoTCallback<NSArray<TXIoTRoomInfo *> *> *roomListCallback = [[TXIoTCallback alloc] init];
roomListCallback.onSuccess = ^(NSArray<TXIoTRoomInfo *> *roomList) {
    for (TXIoTRoomInfo *room in roomList) {
        // room.roomId / room.name / room.deviceCount
    }
};
roomListCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 查询房间列表失败，请根据错误码和错误信息处理。
};
[familyManager getRoomList:familyId callback:roomListCallback];

// 重命名房间。
TXIoTVoidCallback *renameCallback = [[TXIoTVoidCallback alloc] init];
renameCallback.onSuccess = ^{
    // 重命名成功。
};
renameCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 重命名失败，请根据错误码和错误信息处理。
};
[familyManager setRoomName:familyId roomId:roomId name:@"主卧" callback:renameCallback];

// 删除房间（房间内设备不会被解绑）。
TXIoTVoidCallback *deleteRoomCallback = [[TXIoTVoidCallback alloc] init];
deleteRoomCallback.onSuccess = ^{
    // 删除成功，请刷新房间列表。
};
deleteRoomCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 删除失败，请根据错误码和错误信息处理。
};
[familyManager deleteRoom:familyId roomId:roomId callback:deleteRoomCallback];

// 将设备加入房间。
TXIoTVoidCallback *addCallback = [[TXIoTVoidCallback alloc] init];
addCallback.onSuccess = ^{
    // 加入房间成功。
};
addCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 加入房间失败，请根据错误码和错误信息处理。
};
[deviceManager addDeviceToRoom:deviceId
                     familyId:familyId
                       roomId:roomId
                     callback:addCallback];

// 将设备移出房间（无需传 roomId）。
TXIoTVoidCallback *removeCallback = [[TXIoTVoidCallback alloc] init];
removeCallback.onSuccess = ^{
    // 移出房间成功。
};
removeCallback.onError = ^(TXIoTErrorCode errorCode, NSString *errorMessage) {
    // 移出房间失败，请根据错误码和错误信息处理。
};
[deviceManager removeDeviceFromRoom:deviceId familyId:familyId callback:removeCallback];