IOS 之通讯录

墨蓝 2022-09-19 04:08 368阅读 0赞

在IOS里通讯录存放在底层的SQLite3数据库里,想要访问它必须需要用户授权和使用苹果专门为用户开放的一些API.

这里包含了两个框架: AddressBook 和 AddressBookUI.

1.使用这些框架还得引入AddressBook.framework和AddressBookUI.framework库

2,并且引入所需的头文件 \#import <AddressBook/AddressBook.h>和\#import <AddressBookUI/AddressBookUI.h>

**AddressBook框架包含了一些常用的类**

ABAddressBook 访问通讯录接口Core Foundation框架中对应的是ABAddressBookRef

ABPerson 个人信息 对应 ABPersonRef

ABGroup 一个组包含了多个人的信息,对应 ABGroupRef

ABRecord 数据库中的一条记录对应 ABRecord

**AddressBookUI框架包含了4个视图控制器和4个对应的委托协议他们提供了UI界面**

ABPeoplePickerNavigationController  它是从数据库中联系人的导航控制器

ABPersonViewController 查看并编辑单个联系人信息

ABNewPersonViewController 创建新联系人

ABUnKnownPersonViewController 呈现记录部分信息,这些信息可以创建联系人信息,或添加到已经存在的联系人

以下是一些函数的使用说明 （因为ARC的关系，在使用时必须进行一些必要的转换，转为foundation的时候需要CFBridgingRelease, 转为通讯录函数使用的时候需要CFBridgingRetain, 释放通讯录类型的数据时用CFRelease）

特别需要注意的是必须在通讯录打开的时取出ABRecordRef的多值才有效,所以通常都保存着id用时再打开通讯录取多值!

//返回一个通讯录的接口

ABAddressBookRef ABAddressBookCreateWithOptions (    CFDictionaryRef options,    CFErrorRef\* error );

//向用户申请访问通讯录，第二个参数是block为真允许访问。

void ABAddressBookRequestAccessWithCompletion (    ABAddressBookRef addressBook,    ABAddressBookRequestAccessCompletionHandler completion );

//获取授权状态

ABAuthorizationStatus ABAddressBookGetAuthorizationStatus (void);

//从通讯录返回所有联系人

CFArrayRef ABAddressBookCopyArrayOfAllPeople (    ABAddressBookRef addressBook );

//根据联系人名字查询

CFArrayRef ABAddressBookCopyPeopleWithName (    ABAddressBookRef addressBook,    CFStringRef name );

//根据记录的id查询

ABRecordRef ABAddressBookGetPersonWithRecordID (    ABAddressBookRef addressBook,    ABRecordID recordID );

//根据一条记录，来获取联系人的相关信息,CFTypeRef是个泛型，例如id类型，如果返回一对多的值会是ABMultiValueRef类型,例如电话,emal

CFTypeRef ABRecordCopyValue (    ABRecordRef record,    ABPropertyID property );

//针对一对多的时候来取值

CFArrayRef ABMultiValueCopyArrayOfAllValues (    ABMultiValueRef multiValue );

//针对一对多的时候来取标签名

CFStringRef ABMultiValueCopyLabelAtIndex (    ABMultiValueRef multiValue,    CFIndex index );

//每条记录都有一个id是唯一的，ABRecordID可以转换为Number类型

ABRecordID ABRecordGetRecordID (    ABRecordRef record );

//根据记录取联系人照片，对应 NSData

CFDataRef ABPersonCopyImageData (    ABRecordRef person );

//判断是否有联系人照片

bool ABPersonHasImageData (    ABRecordRef person );

创建删除联系人时用以下六个函数

//返回一条新增的空记录

ABRecordRef ABPersonCreate (    void );

//设置相应的属性值

bool ABRecordSetValue (    ABRecordRef record,    ABPropertyID property,    CFTypeRef value,    CFErrorRef \*error );

//创建一对多的值类型

ABMutableMultiValueRef ABMultiValueCreateMutable (    ABPropertyType type );

//设置一对多的属性和值，outIdentifier是指定id可为null

bool ABMultiValueAddValueAndLabel (    ABMutableMultiValueRef multiValue,    CFTypeRef value,    CFStringRef label,    ABMultiValueIdentifier \*outIdentifier );

//增加新联系人到通讯录里边

bool ABAddressBookAddRecord (    ABAddressBookRef addressBook,    ABRecordRef record,    CFErrorRef \*error );

//保存

bool ABAddressBookSave (    ABAddressBookRef addressBook,    CFErrorRef \*error );

//根据记录删除联系人

bool ABAddressBookRemoveRecord (    ABAddressBookRef addressBook,    ABRecordRef record,    CFErrorRef \*error );

# iOS9.0访问通讯录---ContactsUI和Contacts #

### 一. 简介 ###

1.  在iOS9.0之前, 由于几乎只能通过使用了CoreFoundation的AddressBook框架来获取联系人信息, 为了避免使用这个蛋疼繁琐的框架, 绝大多数的程序员都使用了封装好的三方框架, 由此引起了苹果的重视, 终于在iOS9.0之后, 推出了最新的框架ContactsUI和Contacts专门来获取联系人信息
2.  特点:
    
     *  ContactsUI和Contacts的使用方法与AddressBookUI和AddressBook基本相同
     *  可以把这个新框架理解为面向对象版本的封装
     *  但是只能在iOS9.0以后的版本使用

