IOS提供了直接获取手机联系人信息的API,我们需要导入该包addressbook.framework;此包并没有包含在corefoundation.framework里;
而我们通常使用的是Foundation库,这辆个库的区别就是CoreFoundation库是一个C框架,但是这两个库里的内容是可以简单的进行转换的,
比如:CFString cstr = (CFString)@"NSStringTest";NSDate *date = (NSDate *)cfdate;CoreFoundation里也有类似retain和release的方法,CFRetain和CFRelease。
首先介绍几个类:
1:ABAddressBookRef:ABAddressBookRef像一个管理员,使用过Sqlite的朋友都知道Sqlite3对象的作用,可以说ABAddressBookRef实例的作用和sqlite3的实例的性质一样,都类似一个管理者,来管理这个通讯录,并给你提供一个访问通讯录的通道,并执行保存操作。初始化一个ABAddressBookRef的实例ABAddressBookCreate( )。
2:ABRecordRef:记录。一个属性的集合。类似通讯录中一个个的人,它包含这个人的所有属性,比如First and Last name,图片信息,电话号码,邮箱等等。初始化一个ABRecordRef的方法就是:ABRecordRef person = ABPersonCreate();
我们需要的信息主要包含在下面这2个类种:
1:ABPerson 联系人信息,包含姓名,电话号码,地址信息,照片等
2:ABGroup 联系人分组信息,包含组名,数量等
最后说明:
1:返回值使用CoreFoundation是一样的:可以认为CFString*=NSString,CFArray*=NSArray,ABMultiValueRef*=Dictionary,CFError*=NSError等等,这些都可以互相转换
2:返回联系人属性分为两种:一种是拥有唯一值的属性比如姓名,生日,性别等一般用CFString返回,一种是多值属性比如电话号码,地址等一般用ABMultiValue*等返回。
3:常使用的方法和宏:
ABRecordRef record=CFArrayGetValueAtIndex(CFArr,0);实际上和NSArr类似;
ABMultiValueRef mulitValue=ABRecordCopyValue(record,kABPersonPhoneProperty);获取电话号码,可能回多个;
像上面kABPersonPhoneProperty这种宏有许多,可以用来取名kABPersonFirstNameProperty,取公司kABPersonOrganizationProperty等等。
常用情景:
- ABAddressBookRef address=ABAddressBookCreate();
- CFArrayRef allperson =ABAddressBookCopyArrayOfAllPeople(addressBook);
- NSArray * persons=(NSArray*)ABAddressBookCopyPeopleWithName(address,CFStringRef);
一:添加联系人
- ABAddressBookRef iPhoneAddressBook = ABAddressBookCreate();
- ABRecordRef newPerson = ABPersonCreate();
- CFErrorRef error = NULL;
- ABRecordSetValue(newPerson, kABPersonFirstNameProperty, firsrName, &error);
- ABRecordSetValue(newPerson, kABPersonLastNameProperty, lastName, &error);
- ABRecordSetValue(newPerson, kABPersonOrganizationProperty, organization, &error);
- ABRecordSetValue(newPerson, kABPersonFirstNamePhoneticProperty, firstNamePhonetic, &error);
- ABRecordSetValue(newPerson, kABPersonLastNamePhoneticProperty, lastNamePhonetic, &error);
- ABMutableMultiValueRef multiPhone = ABMultiValueCreateMutable(kABMultiStringPropertyType);
- ABMultiValueAddValueAndLabel(multiPhone, homeFAX, kABPersonPhoneHomeFAXLabel, NULL);
- ABMultiValueAddValueAndLabel(multiPhone, mobile, kABPersonPhoneMobileLabel, NULL);
- ABRecordSetValue(newPerson, kABPersonPhoneProperty, multiPhone, &error);
- CFRelease(multiPhone);
- ABMutableMultiValueRef multiEmail = ABMultiValueCreateMutable(kABMultiStringPropertyType);
- ABMultiValueAddValueAndLabel(multiEmail, email, kABWorkLabel, NULL);
- ABRecordSetValue(newPerson, kABPersonEmailProperty, multiEmail, &error);
- CFRelease(multiEmail);
- NSData *dataRef = UIImagePNGRepresentation(headImage);
- ABPersonSetImageData(newPerson, (CFDataRef)dataRef, &error);
- ABAddressBookAddRecord(iPhoneAddressBook, newPerson, &error);
- ABAddressBookSave(iPhoneAddressBook, &error);
- CFRelease(newPerson);
- CFRelease(iPhoneAddressBook);
二:删除联系人
- CFErrorRef error = NULL;
- ABRecordRef deletedPeople = ABAddressBookGetPersonWithRecordID(addressBook, recordID);
- if (deletedPeople) {
- ABAddressBookRemoveRecord(addressBook, deletedPeople, &error);
- ABAddressBookSave(addressBook, &error);
- }
三:获取分组信息
- CFArrayRef array = ABAddressBookCopyArrayOfAllGroups(address);
- for (id group in (NSArray *)array) {
- NSLog(@"group name = %@", ABRecordCopyValue(group, kABGroupNameProperty));
- NSLog(@"group id = %d", ABRecordGetRecordID(group));
- }
四:删除分组信息
- ABRecordRef deletedGroup = ABAddressBookGetGroupWithRecordID(address, RecordID);
- ABAddressBookRemoveRecord(address, deletedGroup, nil);
- ABAddressBookSave(address, nil);
五:添加分组信息
- ABRecordRef newGroup = ABGroupCreate();
- ABRecordSetValue(newGroup, kABGroupNameProperty, groupName, nil);
- ABAddressBookAddRecord(address, newGroup, nil);
- ABAddressBookSave(address, nil);
六:常用基本属性
- CFArrayRef allperson =ABAddressBookCopyArrayOfAllPeople(addressBook);
- for (id person in (__bridge NSArray *)allperson) {
- ABMultiValueRef cfphone = ABRecordCopyValue((__bridge ABRecordRef)person, kABPersonPhoneProperty);
-
- NSString *personName = (NSString*)ABRecordCopyValue(person, kABPersonFirstNameProperty);
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- NSData *image = (NSData*)ABPersonCopyImageData(person);
- UIImageView *myImage = [[UIImageView alloc] initWithFrame:CGRectMake(200, 0, 50, 50)];
- [myImage setImage:[UIImage imageWithData:image]];
-
-
- ABMultiValueRef email = ABRecordCopyValue(person, kABPersonEmailProperty);
- int emailcount = ABMultiValueGetCount(email);
- for (int i = 0; i < emailcount; i++)
- {
-
- NSString* emailLabel = (NSString*)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(email, i));
-
- NSString* emailContent = (NSString*)ABMultiValueCopyValueAtIndex(email, i);
- }
-
- ABMultiValueRef address = ABRecordCopyValue(person, kABPersonAddressProperty);
- int count = ABMultiValueGetCount(address);
-
- for(int j = 0; j < count; j++)
- {
-
- NSString* addressLabel = (NSString*)ABMultiValueCopyLabelAtIndex(address, j);
-
- NSDictionary* personaddress =(NSDictionary*) ABMultiValueCopyValueAtIndex(address, j);
- NSString* country = [personaddress valueForKey:(NSString *)kABPersonAddressCountryKey];
- NSString* city = [personaddress valueForKey:(NSString *)kABPersonAddressCityKey];
- NSString* state = [personaddress valueForKey:(NSString *)kABPersonAddressStateKey];
- NSString* street = [personaddress valueForKey:(NSString *)kABPersonAddressStreetKey];
- NSString* zip = [personaddress valueForKey:(NSString *)kABPersonAddressZIPKey];
- NSString* coutntrycode = [personaddress valueForKey:(NSString *)kABPersonAddressCountryCodeKey];
- }
-
-
- ABMultiValueRef dates = ABRecordCopyValue(person, kABPersonDateProperty);
- int datescount = ABMultiValueGetCount(dates);
- for (int k = 0; k < datescount; k++)
- {
-
- NSString* datesLabel = (NSString*)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(dates, k));
-
- NSString* datesContent = (NSString*)ABMultiValueCopyValueAtIndex(dates, k);
- }
-
- CFNumberRef recordType = ABRecordCopyValue(person, kABPersonKindProperty);
- if (recordType == kABPersonKindOrganization) {
-
- } else {
-
- }
-
-
-
- ABMultiValueRef instantMessage = ABRecordCopyValue(person, kABPersonInstantMessageProperty);
- for (int l = 1; l < ABMultiValueGetCount(instantMessage); l++)
- {
-
- NSString* instantMessageLabel = (NSString*)ABMultiValueCopyLabelAtIndex(instantMessage, l);
-
- NSDictionary* instantMessageContent =(NSDictionary*) ABMultiValueCopyValueAtIndex(instantMessage, l);
- NSString* username = [instantMessageContent valueForKey:(NSString *)kABPersonInstantMessageUsernameKey];
- NSString* service = [instantMessageContent valueForKey:(NSString *)kABPersonInstantMessageServiceKey];
- }
-
-
- ABMultiValueRef phone = ABRecordCopyValue(person, kABPersonPhoneProperty);
- for (int m = 0; m<ABMultiValueGetCount(phone); m++)
- {
-
- NSString * personPhoneLabel = (NSString*)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(phone, m));
-
- NSString * personPhone = (NSString*)ABMultiValueCopyValueAtIndex(phone, m);
- }
-
-
- ABMultiValueRef url = ABRecordCopyValue(person, kABPersonURLProperty);
- for (int n = 0; n < ABMultiValueGetCount(url); n++)
- {
-
- NSString * urlLabel = (NSString*)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(url, n));
-
- NSString * urlContent = (NSString*)ABMultiValueCopyValueAtIndex(url,n);
- }
- }