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

你可以直接使用 KIMContactPickerViewController
类传入相关配置来集成通讯录选择器。
接口定义
swift
init(config: KIMContactConfig)
Objective-C
- (instancetype)initWithConfig:(KIMContactConfig *)config;
参数说明
参数 | 类型 | 说明 |
---|---|---|
config | KIMContactConfig | 通讯录初始化配置参数 |
KIMContactConfig
属性说明:
属性 | 类型 | 说明 |
---|---|---|
maxSupportCount | Int | 最大支持选择数量,默认为 10 |
canMultipleSelect | Bool | 是否支持多选,默认为 true |
selectType | enmu:KIMContactSelectType | 选择类型,默认为选择会话。 |
contactPickerCallback | ((_ seletedResults: [KIMContactSelectedResult], _ error: KIMError?, _ vc: KIMContactPickerViewController) -> Void) | 选择完成后的回调。 seletedResults:所选择的数据; error:错误信息,返回为 nil 时,意为成功; vc:当前选择器视图控制器 |
KIMContactSelectedResult
属性说明:
属性 | 类型 | 说明 |
---|---|---|
chat | KIMContactSelectedChat | 选择会话信息模型,包含会话 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];