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];
