Contacts 通讯录

1、访问通讯录

• 设置系统访问通讯录权限

1.1 iOS 9.0 及 iOS 9.0 之后获取通讯录的方法

• iOS 9.0 及 iOS 9.0 之后获取通讯录的方法

      // 包含头文件
      #import <Contacts/Contacts.h>
      #import <ContactsUI/ContactsUI.h>
  
      // 获取通讯录信息，自定义方法
      - (void)fetchAddressBookOnIOS9AndLater {
  
          // 创建 CNContactStore 对象
          CNContactStore *contactStore = [[CNContactStore alloc] init];
  
          // 首次访问需用户授权
          if ([CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts] == CNAuthorizationStatusNotDetermined) {
  
              // 首次访问通讯录
  
              [contactStore requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
  
                  if (!error){
  
                      if (granted) {
  
                          // 允许
  
                          NSLog(@"已授权访问通讯录");
                          NSArray *contacts = [self fetchContactWithContactStore:contactStore];   // 访问通讯录
  
                          dispatch_async(dispatch_get_main_queue(), ^{
  
                              // 主线程 更新 UI
                              NSLog(@"contacts:%@", contacts);
  
                          });
  
                      } else {
  
                          // 拒绝
  
                          NSLog(@"拒绝访问通讯录");
                      }
  
                  } else {
                      NSLog(@"发生错误!");
                  }
              }];
  
          } else {
  
              // 非首次访问通讯录
  
              NSArray *contacts = [self fetchContactWithContactStore:contactStore];   // 访问通讯录
              dispatch_async(dispatch_get_main_queue(), ^{
  
                  // 主线程 更新 UI
                  NSLog(@"contacts:%@", contacts);
  
              });
          }
      }
  
      // 访问通讯录，自定义方法
      - (NSMutableArray *)fetchContactWithContactStore:(CNContactStore *)contactStore {
  
          // 判断访问权限
          if ([CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts] == CNAuthorizationStatusAuthorized) {
  
              // 有权限访问
              NSError *error = nil;
  
              // 创建数组，必须遵守 CNKeyDescriptor 协议，放入相应的字符串常量来获取对应的联系人信息
              NSArray <id<CNKeyDescriptor>> *keysToFetch = @[CNContactFamilyNameKey, CNContactGivenNameKey, CNContactPhoneNumbersKey];
  
              // 获取通讯录数组
              NSArray<CNContact*> *arr = [contactStore unifiedContactsMatchingPredicate:nil keysToFetch:keysToFetch error:&error];
  
              if (!error) {
  
                  NSMutableArray *contacts = [NSMutableArray array];
                  for (int i = 0; i < arr.count; i++) {
  
                      CNContact *contact = arr[i];
                      NSString *givenName = contact.givenName;
                      NSString *familyName = contact.familyName;
                      NSString *phoneNumber = ((CNPhoneNumber *)(contact.phoneNumbers.lastObject.value)).stringValue;
  
                      [contacts addObject:@{@"name":[givenName stringByAppendingString:familyName], @"phoneNumber":phoneNumber}];
                  }
                  return contacts;
  
              } else {
                  return nil;
              }
  
          } else {
  
              // 无权限访问
              NSLog(@"无权限访问通讯录");
  
              return nil;
          }
      }

  • 效果

1.2 iOS 9.0 之前获取通讯录的方法

• iOS 9.0 之前获取通讯录的方法

      // 包含头文件
      #import <AddressBook/AddressBook.h>
  
      // 获取通讯录信息，自定义方法
      - (void)fetchAddressBookBeforeIOS9 {
  
          ABAddressBookRef addressBook = ABAddressBookCreate();
  
          // 首次访问需用户授权
          if (ABAddressBookGetAuthorizationStatus() == kABAuthorizationStatusNotDetermined) {
  
              // 首次访问通讯录
  
              ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error) {
  
                  if (!error) {
  
                      if (granted) {
  
                          // 允许
  
                          NSLog(@"已授权访问通讯录");
                          NSArray *contacts = [self fetchContactWithAddressBook:addressBook];
  
                          dispatch_async(dispatch_get_main_queue(), ^{
  
                              // 主线程 更新 UI
                              NSLog(@"contacts:%@", contacts);
  
                          });
  
                      } else {
  
                          // 拒绝
  
                          NSLog(@"拒绝访问通讯录");
                      }
  
                  } else {
                      NSLog(@"发生错误!");
                  }
              });
          } else {
  
              // 非首次访问通讯录
  
              NSArray *contacts = [self fetchContactWithAddressBook:addressBook];
  
              dispatch_async(dispatch_get_main_queue(), ^{
  
                  // 主线程 更新 UI
                  NSLog(@"contacts:%@", contacts);
  
              });
          }
      }
  
      // 访问通讯录，自定义方法
      - (NSMutableArray *)fetchContactWithAddressBook:(ABAddressBookRef)addressBook {
  
          if (ABAddressBookGetAuthorizationStatus() == kABAuthorizationStatusAuthorized) {
  
              // 有权限访问
  
              // 获取联系人数组
              NSArray *array = (__bridge NSArray *)ABAddressBookCopyArrayOfAllPeople(addressBook);
  
              NSMutableArray *contacts = [NSMutableArray array];
              for (int i = 0; i < array.count; i++) {
  
                  //获取联系人
                  ABRecordRef people = CFArrayGetValueAtIndex((__bridge ABRecordRef)array, i);
  
                  // 获取联系人详细信息,如:姓名,电话,住址等信息
                  NSString *firstName = (__bridge NSString *)ABRecordCopyValue(people, kABPersonFirstNameProperty);
                  NSString *lastName = (__bridge NSString *)ABRecordCopyValue(people, kABPersonLastNameProperty);
                  ABMutableMultiValueRef *phoneNumRef = ABRecordCopyValue(people, kABPersonPhoneProperty);
                  NSString *phoneNumber =  ((__bridge NSArray *)ABMultiValueCopyArrayOfAllValues(phoneNumRef)).lastObject;
  
                  [contacts addObject:@{@"name": [firstName stringByAppendingString:lastName], @"phoneNumber": phoneNumber}];
              }
              return contacts;
  
          } else {
  
              // 无权限访问
  
              NSLog(@"无权限访问通讯录");
  
              return nil;
          }
      }

  • 效果

