一. 简介
- 在iOS9.0之前, 由于几乎只能通过使用了CoreFoundation的AddressBook框架来获取联系人信息, 为了避免使用这个蛋疼繁琐的框架, 绝大多数的程序员都使用了封装好的三方框架, 由此引起了苹果的重视, 终于在iOS9.0之后, 推出了最新的框架ContactsUI和Contacts专门来获取联系人信息
- 特点:
- ContactsUI和Contacts的使用方法与AddressBookUI和AddressBook基本相同
- 可以把这个新框架理解为面向对象版本的封装
- 但是只能在iOS9.0以后的版本使用
二. 简单使用ContactsUI
- ContactsUI是有图形界面的联系人获取方法, 他可以创建
CNContactPickerViewController来创建UI界面 - 当使用这个框架的时候, 系统会自动发送授权申请, 不需要手动授权
- 注意点:
这个框架主要是使用其代理方法来获取数据的
如果实现了点击联系人调用的代理方法的话, 联系人详情界面就不会显示了
-
遵守的协议为: <CNContactPickerDelegate>
- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event { // 1. 创建选择联系人控制器 CNContactPickerViewController *pickerVC = [[CNContactPickerViewController alloc] init]; // 2. 设置代理 pickerVC.delegate = self; // 3. 弹出控制器 [self presentViewController:pickerVC animated:YES completion:nil]; } #pragma mark - 代理方法 // 控制器点击取消的时候调用 - (void)contactPickerDidCancel:(CNContactPickerViewController *)picker { NSLog(@"点击了取消"); } // 点击了联系人的时候调用, 如果实现了这个方法, 就无法进入联系人详情界面 - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact { // contact属性就是联系人的信息 NSLog(@"%@---%@", contact.namePrefix, contact.familyName); // 获取联系人的电话号码 NSArray<CNLabeledValue<CNPhoneNumber*>*> *phoneNumbers = contact.phoneNumbers; // 注意, 由于这个数组规定了泛型, 所以要使用遍历器来取出每一个特定类型的对象, 才能取到里面的属性 [phoneNumbers enumerateObjectsUsingBlock:^(CNLabeledValue<CNPhoneNumber*> * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) { NSLog(@"%@--%@", obj.label, obj.value.stringValue); }]; } // 点击了联系人的确切属性的时候调用, 注意, 这两个方法只能实现一个 - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty { NSLog(@"%@---%@", contactProperty.key, contactProperty.value); }
三. 简单使用Contacts
Contacts是没有UI界面的ContactsUI, 他与AddressBook的使用方法大致相同
-
注意点:
- 使用这个框架, 要手动申请授权
- 该框架完全改为了面向对象的OC版本, 而不再使用C函数了
- 核心步骤为:
配置请求Key -> 创建请求对象 -> 使用联系人仓库发送请求
-
大致步骤
-
发送授权申请
// 1. 获取权限 - (void)getAuthor { // 1. 判断当前的授权状态 if ([CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts] == CNAuthorizationStatusNotDetermined) { CNContactStore *store = [[CNContactStore alloc] init]; [store requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) { if (granted) { NSLog(@"授权成功"); } else { NSLog(@"授权失败"); } }]; } } -
获取所有联系人的信息
// 2. 获取所有联系人的信息 - (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event { // 1. 判断授权状态 if ([CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts] != CNAuthorizationStatusAuthorized) { NSLog(@"请授权"); return; } // 2. 获取联系人仓库 CNContactStore *store = [[CNContactStore alloc] init]; // 3. 创建联系人信息的请求对象 NSArray *keys = @[CNContactGivenNameKey, CNContactFamilyNameKey, CNContactPhoneNumbersKey]; // 4. 根据请求Key, 创建请求对象 CNContactFetchRequest *request = [[CNContactFetchRequest alloc] initWithKeysToFetch:keys]; // 5. 发送请求 [store enumerateContactsWithFetchRequest:request error:nil usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) { // 6.1 获取姓名 NSString *givenName = contact.givenName; NSString *familyName = contact.familyName; NSLog(@"%@--%@", givenName, familyName); // 6.2 获取电话 NSArray *phoneArray = contact.phoneNumbers; for (CNLabeledValue *labelValue in phoneArray) { CNPhoneNumber *number = labelValue.value; NSLog(@"%@--%@", number.stringValue, labelValue.label); } }]; }
-
