跳到主要内容
提示

此功能在 5.12.0 版本开始支持。

群组页面

群组相关页面包含选择联系人、创建群组、群组设置、群成员列表等。

开通服务​

使用此功能前，您须在控制台开通信息托管服务。

选择/添加联系人页面​

选择或者添加联系人页面类是RCSelectUserViewController。

选择或者添加联系人页面默认显示的是信息托管服务上当前用户好友列表。

初始化​

// 群组id，非必传。当群组加人选人 `RCSelectUserTypeInviteJoinGroup`时必传
RCSelectUserViewModel *vm = [RCSelectUserViewModel viewModelWithType:RCSelectUserTypeCreateGroup groupId:nil];
RCSelectUserViewController *vc = [[RCSelectUserViewController alloc] initWithViewModel:vm];
[self.navigationController pushViewController:vc animated:YES];

RCSelectUserViewController 说明：

参数类型说明
viewModelRCSelectUserViewModelRCSelectUserViewController 的业务逻辑处理模块。 获取联系人列表并处理展示逻辑。

RCSelectUserViewModel 说明：

参数类型说明
typeRCSelectUserType选择联系人类型，包含创建群组选人 RCSelectUserTypeCreateGroup 和 群组加人选人 RCSelectUserTypeInviteJoinGroup
groupIdNSString群组id，非必传。当群组加人选人 RCSelectUserTypeInviteJoinGroup时必传

配置单次可选择的最大人数​

默认能选择的最大人数为 30，配置值需大于 0，小于等于 100。

RCSelectUserViewModel *vm = [RCSelectUserViewModel viewModelWithType:RCSelectUserTypeCreateGroup groupId:nil];
// 默认能选择的最大人数为 30
vm.maxSelectCount = 50;
RCSelectUserViewController *vc = [[RCSelectUserViewController alloc] initWithViewModel:vm];
[self.navigationController pushViewController:vc animated:YES];

拦截选择完成回调​

通过 RCSelectUserViewModel 代理 RCSelectUserViewModelDelegate 可以拦截选择完成回调。

添加代理：

RCSelectUserViewModel *vm = [RCSelectUserViewModel viewModelWithType:RCSelectUserTypeCreateGroup groupId:nil];
vm.delegate = self;
RCSelectUserViewController *vc = [[RCSelectUserViewController alloc] initWithViewModel:vm];
[self.navigationController pushViewController:vc animated:YES];

实现代理方法：

- (BOOL)selectUserDidSelectComplete:(RCSelectUserViewModel *)viewModel
                      selectUserIds:(NSMutableArray <NSString *>*)selectUserIds
                     viewController:(UIViewController*)viewController {

    return YES;//YES : SDK不再处理, NO: SDK处理
}

创建群组页面​

创建群组页面类 RCGroupCreateViewController。

初始化​

NSArray *selectUserIds = @[@"userId1", @"userId2"];
RCGroupCreateViewModel *viewModel = [RCGroupCreateViewModel viewModelWithInviteeUserIds:self.selectUserIds];
viewModel.delegate = self;
RCGroupCreateViewController *vc = [[RCGroupCreateViewController alloc] initWithViewModel:viewModel];
[self.navigationController pushViewController:vc animated:YES];
提示

群 id 是由开发者提供的，所以必须实现 RCGroupCreateViewModel 代理 RCGroupCreateViewModelDelegate 的下面方法给 SDK 提供群 Id。

- (NSString *)generateGroupId {
   return @"groupId";
}

RCGroupCreateViewController 说明：

参数类型说明
viewModelRCGroupCreateViewModelRCGroupCreateViewController 的业务逻辑处理模块。 创建群组逻辑处理。

RCGroupCreateViewModel 说明：

参数类型说明
inviteeUserIdsNSArray <NSString *>*当前选择的用户列表，不包含当前用户
delegateRCGroupCreateViewModelDelegate代理

自定义头像点击事件​

IMKit 自带的创建群组页面只有默认群头像，开发者如果需要创建时传入群头像，需要拦截头像点击事件处理，实现 RCGroupCreateViewModel 代理 RCGroupCreateViewModelDelegate 下面方法：

- (void)groupPortraitDidClick:(UIViewController *)inViewController
                  resultBlock:(void(^)(NSString *portraitUrl))resultBlock {
    //跳转选择头像，将选择结果通过resultBlock 回调给 SDK
    NSString *portraitRemoteUrl = @"上传远端后的头像 url";
    resultBlock(portraitRemoteUrl);
}

群组设置页面​

图中消息免打扰和会话置顶 cell 内置页面没有，是 demo 通过自定义 cell 方式实现的。

初始化​

群组设置页和用户资料页使用的是相同的页面 RCProfileViewController。区别是初始化传入的 ViewModel 不同。

RCGroupProfileViewModel *viewModel = [RCGroupProfileViewModel viewModelWithGroupId:self.targetId];
RCProfileViewController *vc = [[RCProfileViewController alloc] initWithViewModel:viewModel];
[self.navigationController pushViewController:vc
                                             animated:YES];

RCProfileViewController 说明：

参数类型说明
viewModelRCProfileViewModelRCProfileViewController 的业务逻辑处理模块。 群信息获取展示逻辑使用RCProfileViewModel 子类 RCGroupProfileViewModel 初始化。

RCGroupProfileViewModel 说明：

参数类型说明
groupIdNSString群组 Id

修改标题​

用户资料页 RCProfileViewController 使用了系统的导航栏，标题默认是群名称（群成员人数）组合，可以在初始化后修改

RCProfileViewController *vc = [[RCProfileViewController alloc] initWithViewModel:viewModel];
vc.title = @"custom title";

配置群组设置页展示的群成员数​

