IT虾米网

iOS获取通讯录联系人信息详解

leader 2018年06月24日 手机开发 388 0
IOS关于通讯录的开发有两种,一种是直接调用系统的通讯录界面,根据回调信息处理数据,另一种是直接获取系统的通讯录,完全自定义UI,并且可以通过官方给我们提供的接口进行读写。这篇博客主要讨论第二种方式。

IOS获取系统通讯录联系人信息

一、权限注册

随着apple对用户隐私的越来越重视,IOS系统的权限设置也更加严格,在获取系统通讯录之前,我们必须获得用户的授权。权限申请代码示例如下:

    //这个变量用于记录授权是否成功,即用户是否允许我们访问通讯录 
    int __block tip=0; 
    //声明一个通讯簿的引用 
    ABAddressBookRef addBook =nil; 
    //因为在IOS6.0之后和之前的权限申请方式有所差别,这里做个判断 
    if ([[UIDevice currentDevice].systemVersion floatValue]>=6.0) { 
        //创建通讯簿的引用 
        addBook=ABAddressBookCreateWithOptions(NULL, NULL); 
        //创建一个出事信号量为0的信号 
        dispatch_semaphore_t sema=dispatch_semaphore_create(0); 
        //申请访问权限 
        ABAddressBookRequestAccessWithCompletion(addBook, ^(bool greanted, CFErrorRef error)        { 
            //greanted为YES是表示用户允许,否则为不允许 
            if (!greanted) { 
                tip=1; 
            } 
            //发送一次信号 
            dispatch_semaphore_signal(sema); 
        }); 
        //等待信号触发 
         dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER); 
    }else{ 
        //IOS6之前 
        addBook =ABAddressBookCreate(); 
    } 
    if (tip) { 
    //做一个友好的提示 
        UIAlertView * alart = [[UIAlertView alloc]initWithTitle:@"温馨提示" message:@"请您设置允许APP访问您的通讯录\nSettings>General>Privacy" delegate:self cancelButtonTitle:@"确定" otherButtonTitles:nil, nil]; 
        [alart show]; 
        return; 
    }

几点注意:1、dispatch_semaphore_t三个相关的操作为

                           dispatch_semaphore_create 创建一个信号
                 dispatch_semaphore_signal 发送一个信号
                  dispatch_semaphore_wait               等待信号触发    

                             dispatch_semaphore_create()创建一个信号,后面可以跟一个参数,表示信号量,当信号量正值时,dispatch_semaphore_wait后面的代码会被执行,否则程序将会一直等待在dispatch_semaphore_wait。 dispatch_semaphore_signal的作用是发送一个信号,会使信号量加1,相对的,dispatch_semaphore_wait执行后会使信号量减1.

                  2、因为是否被授权是在ABAddressBookRequestAccessWithCompletion的block回调中获取的,所以我们需要在外面做一个线程等待。

