iOS 9 ContactsFramework
苹果官方文档,用的是Swift https://developer.apple.com/library/ios/documentation/Contacts/Reference/Contacts_Framework/index.html#//apple_ref/doc/uid/TP40015328
这里记录一下自己的使用情况,仅作记录,还有很多不清楚的地方。
CNContactStore 我的理解是存储了所有联系人的一个类,有向用户发送授权请求的对象方法
requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error)
请求授权成功granted = 1,否则返回error。
获取所有联系人:
1. 对象store调用 enumerateContactsWithFetchRequest: request error:&error usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) 可以获得所有联系人(这里有问题,详见下面),这里的request 是 CNContactFetchRequest 的对象,可以通过 initWithKeysToFetch 对象方法来创建,后面的数组是你所需要的key,可以在CNContact类的最下面找到。特别的,对于姓名,你可以用一长串的 key:CNContactNamePrefixKey,CNContactNameSuffixKey,CNContactMiddleNameKey,CNContactFamilyNameKey 等等,也可以通过CNContactFormatter调用它的对象方法 descriptorForRequiredKeysForStyle:CNContactFormatterStyleFullName获得全名,把返 回的结果作为一个key放在initWithKeysToFetch后面的数组里
。
2. block里返回的CNContact基本已经是我们所需要的联系人,里面的familyName,GivenName就不多说,关键是 phoneNumbers这个属性,是一个数组,里面的元素是CNLabeledValue类型的对象,坑爹的来了,这个类有一个ValueType的属 性,通过class方法才获知其实是CNPhoneNumber类型,通过stringValue可以获得我们需要的电话号码字符串(后来又看了一下官方 文档,这里的valueType,可以是字符串,可以是CNMutablePostalAddress,也可以是CNPhoneNumber)。而 CNLabeledValue的label属性可以是联系人电话号码的类型 CNLabelPhoneNumberMobile,CNLabelPhoneNumberiPhone等,也可以是邮箱地址类型CNLabelHome 等等
注意:我一开始把最下面的获得所有联系人的方法写在了授权方法里,结果出现了线程阻塞的问题,后来我把授权方法删掉(即不再授权,模拟器上测试的app删掉重新跑),也能读到联系人,不知道这里到底应该怎么做,希望有了解的大神指导。
[store requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
NSLog(@"%d",granted);
}];
下面贴一下自己测试的代码,仅仅是获取联系人的姓名和电话
====================================下面是实际的代码=======================================
CNContactStore *store = [[CNContactStore alloc]init];
NSError *error = nil;
CNContactFetchRequest *request = [[CNContactFetchRequest alloc]initWithKeysToFetch:@[CNContactGivenNameKey,CNContactFamilyNameKey,CNContactPhoneNumbersKey]];
NSMutableArray *dataSource = [NSMutableArray array];
[store enumerateContactsWithFetchRequest:request error:&error usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) {
NSString *name = [NSString stringWithFormat:@"%@ %@",contact.givenName,contact.familyName];//名字
NSString *phone = [NSString string];
for (CNLabeledValue *value in contact.phoneNumbers) {
if ([value.label isEqualToString:@"_$!<Mobile>!$_"]) {
CNPhoneNumber *phoneNum = value.value;
phone = phoneNum.stringValue; //电话
}
}
}];
添加,删除,修改联系人等等待补充。