在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
一. 简介
- 在iOS9.0之前, 由于几乎只能通过使用了CoreFoundation的AddressBook框架来获取联系人信息, 为了避免使用这个蛋疼繁琐的框架, 绝大多数的程序员都使用了封装好的三方框架, 由此引起了苹果的重视, 终于在iOS9.0之后, 推出了最新的框架ContactsUI和Contacts专门来获取联系人信息
- 特点:
- ContactsUI和Contacts的使用方法与AddressBookUI和AddressBook基本相同
- 可以把这个新框架理解为面向对象版本的封装
- 但是只能在iOS9.0以后的版本使用
二. 简单使用ContactsUI
- ContactsUI是有图形界面的联系人获取方法, 他可以创建
CNContactPickerViewController
- 当使用这个框架的时候, 系统会自动发送授权申请, 不需要手动授权
- 注意点:
- 这个框架主要是使用其代理方法来获取数据的
- 如果实现了点击联系人调用的代理方法的话, 联系人详情界面就不会显示了
- 遵守的协议为: <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
- Contacts是没有UI界面的ContactsUI, 他与AddressBook的使用方法大致相同
- 注意点:
- 使用这个框架, 要手动申请授权
- 该框架完全改为了面向对象的OC版本, 而不再使用C函数了
- 核心步骤为:
配置请求Key -> 创建请求对象 -> 使用联系人仓库发送请求
- 大致步骤
- 发送授权申请
// 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. 获取所有联系人的信息 - (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); } }]; }
- 发送授权申请