二、获取通讯录联系人详细信息

    //获取所有联系人的数组 
    CFArrayRef allLinkPeople = ABAddressBookCopyArrayOfAllPeople(addBook); 
    //获取联系人总数 
    CFIndex number = ABAddressBookGetPersonCount(addBook); 
    //进行遍历 
    for (NSInteger i=0; i<number; i++) { 
        //获取联系人对象的引用 
        ABRecordRef  people = CFArrayGetValueAtIndex(allLinkPeople, i); 
        //获取当前联系人名字 
        NSString*firstName=(__bridge NSString *)(ABRecordCopyValue(people, kABPersonFirstNameProperty)); 
        //获取当前联系人姓氏 
        NSString*lastName=(__bridge NSString *)(ABRecordCopyValue(people, kABPersonLastNameProperty)); 
        //获取当前联系人中间名 
        NSString*middleName=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonMiddleNameProperty)); 
        //获取当前联系人的名字前缀 
        NSString*prefix=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonPrefixProperty)); 
        //获取当前联系人的名字后缀 
        NSString*suffix=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonSuffixProperty)); 
        //获取当前联系人的昵称 
        NSString*nickName=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonNicknameProperty)); 
        //获取当前联系人的名字拼音 
        NSString*firstNamePhoneic=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonFirstNamePhoneticProperty)); 
        //获取当前联系人的姓氏拼音 
        NSString*lastNamePhoneic=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonLastNamePhoneticProperty)); 
        //获取当前联系人的中间名拼音 
        NSString*middleNamePhoneic=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonMiddleNamePhoneticProperty)); 
        //获取当前联系人的公司 
        NSString*organization=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonOrganizationProperty)); 
        //获取当前联系人的职位 
        NSString*job=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonJobTitleProperty)); 
        //获取当前联系人的部门 
        NSString*department=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonDepartmentProperty)); 
        //获取当前联系人的生日 
        NSString*birthday=(__bridge NSDate*)(ABRecordCopyValue(people, kABPersonBirthdayProperty)); 
        NSMutableArray * emailArr = [[NSMutableArray alloc]init]; 
        //获取当前联系人的邮箱 注意是数组 
        ABMultiValueRef emails= ABRecordCopyValue(people, kABPersonEmailProperty); 
        for (NSInteger j=0; j<ABMultiValueGetCount(emails); j++) { 
            [emailArr addObject:(__bridge NSString *)(ABMultiValueCopyValueAtIndex(emails, j))]; 
        } 
        //获取当前联系人的备注 
       NSString*notes=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonNoteProperty)); 
       //获取当前联系人的电话 数组 
        NSMutableArray * phoneArr = [[NSMutableArray alloc]init]; 
        ABMultiValueRef phones= ABRecordCopyValue(people, kABPersonPhoneProperty); 
        for (NSInteger j=0; j<ABMultiValueGetCount(phones); j++) { 
            [phonerr addObject:(__bridge NSString *)(ABMultiValueCopyValueAtIndex(phones, j))]; 
        } 
        //获取创建当前联系人的时间 注意是NSDate 
        NSDate*creatTime=(__bridge NSDate*)(ABRecordCopyValue(people, kABPersonCreationDateProperty)); 
        //获取最近修改当前联系人的时间 
        NSDate*alterTime=(__bridge NSDate*)(ABRecordCopyValue(people, kABPersonModificationDateProperty)); 
        //获取地址 
        ABMultiValueRef address = ABRecordCopyValue(people, kABPersonAddressProperty); 
        for (int j=0; j<ABMultiValueGetCount(address); j++) { 
            //地址类型 
            NSString * type = (__bridge NSString *)(ABMultiValueCopyLabelAtIndex(address, j)); 
            NSDictionary * temDic = (__bridge NSDictionary *)(ABMultiValueCopyValueAtIndex(address, j)); 
            //地址字符串,可以按需求格式化 
            NSString * adress = [NSString stringWithFormat:@"国家:%@\n省:%@\n市:%@\n街道:%@\n邮编:%@",[temDic valueForKey:(NSString*)kABPersonAddressCountryKey],[temDic valueForKey:(NSString*)kABPersonAddressStateKey],[temDic valueForKey:(NSString*)kABPersonAddressCityKey],[temDic valueForKey:(NSString*)kABPersonAddressStreetKey],[temDic valueForKey:(NSString*)kABPersonAddressZIPKey]]; 
        } 
        //获取当前联系人头像图片 
        NSData*userImage=(__bridge NSData*)(ABPersonCopyImageData(people)); 
        //获取当前联系人纪念日 
        NSMutableArray * dateArr = [[NSMutableArray alloc]init]; 
        ABMultiValueRef dates= ABRecordCopyValue(people, kABPersonDateProperty); 
        for (NSInteger j=0; j<ABMultiValueGetCount(dates); j++) { 
            //获取纪念日日期 
            NSDate * data =(__bridge NSDate*)(ABMultiValueCopyValueAtIndex(dates, j)); 
            //获取纪念日名称 
            NSString * str =(__bridge NSString*)(ABMultiValueCopyLabelAtIndex(dates, j)); 
            NSDictionary * temDic = [NSDictionary dictionaryWithObject:data forKey:str]; 
            [dateArr addObject:temDic]; 
        }

一点扩展:相同的方法,可以获取关联人信息,社交信息,邮箱信息,各种类型的电话信息,字段如下:

 //相关人,组织字段 
const ABPropertyID kABPersonKindProperty;  
const CFNumberRef kABPersonKindPerson; 
const CFNumberRef kABPersonKindOrganization; 
 
// 电话相关字段 
AB_EXTERN const ABPropertyID kABPersonPhoneProperty; 
AB_EXTERN const CFStringRef kABPersonPhoneMobileLabel; 
AB_EXTERN const CFStringRef kABPersonPhoneIPhoneLabel  
AB_EXTERN const CFStringRef kABPersonPhoneMainLabel; 
AB_EXTERN const CFStringRef kABPersonPhoneHomeFAXLabel; 
AB_EXTERN const CFStringRef kABPersonPhoneWorkFAXLabel; 
AB_EXTERN const CFStringRef kABPersonPhoneOtherFAXLabel 
AB_EXTERN const CFStringRef kABPersonPhonePagerLabel; 
 
// 即时聊天信息相关字段 
AB_EXTERN const ABPropertyID kABPersonInstantMessageProperty;     
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceKey;     
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceYahoo; 
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceJabber; 
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceMSN; 
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceICQ; 
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceAIM; 
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceQQ  
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceGoogleTalk; 
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceSkype; 
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceFacebook; 
AB_EXTERN const CFStringRef kABPersonInstantMessageServiceGaduGadu; 
AB_EXTERN const CFStringRef kABPersonInstantMessageUsernameKey;  
 