RCGroupProfileViewModel *viewModel = [RCGroupProfileViewModel viewModelWithGroupId:self.targetId];
viewModel.delegate = self;
/// 最多显示群成员个数，默认为 30, 设置 displayMaxMemberCount 需要不小于 5 个，不大于 50
viewModel.displayMaxMemberCount = 20;
RCProfileViewController *vc = [[RCProfileViewController alloc] initWithViewModel:viewModel];

自定义cell​

RCGroupProfileViewModel 跟 RCMyProfileViewModel继承同一个父类 RCProfileViewModel。 参考当前用户资料页自定义 cell 逻辑，注意在判断是否是群组设置页时 RCMyProfileViewModel 要替换成 RCGroupProfileViewModel。

群成员列表页面​

初始化​

群设置页面点击群成员 cell, 默认会直接跳转到群成员列表页面。如果需要自定义群成员列表页面，或者从其他地方跳转到群成员页面需要初始化群成员列表页面

RCGroupMemberListViewModel *viewModel = [RCGroupMemberListViewModel viewModelWithGroupId:self.groupId];
RCGroupMemberListViewController *membersVC = [[RCGroupMemberListViewController alloc] initWithViewModel:viewModel];
membersVC.title = @"群成员";
[self.navigationController pushViewController:membersVC animated:YES];

RCGroupMemberListViewController 说明：

参数类型说明
viewModelRCGroupMemberListViewModelRCGroupMemberListViewController 的业务逻辑处理模块。 群成员获取展示逻辑处理。

RCGroupMemberListViewModel 说明：

参数类型说明
groupIdNSString群 Id

配置每页加载群成员数​

在初始化RCGroupMemberListViewController页面时设置 RCGroupMemberListViewModel 属性 pageCount:

RCGroupMemberListViewModel *viewModel = [RCGroupMemberListViewModel viewModelWithGroupId:self.groupId];
/// 每页加载成员数, 默认 50，0 < pageCount <= 100
viewModel.pageCount = 60；

自定义群成员点击事件​

默认点击群成员跳转到内置用户资料页，开发者可以自定义拦截处理

在初始化RCGroupMemberListViewController页面时设置 RCGroupMemberListViewModel 代理 delegate:

RCGroupMemberListViewModel *viewModel = [RCGroupMemberListViewModel viewModelWithGroupId:group.groupId];
/// 设置代理
viewModel.delegate = self;

实现代理方法

- (BOOL)groupMemberList:(RCGroupMemberListViewModel *)viewModel
         viewController:(UIViewController*)viewController
              tableView:(UITableView *)tableView
           didSelectRow:(NSIndexPath *)indexPath
          cellViewModel:(RCGroupMemberCellViewModel *)cellViewModel {

    return YES;///YES : SDK不再处理, NO: SDK处理
}

移除群成员页面​

初始化​

默认 IMKit 群设置页已经实现了跳转移除群成员页面。如果需要自定义移除群成员页面，或者从其他地方跳转到该页面自行初始化

RCRemoveGroupMembersViewModel *viewModel = [RCRemoveGroupMembersViewModel viewModelWithGroupId:group.groupId];
RCRemoveGroupMembersViewController *vc = [[RCRemoveGroupMembersViewController alloc] initWithViewModel:viewModel];
[self.navigationController pushViewController:vc animated:YES];

RCRemoveGroupMembersViewController 说明：

参数类型说明
viewModelRCRemoveGroupMembersViewModelRCRemoveGroupMembersViewController 的业务逻辑处理模块。 群成员获取展示逻辑处理。

RCRemoveGroupMembersViewModel 说明：

参数类型说明
groupIdNSString群 Id

配置单次可选群成员数​

在初始化RCRemoveGroupMembersViewController页面时设置 RCRemoveGroupMembersViewModel 属性 maxSelectCount:

RCRemoveGroupMembersViewModel *viewModel = [RCRemoveGroupMembersViewModel viewModelWithGroupId:group.groupId];
/// 单次最多可选择数量，默认 30, 0 < maxSelectCount <= 100
viewModel.maxSelectCount = 60；

自定义群成员点击事件​

默认点击群成员跳转到内置用户资料页，开发者可以自定义拦截处理

在初始化RCRemoveGroupMembersViewController页面时设置 RCRemoveGroupMembersViewModel 代理 delegate:

RCRemoveGroupMembersViewModel *viewModel = [RCRemoveGroupMembersViewModel viewModelWithGroupId:group.groupId];
/// 设置代理
viewModel.delegate = self;

实现代理方法

- (BOOL)groupRemoveMembers:(RCRemoveGroupMembersViewModel *)viewModel
            viewController:(UIViewController*)viewController
                 tableView:(UITableView *)tableView
              didSelectRow:(NSIndexPath *)indexPath
             cellViewModel:(RCRemoveGroupMemberCellViewModel *)cellViewModel {

    return YES;///YES : SDK不再处理, NO: SDK处理
}

拦截选择完成回调​

在初始化RCRemoveGroupMembersViewController页面时设置 RCRemoveGroupMembersViewModel 代理 delegate:

RCRemoveGroupMembersViewModel *viewModel = [RCRemoveGroupMembersViewModel viewModelWithGroupId:group.groupId];
/// 设置代理
viewModel.delegate = self;

实现代理方法

- (BOOL)groupRemoveMembersDidSelectComplete:(RCRemoveGroupMembersViewModel *)viewModel
                              selectUserIds:(NSMutableArray <NSString *>*)selectUserIds
                             viewController:(UIViewController*)viewController {

    return YES;///YES : SDK不再处理, NO: SDK处理
}
编辑此页
最后由 Gordon Zhu 于 更新