iOS - Contacts 通讯录

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:@"[e-mail]"];
  	    CNLabeledValue *workEmail = [CNLabeledValue labeledValueWithLabel:CNLabelWork value:@"[e-mail]"];
  	    CNLabeledValue *otherEmail = [CNLabeledValue labeledValueWithLabel:CNLabelOther value:@"[e-mail]"];
  	    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];