Address

通讯录

• 从iOS6开始，需要得到用户的授权才能访问通讯录，因此在使用之前，需要检查用户是否已经授权 获得通讯录的授权状态：ABAddressBookGetAuthorizationStatus()

• 授权状态

  • kABAuthorizationStatusNotDetermined --> 用户还没有决定是否授权你的程序进行访问

  • kABAuthorizationStatusRestricted --> iOS设备上一些许可配置阻止程序与通讯录数据库进行交互

  • kABAuthorizationStatusDenied --> 用户明确的拒绝了你的程序对通讯录的访问

  • kABAuthorizationStatusAuthorized --> 用户已经授权给你的程序对通讯录进行访问

AddressBookUI.framework “iOS 9 已过期”

• 提供了联系人列表界面、联系人详情界面、添加联系人界面等

  • 一般用于选择联系人

• 创建联系人界面

    // 1.创建选择联系人的界面
    ABPeoplePickerNavigationController *ppnc = [[ABPeoplePickerNavigationController alloc] init];
  
    // 2.设置代理
    ppnc.peoplePickerDelegate = self;
  
    // 3.弹出选择联系人界面
    [self presentViewController:ppnc animated:YES completion:nil];
  

• 遵守代理协议

  • ABPeoplePickerNavigationControllerDelegate

• 实现代理方法

// 选中某一个联系人的时候,会执行该代理方法
// 如果实现了该方法,那么就不会进入联系人的详细界面
- (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 “iOS 9 已过期”

• 纯C语言的API，仅仅是获得联系人数据
• 没有提供UI界面展示，需要自己搭建联系人展示界面

• 里面的数据类型大部分基于Core Foundation框架，使用起来极其蛋疼

  // 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.获取授权的状态
    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);

RHAddressBook 第三方框架

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

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

    return YES;
}

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

ContactsUI ——> iOS 9 之后使用

• 导入 Contacts/Contacts.h

// 1.创建联系人控制器
    CNContactPickerViewController *contactVc = [[CNContactPickerViewController alloc] init];

    // 2.设置代理
    contactVc.delegate = self;

    // 3.弹出控制器
    [self presentViewController:contactVc animated:YES completion:nil];

• 遵守代理协议，实现代理方法

/** 点击了某个联系人的时候调用 */
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact
{
    // 1.获取联系人的姓名
    NSString *firstname = contact.familyName;
    NSString *middlename = contact.middleName;
    NSString *lastname = contact.givenName;

    NSLog(@"%@ - %@ - %@",firstname,middlename,lastname);

    // 2.获取联系人的电话号码
    NSArray *phoneNumbers = contact.phoneNumbers;
    for (CNLabeledValue *value in phoneNumbers) {

        NSString *label = value.label;

        CNPhoneNumber *number = value.value;
        NSString *phonenumber = number.stringValue;

        NSLog(@"%@ - %@",label,phonenumber);
    }

}

/** 点击了某些联系人的时候调用 */
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContacts:(NSArray<CNContact *> *)contacts
{
}

/** 点击了联系人的属性调用 */
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty
{
}

/**
 * Both single contact and multiple contacts delegate methods are implemented, the single variants will be ignored
 * 实现了选择多个联系人回调的方法，就不会调用单个联系人的方法
 */
/** 点击了联系人的某些属性调用 */
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperties:(NSArray<CNContactProperty *> *)contactProperties
{
}

/** 点击了取消 */
- (void)contactPickerDidCancel:(CNContactPickerViewController *)picker
{
}

contacts iOS 9 开始

• iOS 10需要在info.plist配置NSContactsUsageDescription

<key>NSContactsUsageDescription</key>
<string>请求访问通讯录</string>

• 程序启动时请求授权

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 1.获取授权的状态
     CNAuthorizationStatus status = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];

    // 2.判断授权状态,如果是未决定状态,才需要请求
    if (status == CNAuthorizationStatusNotDetermined)  {
        // 2.1.创建通信录对象
        CNContactStore *store = [[CNContactStore alloc] init];

        [store requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {

            if (granted) {
                NSLog(@"授权成功");
            }else
            {
                NSLog(@"授权失败");
            }

        }];
    }
    return YES;
}

• 获取联系人

// 1.获取授权状态
    CNAuthorizationStatus status = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];

    // 2.判断授权状态
    if (status != CNAuthorizationStatusAuthorized) {
        return;
    }

    // 3.创建通讯录对象
    CNContactStore *contactStore = [[CNContactStore alloc] init];

    // 4.创建获取通讯录的请求对象
    // 4.1 获取需要属性的对应key
    NSArray *phoneKeys = @[CNContactGivenNameKey,CNContactFamilyNameKey,CNContactPhoneNumbersKey];
    // 4.2 创建CNContactFetchRequest对象
    CNContactFetchRequest *request = [[CNContactFetchRequest alloc] initWithKeysToFetch:phoneKeys];

    // 5.遍历所有联系人
    [contactStore enumerateContactsWithFetchRequest:request error:nil usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) {
       // 5.1 获取联系人姓名
        NSString *surName = contact.familyName;
        NSString *name = contact.givenName;
        NSLog(@"%@ %@",surName,name);

       // 5.2 获取联系人电话号码
        NSArray *phoneNumbers = contact.phoneNumbers;
        for (CNLabeledValue *labelValue in phoneNumbers) {
            // 5.2.1 获取电话号码的key
            NSString *label = labelValue.label;

            // 5.2.2 获取电话号码
            CNPhoneNumber *number = labelValue.value;
            NSString *phoneNumber = number.stringValue;

            NSLog(@"%@ %@",label,phoneNumber);
        }
    }];