iOS9.0访问通讯录---ContactsUI和Contacts

一. 简介

1. 在iOS9.0之前, 由于几乎只能通过使用了CoreFoundation的AddressBook框架来获取联系人信息, 为了避免使用这个蛋疼繁琐的框架, 绝大多数的程序员都使用了封装好的三方框架, 由此引起了苹果的重视, 终于在iOS9.0之后, 推出了最新的框架ContactsUI和Contacts专门来获取联系人信息
2. 特点:
   • ContactsUI和Contacts的使用方法与AddressBookUI和AddressBook基本相同
   • 可以把这个新框架理解为面向对象版本的封装
   • 但是只能在iOS9.0以后的版本使用

---

二. 简单使用ContactsUI

1. ContactsUI是有图形界面的联系人获取方法, 他可以创建CNContactPickerViewController来创建UI界面
2. 当使用这个框架的时候, 系统会自动发送授权申请, 不需要手动授权
3. 注意点:

   • 这个框架主要是使用其代理方法来获取数据的

   • 如果实现了点击联系人调用的代理方法的话, 联系人详情界面就不会显示了

   • 遵守的协议为:

       - (void)touchesBegan:(NSSet *)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*> *phoneNumbers = contact.phoneNumbers;
           
           // 注意, 由于这个数组规定了泛型, 所以要使用遍历器来取出每一个特定类型的对象, 才能取到里面的属性
           [phoneNumbers enumerateObjectsUsingBlock:^(CNLabeledValue * _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

1. Contacts是没有UI界面的ContactsUI, 他与AddressBook的使用方法大致相同

2. 注意点:

   • 使用这个框架, 要手动申请授权
   • 该框架完全改为了面向对象的OC版本, 而不再使用C函数了
   • 核心步骤为: 配置请求Key -> 创建请求对象 -> 使用联系人仓库发送请求

3. 大致步骤

   1. 发送授权申请

       // 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. 获取所有联系人的信息

       // 2. 获取所有联系人的信息
       - (void)touchesBegan:(NSSet *)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);
               }
           }];
       }