获取系统通讯录

AddressBookUI.framework

提供了联系人列表界面, 联系人详情界面, 添加联系人界面等。一般用于选择联系人

// 1.创建选择联系人的界面
ABPeoplePickerNavigationController *ppnc = [[ABPeoplePickerNavigationController alloc] init];

// 2.设置代理
ppnc.peoplePickerDelegate = self;

// 3.弹出选择联系人界面
[self presentViewController:ppnc animated:YES completion:nil];

// 实现代理
@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
{
}

AddressBook.framework

纯C语言的API, 仅仅能获取到联系人数据。没有提供UI界面展示, 需要自己搭建联系人展示界面。里面的数据类型大部分基于Core Foundation框架。从ios6开始, 需要得到用户的授权才能访问通讯录, 因此在使用之前需要检查用户是否已经授权(使用AddressBookUI默认已经授权)

通讯录的授权状态

ABAddressBookGetAuthorizationStatus()

• kABAuthorizationStatusNotDetermined：用户还没有决定是否授权你的应用程序进行访问
• kABAuthorizationStatusRestricted：iOS设备上一些许可配置阻止程序与通讯录数据库进行交互
• kABAuthorizationStatusDenied：用户明确的拒绝了你的程序对通讯录的访问
• kABAuthorizationStatusAuthorized：用户已经授权给你的程序对通讯录进行访问

// 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);
}

申请通讯录访问授权

// 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(@"授权失败");
        }
    });
}