2、对通讯录的操作

• 对通讯录的操作

      // 包含头文件
      #import <Contacts/Contacts.h>
      #import <ContactsUI/ContactsUI.h>
  
      // 遵守协议
      <CNContactPickerDelegate>
  
      @property (nonatomic, strong) NSArray *contacts;
      @property (nonatomic, strong) NSArray *groups;

2.1 打开通讯录

• 打开通讯录

      // 初始化 CNContactPickerViewController
      CNContactPickerViewController *contactPickerVC = [[CNContactPickerViewController alloc] init];
  
      // 设置代理，需遵守 CNContactPickerDelegate 协议
      contactPickerVC.delegate = self;
  
      // 显示联系人窗口视图
      [self presentViewController:contactPickerVC animated:YES completion:nil];
  
      // 取消，CNContactPickerDelegate 协议方法
      - (void)contactPickerDidCancel:(CNContactPickerViewController *)picker {
  
          // 点击联系人控制器的 Cancel 按钮执行该方法，picker 联系人控制器
  
          NSLog(@"取消");
      }
  
      // 选中联系人，CNContactPickerDelegate 协议方法
      - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact {
  
          // 选中联系人时执行该方法，picker 联系人控制器，contact 联系人
  
          NSLog(@"联系人的资料:%@", contact);
          [self dismissViewControllerAnimated:YES completion:nil];
  
          // 显示联系人详细页面
          CNContactViewController *contactVC = [CNContactViewController viewControllerForContact:contact];
  
          contactVC.displayedPropertyKeys = @[CNContactGivenNameKey, CNContactPhoneNumbersKey, CNContactFamilyNameKey,
                                              CNContactInstantMessageAddressesKey, CNContactEmailAddressesKey,
                                              CNContactDatesKey, CNContactUrlAddressesKey, CNContactBirthdayKey,
                                              CNContactImageDataKey];
  
          [self presentViewController:contactVC animated:YES completion:nil];
      }

2.2 联系人操作

• 1、增加联系人

      // 增加的联系人信息
      CNMutableContact *contact = [self initializeContact];
  
      // 创建请求
      CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
  
      // 添加联系人
      [saveRequest addContact:contact toContainerWithIdentifier:nil];
  
      // 同步到通讯录
      CNContactStore *store = [[CNContactStore alloc] init];
      [store executeSaveRequest:saveRequest error:NULL];
  
      // 初始化联系人信息
      - (CNMutableContact *)initializeContact {
  
          // 创建联系人对象
          CNMutableContact *contact = [[CNMutableContact alloc] init];
  
          // 设置联系人的头像
          contact.imageData = UIImagePNGRepresentation([UIImage imageNamed:@"demo5"]);
  
          // 设置联系人姓名
          contact.givenName = @"Qian";
  
          // 设置姓氏
          contact.familyName = @"Chia";
  
          // 设置联系人邮箱
          CNLabeledValue *homeEmail = [CNLabeledValue labeledValueWithLabel:CNLabelHome value:@"qianchia@icloud.com"];
          CNLabeledValue *workEmail = [CNLabeledValue labeledValueWithLabel:CNLabelWork value:@"qianchia@icloud.com"];
          CNLabeledValue *otherEmail = [CNLabeledValue labeledValueWithLabel:CNLabelOther value:@"qianchia@icloud.com"];
          contact.emailAddresses = @[homeEmail,workEmail,otherEmail];
  
          // 设置机构名
          contact.organizationName = @"互联网";
  
          // 设置部门
          contact.departmentName = @"Development";
  
          // 设置工作的名称
          contact.jobTitle = @"iOS";
  
          // 设置社会的简述
          CNSocialProfile *profile = [[CNSocialProfile alloc] initWithUrlString:@"12306.cn" username:@"lily" userIdentifier:nil service:@"IT行业"];
          CNLabeledValue *socialProfile = [CNLabeledValue labeledValueWithLabel:CNSocialProfileServiceGameCenter value:profile];
          contact.socialProfiles = @[socialProfile];
  
          // 设置电话号码
          CNPhoneNumber *mobileNumber = [[CNPhoneNumber alloc] initWithStringValue:@"15188888888"];
          CNLabeledValue *mobilePhone = [[CNLabeledValue alloc] initWithLabel:CNLabelPhoneNumberMobile value:mobileNumber];
          contact.phoneNumbers = @[mobilePhone];
  
          // 设置与联系人的关系
          CNContactRelation *friend = [[CNContactRelation alloc] initWithName:@"好朋友"];
          CNLabeledValue *relation = [CNLabeledValue labeledValueWithLabel:CNLabelContactRelationFriend value:friend];
          contact.contactRelations = @[relation];
  
          // 设置生日
          NSDateComponents *birthday = [[NSDateComponents alloc] init];
          birthday.day = 6;
          birthday.month = 5;
          birthday.year = 2000;
          contact.birthday = birthday;
  
          return contact;
      }

