IOS开发 手机联系人获取与使用ABAddressBookRef

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);
        //获取firstname
        NSString *personName = (NSString*)ABRecordCopyValue(person, kABPersonFirstNameProperty);
        //获取lastname kABPersonLastNameProperty
        //获取middlename kABPersonMiddleNameProperty
        //获取前缀 kABPersonPrefixProperty
        //获取后缀 kABPersonSuffixProperty
        //获取昵称 kABPersonNicknameProperty
        //获取firstname拼音音标 kABPersonFirstNamePhoneticProperty
        //获取lastname拼音音标  kABPersonLastNamePhoneticProperty
        //获取middlename拼音音标 kABPersonMiddleNamePhoneticProperty
        //获取organization公司 kABPersonOrganizationProperty
        //获取jobtitle工作 kABPersonJobTitleProperty
        //获取department部门 kABPersonDepartmentProperty
        //获取birthday生日 kABPersonBirthdayProperty
        //获取note备忘录 kABPersonNoteProperty
        //第一次添加该条记录的时间 kABPersonCreationDateProperty
        //最后一次修改該条记录的时间  kABPersonModificationDateProperty
        
        
        //获取照片
        NSData *image = (NSData*)ABPersonCopyImageData(person);
        UIImageView *myImage = [[UIImageView alloc] initWithFrame:CGRectMake(200, 0, 50, 50)];
        [myImage setImage:[UIImage imageWithData:image]];
        //==================以下是多值获取=========================
        //获取email多值
        ABMultiValueRef email = ABRecordCopyValue(person, kABPersonEmailProperty);
        int emailcount = ABMultiValueGetCount(email);
        for (int i = 0; i < emailcount; i++)
        {
            //获取email类型 Label
            NSString* emailLabel = (NSString*)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(email, i));
            //获取email值
            NSString* emailContent = (NSString*)ABMultiValueCopyValueAtIndex(email, i);
        }
        //获取地址多值
        ABMultiValueRef address = ABRecordCopyValue(person, kABPersonAddressProperty);
        int count = ABMultiValueGetCount(address);
        
        for(int j = 0; j < count; j++)
        {
            //获取地址类型Label
            NSString* addressLabel = (NSString*)ABMultiValueCopyLabelAtIndex(address, j);
            //获取該label下的地址6属性
            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];
        }
        
        //获取dates多值
        ABMultiValueRef dates = ABRecordCopyValue(person, kABPersonDateProperty);
        int datescount = ABMultiValueGetCount(dates);
        for (int k = 0; k < datescount; k++)
        {
            //获取dates Label
            NSString* datesLabel = (NSString*)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(dates, k));
            //获取dates值
            NSString* datesContent = (NSString*)ABMultiValueCopyValueAtIndex(dates, k);
        }
        //获取kind值
        CFNumberRef recordType = ABRecordCopyValue(person, kABPersonKindProperty);
        if (recordType == kABPersonKindOrganization) {
            // it's a company
        } else {
            // it's a person, resource, or room
        }
        
        
        //获取IM多值
        ABMultiValueRef instantMessage = ABRecordCopyValue(person, kABPersonInstantMessageProperty);
        for (int l = 1; l < ABMultiValueGetCount(instantMessage); l++)
        {
            //获取IM类型 Label
            NSString* instantMessageLabel = (NSString*)ABMultiValueCopyLabelAtIndex(instantMessage, l);
            //获取該label下的2属性
            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++)
        {
            //获取电话Label类型
            NSString * personPhoneLabel = (NSString*)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(phone, m));
            //获取該Label下的电话值
            NSString * personPhone = (NSString*)ABMultiValueCopyValueAtIndex(phone, m);
        }
        
        //获取URL多值
        ABMultiValueRef url = ABRecordCopyValue(person, kABPersonURLProperty);
        for (int n = 0; n < ABMultiValueGetCount(url); n++)
        {
            //获取电话Label
            NSString * urlLabel = (NSString*)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(url, n));
            //获取該Label下的电话值
            NSString * urlContent = (NSString*)ABMultiValueCopyValueAtIndex(url,n);
        }
    }