在ios中,有两个框架可以访问用户的通讯录
- AddressBookUI.framework
- 提供了联系人列表界面, 联系人详情界面, 添加联系人界面等
- 一般用于选择联系人
- AddressBook.framework
- 纯C语言的API, 仅仅能获取到联系人数据
- 没有提供UI界面展示, 需要自己搭建联系人展示界面
- 里面的数据类型大部分基于Core Foundation框架
- 从ios6开始, 需要得到用户的授权才能访问通讯录, 因此在使用之前需要检查用户是否已经授权(使用AddressBookUI默认已经授权)
- 获得通讯录的授权状态:ABAddressBookGetAuthorizationStatus()
- kABAuthorizationStatusNotDetermined: 用户还没有决定是否授权你的应用程序进行访问
- kABAuthorizationStatusRestricted: iOS设备上一些许可配置阻止程序与通讯录数据库进行交互
- kABAuthorizationStatusDenied: 用户明确的拒绝了你的程序对通讯录的访问
- kABAuthorizationStatusAuthorized: 用户已经授权给你的程序对通讯录进行访问
- 申请通讯录访问授权(一般在程序启动时的application:didFinishLaunchingWithOptions:代理里面写)
// 1.获取授权的状态
ABAuthorizationStatus status = ABAddressBookGetAuthorizationStatus();
// 2.判断授权状态,如果是未决定状态,才需要请求
if (status == kABAuthorizationStatusNotDetermined) {
// 2.1.创建通信录对象
ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, NULL);
// 2.2.请求授权
ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error) {
if (granted) {
NSLog(@"授权成功");
} else {
NSLog(@"授权失败");
}
});
}
1.使用<AddressBookUI.framework>
访问通讯录
- 导入框架
import <AddressBookUI/AddressBookUI.h>
- 导入框架
- 创建通讯录界面
// 1.创建选择联系人的界面
ABPeoplePickerNavigationController *ppnc = [[ABPeoplePickerNavigationController alloc] init];
// 2.设置代理
ppnc.peoplePickerDelegate = self;
// 3.弹出选择联系人界面
[self presentViewController:ppnc animated:YES completion:nil];
- 3.实现代理方法
// 实现代理
@interface ViewController<ABPeoplePickerNavigationControllerDelegate>
@end
#pragma mark - 实现ABPeoplePickerNavigationController的代理方法
// 选中某一个联系人的时候,会执行该代理方法
// 如果实现了该方法,那么就不会进入联系人的详细界面
- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person
{
/*
__bridge NSString * : 将CoreFoundation框架的对象所有权交给Foundation框架来使用,但是Foundation框架中的对象并不能管理该对象内存
__bridge_transfer NSString * : 将CoreFoundation框架的对象所有权交给Foundation来管理,如果Foundation中对象销毁,那么我们之前的对象(CoreFoundation)会一起销毁
*/
// 1.获取选中联系人的姓名(姓lastname和名firstname)
CFStringRef firstname = ABRecordCopyValue(person, kABPersonFirstNameProperty);
CFStringRef lastname = ABRecordCopyValue(person, kABPersonLastNameProperty);
NSString *firstName = (__bridge_transfer NSString *)(firstname);
NSString *lastName = (__bridge_transfer NSString *)(lastname);
NSLog(@"%@ %@", firstName, lastName);
// 2.获取联系人的电话号码
ABMultiValueRef phones = ABRecordCopyValue(person, kABPersonPhoneProperty);
CFIndex count = ABMultiValueGetCount(phones);
for (CFIndex i = 0; i < count; i++) {
NSString *phoneLabel = (__bridge_transfer NSString *)ABMultiValueCopyLabelAtIndex(phones, i);
NSString *phoneValue = (__bridge_transfer NSString *)ABMultiValueCopyValueAtIndex(phones, i);
NSLog(@"label : %@ value : %@", phoneLabel, phoneValue);
}
// 3.释放不再使用的对象
CFRelease(phones);
}
// 选择某一个联系人的某一个属性时,会执行该方法
// property选中的属性
// identifier : 每一个属性都由一个对应标示
// 如果实现了该方法,那么选中一个联系人的属性时,就会推出控制器.不会进入下一个页面
- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier
{
NSLog(@"选择了某一个联系人的某一个属性");
}
// 点击了取消按钮会执行该方法
- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker
{
}
2.使用<AddressBook.framework>
访问通讯录
- 1.导入框架
import <AddressBook/AddressBook.h>
- 2.访问通讯录
// 1.获取授权的状态
ABAuthorizationStatus status = ABAddressBookGetAuthorizationStatus();
// 2.如果用户已经授权
if (status != kABAuthorizationStatusAuthorized) return;
// 3.创建通信录对象
ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, NULL);
// 4.从通信录对象中,将所有的联系人拷贝出来
CFArrayRef peopleArray = ABAddressBookCopyArrayOfAllPeople(addressBook);
// 5.遍历所有的联系人(每一个联系人都是一条记录)
CFIndex peopleCount = CFArrayGetCount(peopleArray);
for (CFIndex i = 0; i < peopleCount; i++) {
// 6.获取到联系人
ABRecordRef person = CFArrayGetValueAtIndex(peopleArray, i);
// 7.获取姓名
NSString *lastname = (__bridge_transfer NSString *)ABRecordCopyValue(person, kABPersonLastNameProperty);
NSString *firstName = (__bridge_transfer NSString *)ABRecordCopyValue(person, kABPersonFirstNameProperty);
NSLog(@"%@ %@", lastname, firstName);
}
// 8.释放不再使用的对象
CFRelease(peopleArray);
CFRelease(addressBook);
3.使用第三方框架<RHAddressBook/AddressBook.h>访问通讯录
- 1.授权
#import <RHAddressBook/AddressBook.h>
// 1.获取授权状态
RHAuthorizationStatus status = [RHAddressBook authorizationStatus];
// 2.判断授权状态,如果未决定状态,则请求授权
if (status == RHAuthorizationStatusNotDetermined) {
// 3.创建通信录对象
RHAddressBook *addressBook = [[RHAddressBook alloc] init];
// 4.请求授权
[addressBook requestAuthorizationWithCompletion:^(bool granted, NSError *error) {
if (granted) {
NSLog(@"授权成功");
} else {
NSLog(@"授权失败");
}
}];
}
- 2.访问通讯录
// 1.获取授权状态
RHAuthorizationStatus status = [RHAddressBook authorizationStatus];
// 2.判断如果是未授权,则直接返回
if (status != RHAuthorizationStatusAuthorized) return;
// 3.创建通信录
RHAddressBook *addressBook = [[RHAddressBook alloc] init];
// 4.获取所有的联系人
NSArray *peopleArray = addressBook.people;
// 5.遍历所有的联系人
for (RHPerson *person in peopleArray) {
// 6.获取联系人的姓名
NSLog(@"%@ %@", person.firstName, person.lastName);
// 7.获取电话号码
RHMultiValue *phones = person.phoneNumbers;
for (int i = 0; i < phones.count; i++) {
// 8.获取电话号码和对应的Label
NSString *phoneLabel = [phones labelAtIndex:i];
NSString *phoneValue = [phones valueAtIndex:i];
NSLog(@"%@ %@", phoneLabel, phoneValue);
}
}