// 个人网页相关字段 
AB_EXTERN const ABPropertyID kABPersonURLProperty; 
AB_EXTERN const CFStringRef kABPersonHomePageLabel;  
//相关人姓名字段 
AB_EXTERN const ABPropertyID kABPersonRelatedNamesProperty;    
AB_EXTERN const CFStringRef kABPersonFatherLabel;    // Father 
AB_EXTERN const CFStringRef kABPersonMotherLabel;    // Mother 
AB_EXTERN const CFStringRef kABPersonParentLabel;    // Parent 
AB_EXTERN const CFStringRef kABPersonBrotherLabel;   // Brother 
AB_EXTERN const CFStringRef kABPersonSisterLabel;    // Sister 
AB_EXTERN const CFStringRef kABPersonChildLabel;      // Child 
AB_EXTERN const CFStringRef kABPersonFriendLabel;    // Friend 
AB_EXTERN const CFStringRef kABPersonSpouseLabel;    // Spouse 
AB_EXTERN const CFStringRef kABPersonPartnerLabel;   // Partner 
AB_EXTERN const CFStringRef kABPersonAssistantLabel; // Assistant 
AB_EXTERN const CFStringRef kABPersonManagerLabel;   // Manager

三、通讯录“写”的相关操作

看到上面读取信息的代码,你可能觉得一阵目炫,其实只是字段比较长,逻辑还是很简单的,同样,写的操作与之类似,创建,修改,删除,是我们对通讯录“写”的常用操作。

1、创建一个联系人

    //创建一个联系人引用 
    ABRecordRef person = ABPersonCreate(); 
    NSString *firstName = @"哈"; 
    NSString *lastName = @"哈"; 
    // 电话号码数组 
    NSArray *phones = [NSArray arrayWithObjects:@"123",@"456",nil]; 
    // 电话号码对应的名称 
    NSArray *labels = [NSArray arrayWithObjects:@"iphone",@"home",nil]; 
    //这里的字段和上面的字段完全相同 
    // 设置名字属性 
    ABRecordSetValue(person, kABPersonFirstNameProperty,(__bridge CFStringRef)firstName, NULL); 
    // 设置姓氏属性 
    ABRecordSetValue(person, kABPersonLastNameProperty, (__bridge CFStringRef)lastName, NULL); 
    // 设置生日属性 
    ABRecordSetValue(person, kABPersonBirthdayProperty,(__bridge CFDateRef)birthday, NULL); 
    // 字典引用 
    ABMultiValueRef dic =ABMultiValueCreateMutable(kABMultiStringPropertyType); 
    // 添加电话号码与其对应的名称内容 
    for (int i = 0; i < [phones count]; i ++) { 
        ABMultiValueIdentifier obj = ABMultiValueAddValueAndLabel(dic,(__bridge CFStringRef)[phones objectAtIndex:i], (__bridge CFStringRef)[labels objectAtIndex:i], &obj); 
    } 
    // 设置phone属性 
    ABRecordSetValue(person, kABPersonPhoneProperty, dic, NULL); 
    // 将新建的联系人添加到通讯录中 
    ABAddressBookAddRecord(addBook, person, NULL); 
    // 保存通讯录数据 
    ABAddressBookSave(addBook, NULL);

2、修改联系人

修改联系人的操作就是将获取和添加和在一起,先获取到相应的联系人引用,重设其属性字段即可。

3.删除联系人

     //获取所有联系人 
     NSArray *array = (__bridge NSArray*)ABAddressBookCopyArrayOfAllPeople(addBook); 
    // 遍历所有的联系人 
    for (id obj in array) { 
        ABRecordRef people = (__bridge ABRecordRef)obj; 
        NSString *firstName = (__bridge NSString*)ABRecordCopyValue(people, kABPersonFirstNameProperty); 
        NSString *lastName = (__bridge NSString*)ABRecordCopyValue(people, kABPersonLastNameProperty); 
        if ([firstName isEqualToString:@"哈"] &&[lastName isEqualToString:@"哈"]) { 
            ABAddressBookRemoveRecord(addBook, people,NULL); 
        } 
    } 
    // 保存修改的通讯录对象 
    ABAddressBookSave(addBook, NULL);

四、重中之重-关于内存管理

上面的代码为了演示方便,创建的全部引用都没有释放,势必是造成内存泄露,在我们用ABAddressBookCreate()创建一个引用对象时,切记无论ARC还MRC,要用CFRelease()进行释放引用,例如上面的例子,我们需要加上这句代码

CFRelease(addBook);

如果你耐心的看到了这里,我想你一定明白了我为什么不在前边的代码里说明这个问题,因为在ARC项目普及的现在,这的确是重中之重。

发布评论

分享到:

IT虾米网

微信公众号号:IT虾米 (左侧二维码扫一扫)欢迎添加!

iOS监听电话铃声响起,挂断的方法详解
你是第一个吃螃蟹的人
发表评论

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。