--------------------

### 二. 简单使用ContactsUI ###

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NhbXJ0aWFu_size_16_color_FFFFFF_t_70][]![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NhbXJ0aWFu_size_16_color_FFFFFF_t_70 1][]

1.  ContactsUI是有图形界面的联系人获取方法, 他可以创建`CNContactPickerViewController`来创建UI界面
2.  当使用这个框架的时候, 系统会自动发送授权申请, 不需要手动授权
3.  注意点:
    
     *  这个框架主要是使用其代理方法来获取数据的
     *  如果实现了点击联系人调用的代理方法的话, 联系人详情界面就不会显示了
     *  遵守的协议为: <CNContactPickerDelegate>
        
            - (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
                  
                  // 1. 创建选择联系人控制器
                  CNContactPickerViewController *pickerVC = [[CNContactPickerViewController alloc] init];
                  
                  // 2. 设置代理
                  pickerVC.delegate = self;
                  
                  // 3. 弹出控制器
                  [self presentViewController:pickerVC animated:YES completion:nil];
              }
              
              #pragma mark - 代理方法
              // 控制器点击取消的时候调用
              - (void)contactPickerDidCancel:(CNContactPickerViewController *)picker {
                  NSLog(@"点击了取消");
              }
              
              // 点击了联系人的时候调用, 如果实现了这个方法, 就无法进入联系人详情界面
              - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact {
                  
                  // contact属性就是联系人的信息
                  NSLog(@"%@---%@", contact.namePrefix, contact.familyName);
                  
                  // 获取联系人的电话号码
                  NSArray<CNLabeledValue<CNPhoneNumber*>*> *phoneNumbers = contact.phoneNumbers;
                  
                  // 注意, 由于这个数组规定了泛型, 所以要使用遍历器来取出每一个特定类型的对象, 才能取到里面的属性
                  [phoneNumbers enumerateObjectsUsingBlock:^(CNLabeledValue<CNPhoneNumber*> * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
                      
                      NSLog(@"%@--%@", obj.label, obj.value.stringValue);
                  }];
              }
              
              // 点击了联系人的详细属性的时候调用, 注意, 上边和这个方法只能实现一个
              - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty {
                  NSLog(@"%@---%@", contactProperty.key, contactProperty.value);
              }

--------------------

### 三. 简单使用Contacts ###

1.  Contacts是没有UI界面的ContactsUI, 他与AddressBook的使用方法大致相同
2.  注意点:
    
     *  使用这个框架, 要手动申请授权
     *  该框架完全改为了面向对象的OC版本, 而不再使用C函数了
     *  核心步骤为: `配置请求Key -> 创建请求对象 -> 使用联系人仓库发送请求`
3.  大致步骤
    
    1.  发送授权申请
        
            // 1. 获取权限
             - (void)getAuthor {
                 
                 // 1. 判断当前的授权状态
                 if ([CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts] == CNAuthorizationStatusNotDetermined) {
                     
                     CNContactStore *store = [[CNContactStore alloc] init];
                     [store requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
                         if (granted) {
                             NSLog(@"授权成功");
                         } else {
                             NSLog(@"授权失败");
                         }
                     }];
                 }
             }
    2.  获取所有联系人的信息
        
            // 2. 获取所有联系人的信息
             - (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
                 
                 // 1. 判断授权状态
                 if ([CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts] != CNAuthorizationStatusAuthorized) {
                     NSLog(@"请授权");
                     return;
                 }
                 
                 // 2. 获取联系人仓库
                 CNContactStore *store = [[CNContactStore alloc] init];
                 
                 // 3. 创建联系人信息的请求对象
                 NSArray *keys = @[CNContactGivenNameKey, CNContactFamilyNameKey, CNContactPhoneNumbersKey];
                 
                 // 4. 根据请求Key, 创建请求对象
                 CNContactFetchRequest *request = [[CNContactFetchRequest alloc] initWithKeysToFetch:keys];
                 
                 // 5. 发送请求
                 [store enumerateContactsWithFetchRequest:request error:nil usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) {
                     
                     // 6.1 获取姓名
                     NSString *givenName = contact.givenName;
                     NSString *familyName = contact.familyName;
                     NSLog(@"%@--%@", givenName, familyName);
                     
                     // 6.2 获取电话
                     NSArray *phoneArray = contact.phoneNumbers;
                     for (CNLabeledValue *labelValue in phoneArray) {
                         
                         CNPhoneNumber *number = labelValue.value;
                         NSLog(@"%@--%@", number.stringValue, labelValue.label);
                     }
                 }];
             }

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NhbXJ0aWFu_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191114174438107.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NhbXJ0aWFu,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NhbXJ0aWFu_size_16_color_FFFFFF_t_70 1]: /images/20220828/434891576e844f8bb375f172c892a8a2.png