Skip to content
能力中心
产品中心
应用市场
WebOffice
开发者后台

集成通讯录选择器

协作中台SDK 除了提供基本的通讯录页面功能外,还提供了通讯录选择器功能。你可以通过实例化通讯录视图控制器,传入配置参数及回调参数,达到通过通讯录选择器选择会话的需求。

效果展示

你可以直接使用 KIMContactPickerViewController 类传入相关配置来集成通讯录选择器。

接口定义

swift
init(config: KIMContactConfig)
Objective-C
- (instancetype)initWithConfig:(KIMContactConfig *)config;

参数说明

参数类型说明
configKIMContactConfig通讯录初始化配置参数

KIMContactConfig 属性说明:

属性类型说明
maxSupportCountInt最大支持选择数量,默认为 10
canMultipleSelectBool是否支持多选,默认为 true
selectTypeenmu:KIMContactSelectType选择类型,默认为选择会话。
contactPickerCallback((_ seletedResults: [KIMContactSelectedResult], _ error: KIMError?, _ vc: KIMContactPickerViewController) -> Void)选择完成后的回调。
seletedResults:所选择的数据;
error:错误信息,返回为 nil 时,意为成功;
vc:当前选择器视图控制器

KIMContactSelectedResult 属性说明:

属性类型说明
chatKIMContactSelectedChat选择会话信息模型,包含会话 ID,会话名称等数据

代码示例

swift
let config = KIMContactConfig.init(selectType: .chat) { seletedResults, error, vc in
    // 处理返回结果
}
let contactPiker = KIMContactPickerViewController.init(config: config)
self.navigationController?.pushViewController(contactPiker, animated: true)
Objective-C
KIMContactConfig *config = [[KIMContactConfig alloc] initWithMaxSupportCount:10
                                                           canMultipleSelect:YES selectType:KIMContactSelectTypeChat
                                                       contactPickerCallback:^(NSArray<KIMContactSelectedResult *> * _Nonnull,
                                                                               KIMError * _Nullable,
                                                                               KIMContactViewController * _Nonnull) {
    // 处理返回结果
}];
KIMContactPickerViewController *contactPiker = [[KIMContactPickerViewController alloc] initWithConfig: config];
[self.navigationController pushViewController:contactPiker animated:YES];