• 2、删除联系人

      // 要删除的联系人
      CNMutableContact *contact = [self.contacts[0] mutableCopy];
  
      // 创建请求
      CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
  
      // 删除联系人
      [saveRequest deleteContact:contact];
  
      // 同步到通讯录
      CNContactStore *store = [[CNContactStore alloc] init];
      [store executeSaveRequest:saveRequest error:NULL];

• 3、修改联系人

      // 要修改的联系人信息
      CNMutableContact *contact = [self.contacts[0] mutableCopy];
      contact.givenName = @"Qianqian";
  
      // 创建请求
      CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
  
      // 修改联系人
      [saveRequest updateContact:contact];
  
      // 同步到通讯录
      CNContactStore *store = [[CNContactStore alloc] init];
      [store executeSaveRequest:saveRequest error:NULL];

• 4、查询联系人

      // 要查询的联系人 GivenName
      NSString *checkName = @"Qian";
  
      // 检索条件
      NSPredicate *predicate = [CNContact predicateForContactsMatchingName:checkName];
  
      // 提取数据 （keysToFetch:@[CNContactGivenNameKey] 是设置提取联系人的哪些数据）
      CNContactStore *store = [[CNContactStore alloc] init];
      NSArray *contactArray = [store unifiedContactsMatchingPredicate:predicate keysToFetch:@[CNContactGivenNameKey] error:NULL];
  
      self.contacts = contactArray;

2.3 联系人群组操作

• 1、增加群组

      // 要增加的群组
      CNMutableGroup *group = [[CNMutableGroup alloc] init];
      group.name = @"QianFriend";
  
      // 创建请求
      CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
  
      // 增加群组
      [saveRequest addGroup:group toContainerWithIdentifier:nil];
  
      // 同步到通讯录
      CNContactStore *store = [[CNContactStore alloc] init];
      [store executeSaveRequest:saveRequest error:NULL];

• 2、删除群组

      // 要删除的群组
      CNMutableGroup *group = self.groups[0];
  
      // 创建请求
      CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
  
      // 删除群组
      [saveRequest deleteGroup:group];
  
      // 同步到通讯录
      CNContactStore *store = [[CNContactStore alloc] init];
      [store executeSaveRequest:saveRequest error:NULL];

• 3、修改群组

      // 要修改的群组
      CNMutableGroup *group = self.groups[0];
      group.name = @"QianWork";
  
      // 创建请求
      CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
  
      // 修改群组
      [saveRequest updateGroup:group];
  
      // 同步到通讯录
      CNContactStore *store = [[CNContactStore alloc] init];
      [store executeSaveRequest:saveRequest error:NULL];

• 4、查询群组

      CNContactStore *store = [[CNContactStore alloc] init];
  
      // 查询所有的 group(predicate 参数为空时会查询所有的 group)
      NSArray *groupArray = [store groupsMatchingPredicate:nil error:NULL];
  
      self.groups = groupArray;

• 5、向群组中添加联系人

      // 要添加的联系人和群组
      CNContact *contact = self.contacts[0];
      CNMutableGroup *group = self.groups[0];
  
      // 创建请求
      CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
  
      // 向群组中添加联系人
      [saveRequest addMember:contact toGroup:group];
  
      // 同步到通讯录
      CNContactStore *store = [[CNContactStore alloc] init];
      [store executeSaveRequest:saveRequest error:NULL];

• 6、从群组中删除联系人

      // 要删除的联系人和群组
      CNContact *contact = self.contacts[0];
      CNMutableGroup *group = self.groups[0];
  
      // 创建请求
      CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
  
      // 从群组中删除联系人
      [saveRequest removeMember:contact fromGroup:group];
  
      // 同步到通讯录
      CNContactStore *store = [[CNContactStore alloc] init];
      [store executeSaveRequest:saveRequest error:NULL];