ios9中访问通讯录的Contacts和ContactsUI框架基本介绍
在以往的ios开发中,开发者需要获取用户的通讯录信息的时候,往往要使用AddressBook.frame框架,该框架是纯C语言的API,在开发过程中,还需要开发者手动的管理内存,这对于新进开发者很难理解和掌握。到了IOS9,苹果推出了具有OC语言的API,即Contacts框架,该框架理解简单、易于使用。联系人信息可以短时间获取、创建和修改,而且还不需要去关系对象的释放。
下面我们介绍一下Contacts框架:
在ios8以后,苹果更加注重用户的隐私,因此需要访问用户通讯录的时候,必须给用户发送授权请求,得到用户的确认后,才能进行下一步的操作。如果用户不同意,用户禁止APP获取其通讯录信息,那么这个决定必须被APP采纳,且绝对不能与用户的通讯录信息交互。不仅如此,用户随时可以在设置中更改对APP的授权,因此在任何操作的时候,都需要检查用户的授权状态。
1 //1 判断是否授权成功
2 if ([CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts] == CNAuthorizationStatusAuthorized) return;//授权成功直接返回
3 //2 创建通讯录
4 CNContactStore *store = [[CNContactStore alloc] init];
5 //3授权
6 [store requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
7 if (granted) {
8 NSLog(@"授权成功");
9 }else{
10 NSLog(@"授权失败");
11 }
12 }];
authorizationStatusForEntityType:methods这个方法是CNContactStore的类方法,需要一个 CNEntityType 参数,返回值是授权得到的状态CNAuthorizationStatus,一共有四种,分别为:
- NotDetermined:表示用户还没有允许或禁止访问通讯录数据库。首次安装的应用软件处于这种状态。
- Restricted:不仅应用软件无法访问通讯录数据,就连用户也无法通过设置修改授权状态。该状态是由于其他限制,也就是家长控制(parental control)所导致。
- Denied:表示用户不允许访问通讯录数据。只有用户才能够修改该状态。
- Authorized:这是每个应用软件期望得到的状态。在该状态下,应用软件可以随意访问通讯录数据库,使用通讯录数据执行操作。
我们其实只需要判断授权状态是否为 CNAuthorizationStatusAuthorized 即可,如果是表示授权状态成功,否则失败,不允许访问通讯录。
CNContactStore (相当于ABAddressBook)类以编程方式展示了联系人数据库,并且提供了许多实现不同任务的方法,例如获取,保存或者更新记录,权限检查和权限请求,很多很多。
CNContact类(相当于ABRecordRef)展示一个单独的联系人记录,但是记住这个类的特性是不可变的。如果你想创建一个新的联系人记录或者更新一个已存在的联系人记录,你必须使用CNMutableContact类。
需要注意的是在于Contacts框架打交道的时候,特别是获取联系人信息时,你应该始终在后台线程中运行这些任务。因为如果一个联系人信息获取任务花去了太多时间而且在主线程运行,那么你的应用有可能无响应,然后最终导致非常糟糕的交互体验。
于此同时在导入联系人信息到APP时,很少用到所有的联系人的属性信息。在所有的Contacts 框架要搜索的数据源中获取所有联系人数据的操作,被证明是一个非常耗资源的进程,所以应该避免检索所以联系人的属性信息,而是只检索需要的一部分属性信息,这个是在Contacts框架提供了的。例如,你可以只是请求名或姓,电话等,这样可以通过排除不需要的那些数据来节约很多资源。
查询联系人代码示例:
1 /** 查看联系人 */
2 - (void)readContact {
3 if ([CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts] != CNAuthorizationStatusAuthorized) return;//授权失败直接返回
4
5 //创建通讯录对象
6 CNContactStore *store = [[CNContactStore alloc] init];
7
8 // 创建获取通信录的请求对象
9 //拿到所有打算获取的属性对应的key(这里仅仅指定需要获取的数据,节约资源)
10 //我们这里仅仅作为示例,所以获取了所有的信息数据
11 NSArray *typeArray = @[CNContactGivenNameKey,CNContactFamilyNameKey,CNContactPhoneNumbersKey,CNContactEmailAddressesKey,CNContactBirthdayKey,CNContactDepartmentNameKey];
12
13 //创建CNContactFetchRequest对象
14 CNContactFetchRequest *request = [[CNContactFetchRequest alloc] initWithKeysToFetch:typeArray];
15
16 //遍历所有的联系人
17 [store enumerateContactsWithFetchRequest:request error:nil usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) {
18
19 //名字
20 NSString *firstName = contact.givenName;
21 //姓氏
22 NSString *lastName = contact.familyName;
23
24 NSLog(@"%@ -- %@", firstName, lastName);
25
26 //获取电话信息
27 NSArray *phones = contact.phoneNumbers;
28 for (int i = 0; i<phones.count; i++) {
29
30 CNLabeledValue *phone = phones[i];
31
32 //获取电话号码的KEY
33 NSString *label = phone.label;
34
35 //获取电话号码
36 CNPhoneNumber *phoneNum = phone.value;
37 NSString *num = phoneNum.stringValue;
38 NSLog(@"name= %@ -- num = %@", label, num);
39 }
40 }];
41
42 }
插入联系人示例:
1 /**
2 * 添加联系人
3 */
4 - (IBAction)addContact {
5
6 //1、联系人对象:CNContact
7
8 //这个对象是用来配置联系人信息的,有可变的CNMutaleContact和CNContact,区别用来读取和创建联系人。CNContact对象中有许多属性,对应联系人的一些信息。
9
10 //首先,创建CNMutableContact对象:
11 CNMutableContact *contact = [[CNMutableContact alloc]init];
12
13 //设置联系人数据
14 [self setupContact:contact];
15
16
17 //2、创建添加联系人请求:CNSaveRequest
18 //CNSaveRequest是用于存储联系人的请求类,通过这个类,我们可以创建批量添加、修改或者删除联系人的请求,例如添加上面我们创建的联系人对象:
19
20 //初始化方法
21 CNSaveRequest * saveRequest = [[CNSaveRequest alloc] init];
22 //添加联系人
23 [saveRequest addContact:contact toContainerWithIdentifier:nil];
24
25 //3 进行联系人的写入操作:CNContactStore
26 //CNContactStore是一个用于存取联系人的上下文桥梁,现在,把我们创建的添加联系人的请求写入:
27 CNContactStore * store = [[CNContactStore alloc]init];
28 [store executeSaveRequest:saveRequest error:nil];
29 }
30
31 /** 设置联系人信息 */
32 - (void)setupContact:(CNMutableContact *)contact{
33 //设置联系人头像:
34 contact.imageData = UIImagePNGRepresentation([UIImage imageNamed:@"tour"]);
35
36 //设置联系人姓名:
37 //设置名字
38 contact.givenName = @"xiao";
39 //设置姓氏
40 contact.familyName = @"zhang";
41
42 //设置联系人邮箱(这里需要注意,emailAddresses属性是一个数组,数组中是才CNLabeledValue对象)
43 CNLabeledValue *homeEmail = [CNLabeledValue labeledValueWithLabel:CNLabelHome value:@"3242523553@qq.com"];
44 CNLabeledValue *workEmail =[CNLabeledValue labeledValueWithLabel:CNLabelWork value:@"324266653@qq.com"];
45 contact.emailAddresses = @[homeEmail,workEmail];
46
47 //设置联系人电话(和邮箱类似)
48 CNLabeledValue *mianPhone = [CNLabeledValue labeledValueWithLabel:CNLabelPhoneNumberMain value:[CNPhoneNumber phoneNumberWithStringValue:@"6363524"]];
49 CNLabeledValue *homePhone = [CNLabeledValue labeledValueWithLabel:CNLabelPhoneNumberHomeFax value:[CNPhoneNumber phoneNumberWithStringValue:@"1536312321"]];
50 contact.phoneNumbers = @[mianPhone, homePhone];
51
52 //设置联系人地址
53 CNMutablePostalAddress * homeAdress = [[CNMutablePostalAddress alloc]init];
54 homeAdress.street = @"大雁塔";
55 homeAdress.city = @"西安";
56 homeAdress.state = @"中国";
57 homeAdress.postalCode = @"xxxxx";
58 contact.postalAddresses = @[[CNLabeledValue labeledValueWithLabel:CNLabelHome value:homeAdress]];
59
60 //设置联系人生日
61 NSDateComponents * birthday = [[NSDateComponents alloc] init];
62 birthday.day=7;
63 birthday.month=9;
64 birthday.year=1998;
65 contact.birthday=birthday;
66 }
ContactsUI.frame框架
1 //打开通讯录
2 - (IBAction)openContact {
3 //初始化ContactPickerViewController
4 CNContactPickerViewController *pickVc = [[CNContactPickerViewController alloc] init];
5 //成为自己的代理
6 pickVc.delegate = self;
7 //跳转控制器
8 [self presentViewController:pickVc animated:YES completion:nil];
9 }
10
11 #pragma mark - CNContactPickerDelegate
12 // 点击cancle按钮时候就会调用
13 - (void)contactPickerDidCancel:(CNContactPickerViewController *)picker{
14 NSLog(@"%s", __func__);
15 [picker dismissViewControllerAnimated:YES completion:nil];
16 }
17
18 // 选中某一个联系人就会调用
19 //注意:只要实现了这个方法, 就不会进行下一步操作(进入详情), iOS9的做法是默认返回NO
20 - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact{
21 NSLog(@"%s", __func__);
22 //姓氏
23 NSString *firstName = contact.familyName;
24 //名字
25 NSString *lastName = contact.givenName;
26 NSLog(@"%@---%@", firstName, lastName);
27 //电话信息
28 NSArray *phones = contact.phoneNumbers;
29 for (CNLabeledValue *phone in phones) {
30 //电话名称
31 NSString *name = phone.label;
32 //电话号码详情
33 CNPhoneNumber *phoneNum = phone.value;
34 NSLog(@"name = %@, phoneNum = %@", name, phoneNum.stringValue);
35 }
36
37 }
38
39 // 选中某一个联系人的某一个属性时就会调用
40 - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty{
41 NSLog(@"%s", __func__);
42 }
不积跬步,无以至千里;不积小流,无以成江海。