IOS"探望"->通讯录

在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>访问通讯录

• 1.导入框架import <AddressBookUI/AddressBookUI.h>
• 2.创建通讯录界面

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