首页 > 程序开发 > 移动开发 > IOS >

IOS开发教程——通讯录

2017-02-28

IOS开发教程——通讯录。iOS中带有一个Contacts应用程序来管理联系人,但是有些时候我们希望自己的应用能够访问或者修改这些信息,这个时候就要用到AddressBook framework框架。

IOS开发教程——通讯录。iOS中带有一个Contacts应用程序来管理联系人,但是有些时候我们希望自己的应用能够访问或者修改这些信息,这个时候就要用到AddressBook.framework框架。iOS中的通讯录是存储在数据库中的,由于iOS的权限设计,开发人员是不允许直接访问通讯录数据库的,必须依靠AddressBook提供的标准API来实现通讯录操作。通过AddressBook.framework开发者可以从底层去操作AddressBook.framework的所有信息,但是需要注意的是这个框架是基于C语言编写的,无法使用ARC来管理内存,开发者需要自己管理内存。下面大致介绍一下通讯录操作中常用的类型:

ABAddressBookRef:代表通讯录对象,通过该对象开发人员不用过多的关注通讯录的存储方式,可以直接以透明的方式去访问、保存(在使用AddressBook.framework操作联系人时,所有的增加、删除、修改后都必须执行保存操作,类似于Core Data)等。

ABRecordRef:代表一个通用的记录对象,可以是一条联系人信息,也可以是一个群组,可以通过ABRecordGetRecordType()函数获得具体类型。如果作为联系人(事实上也经常使用它作为联系人),那么这个记录记录了一个完整的联系人信息(姓名、性别、电话、邮件等),每条记录都有一个唯一的ID标示这条记录(可以通过ABRecordGetRecordID()函数获得)。

ABPersonRef:代表联系人信息,很少直接使用,实际开发过程中通常会使用类型为“kABPersonType”的ABRecordRef来表示联系人(由此可见ABPersonRef其实是一种类型为“kABPersonType”的ABRecordRef)

ABGroupRef:代表群组,与ABPersonRef类似,很少直接使用ABGroupRef,而是使用类型为“kABGroupType”的ABRecordRef来表示群组,一个群组可以包含多个联系人,一个联系人也同样可以多个群组。

由于通讯录操作的关键是对ABRecordRef的操作,首先看一下常用的操作通讯录记录的方法:

ABPersonCreate():创建一个类型为“kABPersonType”的ABRecordRef。

ABRecordCopyValue():取得指定属性的值。

ABRecordCopyCompositeName():取得联系人(或群组)的复合信息(对于联系人则包括:姓、名、公司等信息,对于群组则返回组名称)。

ABRecordSetValue():设置ABRecordRef的属性值。注意在设置ABRecordRef的值时又分为单值属性和多值属性:单值属性设置只要通过ABRecordSetValue()方法指定属性名和值即可;多值属性则要先通过创建一个ABMutableMultiValueRef类型的变量,然后通过ABMultiValueAddValueAndLabel()方法依次添加属性值,最后通过ABRecordSetValue()方法将ABMutableMultiValueRef类型的变量设置为记录值。

ABRecordRemoveValue():删除指定的属性值。

注意:

由于联系人访问时(读取、设置、删除时)牵扯到大量联系人属性,可以到ABPerson.h中查询或者直接到帮助文档“Personal Information Properties”

通讯录的访问步骤一般如下:

调用ABAddressBookCreateWithOptions()方法创建通讯录对象ABAddressBookRef。

调用ABAddressBookRequestAccessWithCompletion()方法获得用户授权访问通讯录。

调用ABAddressBookCopyArrayOfAllPeople()、ABAddressBookCopyPeopleWithName()方法查询联系人信息。

读取联系人后如果要显示联系人信息则可以调用ABRecord相关方法读取相应的数据;如果要进行修改联系人信息,则可以使用对应的方法修改ABRecord信息,然后调用ABAddressBookSave()方法提交修改;如果要删除联系人,则可以调用ABAddressBookRemoveRecord()方法删除,然后调用ABAddressBookSave()提交修改操作。

也就是说如果要修改或者删除都需要首先查询对应的联系人,然后修改或删除后提交更改。如果用户要增加一个联系人则不用进行查询,直接调用ABPersonCreate()方法创建一个ABRecord然后设置具体的属性,调用ABAddressBookAddRecord方法添加即可。

下面就通过一个示例演示一下如何通过ABAddressBook.framework访问通讯录,这个例子中通过一个UITableViewController模拟一下通讯录的查看、删除、添加操作。

主控制器视图,用于显示联系人,修改删除联系人:

KCContactViewController.h

//

// KCTableViewController.h

// AddressBook

//

// Created by Kenshin Cui on 14/04/05.

// Copyright (c) 2014年 cmjstudio. All rights reserved.

//

#import

/**

* 定义一个协议作为代理

*/

@protocol KCContactDelegate

//新增或修改联系人

-(void)editPersonWithFirstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber;

//取消修改或新增

-(void)cancelEdit;

@end

@interface KCContactTableViewController : UITableViewController

@end

KCContactViewController.m

//

// KCTableViewController.m

// AddressBook

//

// Created by Kenshin Cui on 14/04/05.

// Copyright (c) 2014年 cmjstudio. All rights reserved.

//

#import "KCContactTableViewController.h"

#import

#import "KCAddPersonViewController.h"

@interface KCContactTableViewController ()

@property (assign,nonatomic) ABAddressBookRef addressBook;//通讯录

@property (strong,nonatomic) NSMutableArray *allPerson;//通讯录所有人员

@property (assign,nonatomic) int isModify;//标识是修改还是新增,通过选择cell进行导航则认为是修改,否则视为新增

@property (assign,nonatomic) UITableViewCell *selectedCell;//当前选中的单元格

@end

@implementation KCContactTableViewController

#pragma mark - 控制器视图

- (void)viewDidLoad {

[super viewDidLoad];

//请求访问通讯录并初始化数据

[self requestAddressBook];

}

//由于在整个视图控制器周期内addressBook都驻留在内存中,所有当控制器视图销毁时销毁该对象

-(void)dealloc{

if (self.addressBook!=NULL) {

CFRelease(self.addressBook);

}

}

#pragma mark - UI事件

//点击删除按钮

- (IBAction)trashClick:(UIBarButtonItem *)sender {

self.tableView.editing=!self.tableView.editing;

}

#pragma mark - UITableView数据源方法

- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {

return 1;

}

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {

return self.allPerson.count;

}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {

static NSString *identtityKey=@"myTableViewCellIdentityKey1";

UITableViewCell *cell=[tableView dequeueReusableCellWithIdentifier:identtityKey];

if(cell==nil){

cell=[[UITableViewCell alloc]initWithStyle:UITableViewCellStyleValue1 reuseIdentifier:identtityKey];

}

//取得一条人员记录

ABRecordRef recordRef=(__bridge ABRecordRef)self.allPerson[indexPath.row];

//取得记录中得信息

NSString *firstName=(__bridge NSString *) ABRecordCopyValue(recordRef, kABPersonFirstNameProperty);//注意这里进行了强转,不用自己释放资源

NSString *lastName=(__bridge NSString *)ABRecordCopyValue(recordRef, kABPersonLastNameProperty);

ABMultiValueRef phoneNumbersRef= ABRecordCopyValue(recordRef, kABPersonPhoneProperty);//获取手机号,注意手机号是ABMultiValueRef类,有可能有多条

// NSArray *phoneNumbers=(__bridge NSArray *)ABMultiValueCopyArrayOfAllValues(phoneNumbersRef);//取得CFArraryRef类型的手机记录并转化为NSArrary

long count= ABMultiValueGetCount(phoneNumbersRef);

// for(int i=0;i // NSString *phoneLabel= (__bridge NSString *)(ABMultiValueCopyLabelAtIndex(phoneNumbersRef, i));

// NSString *phoneNumber=(__bridge NSString *)(ABMultiValueCopyValueAtIndex(phoneNumbersRef, i));

// NSLog(@"%@:%@",phoneLabel,phoneNumber);

// }

cell.textLabel.text=[NSString stringWithFormat:@"%@ %@",firstName,lastName];

if (count>0) {

cell.detailTextLabel.text=(__bridge NSString *)(ABMultiValueCopyValueAtIndex(phoneNumbersRef, 0));

}

if(ABPersonHasImageData(recordRef)){//如果有照片数据

NSData *imageData= (__bridge NSData *)(ABPersonCopyImageData(recordRef));

cell.imageView.image=[UIImage imageWithData:imageData];

}else{

cell.imageView.image=[UIImage imageNamed:@"avatar"];//没有图片使用默认头像

}

//使用cell的tag存储记录id

cell.tag=ABRecordGetRecordID(recordRef);

return cell;

}

- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath {

if (editingStyle == UITableViewCellEditingStyleDelete) {

ABRecordRef recordRef=(__bridge ABRecordRef )self.allPerson[indexPath.row];

[self removePersonWithRecord:recordRef];//从通讯录删除

[self.allPerson removeObjectAtIndex:indexPath.row];//从数组移除

[tableView deleteRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationFade];//从列表删除

} else if (editingStyle == UITableViewCellEditingStyleInsert) {

// Create a new instance of the appropriate class, insert it into the array, and add a new row to the table view

}

}

#pragma mark - UITableView代理方法

-(void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{

self.isModify=1;

self.selectedCell=[tableView cellForRowAtIndexPath:indexPath];

[self performSegueWithIdentifier:@"AddPerson" sender:self];

}

#pragma mark - Navigation

- (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {

if([segue.identifier isEqualToString:@"AddPerson"]){

UINavigationController *navigationController=(UINavigationController *)segue.destinationViewController;

//根据导航控制器取得添加/修改人员的控制器视图

KCAddPersonViewController *addPersonController=(KCAddPersonViewController *)navigationController.topViewController;

addPersonController.delegate=self;

//如果是通过选择cell进行的导航操作说明是修改,否则为添加

if (self.isModify) {

UITableViewCell *cell=self.selectedCell;

addPersonController.recordID=(ABRecordID)cell.tag;//设置

NSArray *array=[cell.textLabel.text componentsSeparatedByString:@" "];

if (array.count>0) {

addPersonController.firstNameText=[array firstObject];

}

if (array.count>1) {

addPersonController.lastNameText=[array lastObject];

}

addPersonController.workPhoneText=cell.detailTextLabel.text;

}

}

}

#pragma mark - KCContact代理方法

-(void)editPersonWithFirstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber{

if (self.isModify) {

UITableViewCell *cell=self.selectedCell;

NSIndexPath *indexPath= [self.tableView indexPathForCell:cell];

[self modifyPersonWithRecordID:(ABRecordID)cell.tag firstName:firstName lastName:lastName workNumber:workNumber];

[self.tableView reloadRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationRight];

}else{

[self addPersonWithFirstName:firstName lastName:lastName workNumber:workNumber];//通讯簿中添加信息

[self initAllPerson];//重新初始化数据

[self.tableView reloadData];

}

self.isModify=0;

}

-(void)cancelEdit{

self.isModify=0;

}

#pragma mark - 私有方法

/**

* 请求访问通讯录

*/

-(void)requestAddressBook{

//创建通讯录对象

self.addressBook=ABAddressBookCreateWithOptions(NULL, NULL);

//请求访问用户通讯录,注意无论成功与否block都会调用

ABAddressBookRequestAccessWithCompletion(self.addressBook, ^(bool granted, CFErrorRef error) {

if (!granted) {

NSLog(@"未获得通讯录访问权限!");

}

[self initAllPerson];

});

}

/**

* 取得所有通讯录记录

*/

-(void)initAllPerson{

//取得通讯录访问授权

ABAuthorizationStatus authorization= ABAddressBookGetAuthorizationStatus();

//如果未获得授权

if (authorization!=kABAuthorizationStatusAuthorized) {

NSLog(@"尚未获得通讯录访问授权!");

return ;

}

//取得通讯录中所有人员记录

CFArrayRef allPeople= ABAddressBookCopyArrayOfAllPeople(self.addressBook);

self.allPerson=(__bridge NSMutableArray *)allPeople;

//释放资源

CFRelease(allPeople);

}

/**

* 删除指定的记录

*

* @param recordRef 要删除的记录

*/

-(void)removePersonWithRecord:(ABRecordRef)recordRef{

ABAddressBookRemoveRecord(self.addressBook, recordRef, NULL);//删除

ABAddressBookSave(self.addressBook, NULL);//删除之后提交更改

}

/**

* 根据姓名删除记录

*/

-(void)removePersonWithName:(NSString *)personName{

CFStringRef personNameRef=(__bridge CFStringRef)(personName);

CFArrayRef recordsRef= ABAddressBookCopyPeopleWithName(self.addressBook, personNameRef);//根据人员姓名查找

CFIndex count= CFArrayGetCount(recordsRef);//取得记录数

for (CFIndex i=0; i ABRecordRef recordRef=CFArrayGetValueAtIndex(recordsRef, i);//取得指定的记录

ABAddressBookRemoveRecord(self.addressBook, recordRef, NULL);//删除

}

ABAddressBookSave(self.addressBook, NULL);//删除之后提交更改

CFRelease(recordsRef);

}

/**

* 添加一条记录

*

* @param firstName 名

* @param lastName 姓

* @param iPhoneName iPhone手机号

*/

-(void)addPersonWithFirstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber{

//创建一条记录

ABRecordRef recordRef= ABPersonCreate();

ABRecordSetValue(recordRef, kABPersonFirstNameProperty, (__bridge CFTypeRef)(firstName), NULL);//添加名

ABRecordSetValue(recordRef, kABPersonLastNameProperty, (__bridge CFTypeRef)(lastName), NULL);//添加姓

ABMutableMultiValueRef multiValueRef =ABMultiValueCreateMutable(kABStringPropertyType);//添加设置多值属性

ABMultiValueAddValueAndLabel(multiValueRef, (__bridge CFStringRef)(workNumber), kABWorkLabel, NULL);//添加工作电话

ABRecordSetValue(recordRef, kABPersonPhoneProperty, multiValueRef, NULL);

//添加记录

ABAddressBookAddRecord(self.addressBook, recordRef, NULL);

//保存通讯录,提交更改

ABAddressBookSave(self.addressBook, NULL);

//释放资源

CFRelease(recordRef);

CFRelease(multiValueRef);

}

/**

* 根据RecordID修改联系人信息

*

* @param recordID 记录唯一ID

* @param firstName 姓

* @param lastName 名

* @param homeNumber 工作电话

*/

-(void)modifyPersonWithRecordID:(ABRecordID)recordID firstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber{

ABRecordRef recordRef=ABAddressBookGetPersonWithRecordID(self.addressBook,recordID);

ABRecordSetValue(recordRef, kABPersonFirstNameProperty, (__bridge CFTypeRef)(firstName), NULL);//添加名

ABRecordSetValue(recordRef, kABPersonLastNameProperty, (__bridge CFTypeRef)(lastName), NULL);//添加姓

ABMutableMultiValueRef multiValueRef =ABMultiValueCreateMutable(kABStringPropertyType);

ABMultiValueAddValueAndLabel(multiValueRef, (__bridge CFStringRef)(workNumber), kABWorkLabel, NULL);

ABRecordSetValue(recordRef, kABPersonPhoneProperty, multiValueRef, NULL);

//保存记录,提交更改

ABAddressBookSave(self.addressBook, NULL);

//释放资源

CFRelease(multiValueRef);

}

@end

新增或修改控制器视图,用于显示一个联系人的信息或者新增一个联系人:

KCAddPersonViewController.h

//

// KCAddPersonViewController.h

// AddressBook

//

// kABPersonFirstNameProperty

// Copyright (c) 2014年 cmjstudio. All rights reserved.

//

#import

@protocol KCContactDelegate;

@interface KCAddPersonViewController : UIViewController

@property (assign,nonatomic) int recordID;//通讯录记录id,如果ID不为0则代表修改否则认为是新增

@property (strong,nonatomic) NSString *firstNameText;

@property (strong,nonatomic) NSString *lastNameText;

@property (strong,nonatomic) NSString *workPhoneText;

@property (strong,nonatomic) id delegate;

@end

KCAddPersonViewController.m

//

// KCAddPersonViewController.m

// AddressBook

//

// kABPersonFirstNameProperty

// Copyright (c) 2014年 cmjstudio. All rights reserved.

//

#import "KCAddPersonViewController.h"

#import "KCContactTableViewController.h"

@interface KCAddPersonViewController ()

@property (weak, nonatomic) IBOutlet UITextField *firstName;

@property (weak, nonatomic) IBOutlet UITextField *lastName;

@property (weak, nonatomic) IBOutlet UITextField *workPhone;

@end

@implementation KCAddPersonViewController

- (void)viewDidLoad {

[super viewDidLoad];

[self setupUI];

}

#pragma mark - UI事件

- (IBAction)cancelClick:(UIBarButtonItem *)sender {

[self.delegate cancelEdit];

[self dismissViewControllerAnimated:YES completion:nil];

}

- (IBAction)doneClick:(UIBarButtonItem *)sender {

//调用代理方法

[self.delegate editPersonWithFirstName:self.firstName.text lastName:self.lastName.text workNumber:self.workPhone.text];

[self dismissViewControllerAnimated:YES completion:nil];

}

#pragma mark - 私有方法

-(void)setupUI{

if (self.recordID) {//如果ID不为0则认为是修改,此时需要初始化界面

self.firstName.text=self.firstNameText;

self.lastName.text=self.lastNameText;

self.workPhone.text=self.workPhoneText;

}

}

@end

运行效果:

AddressBook

备注:

1.上文中所指的以Ref结尾的对象事实上是该对象的指针(或引用),在C语言的框架中多数类型会以Ref结尾,这个类型本身就是一个指针,定义时不需要加“*”。

2.通常方法中包含copy、create、new、retain等关键字的方法创建的变量使用之后需要调用对应的release方法释放。例如:使用ABPersonCreate();创建完ABRecordRef变量后使用CFRelease()方法释放。

3.在与很多C语言框架交互时可以都存在Obj-C和C语言类型之间的转化(特别是Obj-C和Core Foundation框架中的一些转化),此时可能会用到桥接,只要在强转之后前面加上”__bridge”即可,经过桥接转化后的类型不需要再去手动维护内存,也就不需要使用对应的release方法释放内存。

4.AddressBook框架中很多类型的创建、属性设置等都是以这个类型名开发头的方法来创建的,事实上如果大家熟悉了其他框架会发现也都是类似的,这是Apple开发中约定俗成的命名规则(特别是C语言框架)。例如:要给ABRecordRef类型的变量设置属性则可以通过ABRecordSetValue()方法完成。

AddressBookUI

使用AddressBook.framework来操作通讯录特点就是可以对通讯录有更加精确的控制,但是缺点就是面对大量C语言API稍嫌麻烦,于是Apple官方提供了另一套框架供开发者使用,那就是AddressBookUI.framework。例如前面查看、新增、修改人员的界面这个框架就提供了现成的控制器视图供开发者使用。下面是这个框架中提供的控制器视图:

ABPersonViewController:用于查看联系人信息(可设置编辑)。需要设置displayedPerson属性来设置要显示或编辑的联系人。

ABNewPersonViewController:用于新增联系人信息。

ABUnknownPersonViewController:用于显示一个未知联系人(尚未保存的联系人)信息。需要设置displayedPerson属性来设置要显示的未知联系人。

以上三个控制器视图均继承于UIViewController,在使用过程中必须使用一个UINavigationController进行包装,否则只能看到视图内容无法进行操作(例如对于ABNewPersonViewController如果不使用UINavigationController进行包装则没有新增和取消按钮),同时注意包装后的控制器视图不需要处理具体新增、修改逻辑(增加和修改的处理逻辑对应的控制器视图内部已经完成),但是必须处理控制器的关闭操作(调用dismissViewControllerAnimated::方法),并且可以通过代理方法获得新增、修改的联系人。下面看一下三个控制器视图的代理方法:

1.ABPersonViewController的displayViewDelegate代理方法:

-(BOOL)personViewController:(ABPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier:此方法会在选择了一个联系人属性后触发,四个参数分别代表:使用的控制器视图、所查看的联系人、所选则的联系人属性、该属性是否是多值属性。

2.ABNewPersonViewController的newPersonViewDelegate代理方法:

-(void)newPersonViewController:(ABNewPersonViewController *)newPersonView didCompleteWithNewPerson:(ABRecordRef)person:点击取消或完成后触发,如果参数中的person为NULL说明点击了取消,否则说明点击了完成。无论是取消还是完成操作,此方法调用时保存操作已经进行完毕,不需要在此方法中自己保存联系人信息。

3.ABUnkownPersonViewcontroller的unkownPersonViewDelegate代理方法:

-(void)unknownPersonViewController:(ABUnknownPersonViewController *)unknownCardViewController didResolveToPerson:(ABRecordRef)person:保存此联系人时调用,调用后将此联系人返回。

-(BOOL)unknownPersonViewController:(ABUnknownPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier:选择一个位置联系人属性之后执行,返回值代表是否执行默认的选择操作(例如如果是手机号,默认操作会拨打此电话)

除了上面三类控制器视图在AddressBookUI中还提供了另外一个控制器视图ABPeoplePickerNavigationController,它与之前介绍的UIImagePickerController、MPMediaPickerController类似,只是他是用来选择一个联系人的。这个控制器视图本身继承于UINavigationController,视图自身的“组”、“取消”按钮操作不需要开发者来完成(例如开发者不用在点击取消是关闭当前控制器视图,它自身已经实现了关闭方法),当然这里主要说一下这个控制器视图的peoplePickerDelegate代理方法:

-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person:选择一个联系人后执行。此代理方法实现后代理方法“-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier”不会再执行。并且一旦实现了这个代理方法用户只能选择到联系人视图,无法查看具体联系人的信息。

-(void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker:用户点击取消后执行。

-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier:选择联系人具体的属性后执行,注意如果要执行此方法则不能实现-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person代理方法,此时如果点击一个具体联系人会导航到联系人详细信息界面,用户点击具体的属性后触发此方法。

下面就看一下上面四个控制器视图的使用方法,在下面的程序中定义了四个按钮,点击不同的按钮调用不同的控制器视图用于演示:

//

// ViewController.m

// AddressBookUI

//

// Created by Kenshin Cui on 14/04/05.

// Copyright (c) 2014年 cmjstudio. All rights reserved.

//

#import "ViewController.h"

#import

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {

[super viewDidLoad];

}

#pragma mark - UI事件

//添加联系人

- (IBAction)addPersonClick:(UIButton *)sender {

ABNewPersonViewController *newPersonController=[[ABNewPersonViewController alloc]init];

//设置代理

newPersonController.newPersonViewDelegate=self;

//注意ABNewPersonViewController必须包装一层UINavigationController才能使用,否则不会出现取消和完成按钮,无法进行保存等操作

UINavigationController *navigationController=[[UINavigationController alloc]initWithRootViewController:newPersonController];

[self presentViewController:navigationController animated:YES completion:nil];

}

//

- (IBAction)unknownPersonClick:(UIButton *)sender {

ABUnknownPersonViewController *unknownPersonController=[[ABUnknownPersonViewController alloc]init];

//设置未知人员

ABRecordRef recordRef=ABPersonCreate();

ABRecordSetValue(recordRef, kABPersonFirstNameProperty, @"Kenshin", NULL);

ABRecordSetValue(recordRef, kABPersonLastNameProperty, @"Cui", NULL);

ABMultiValueRef multiValueRef=ABMultiValueCreateMutable(kABStringPropertyType);

ABMultiValueAddValueAndLabel(multiValueRef, @"18500138888", kABHomeLabel, NULL);

ABRecordSetValue(recordRef, kABPersonPhoneProperty, multiValueRef, NULL);

unknownPersonController.displayedPerson=recordRef;

//设置代理

unknownPersonController.unknownPersonViewDelegate=self;

//设置其他属性

unknownPersonController.allowsActions=YES;//显示标准操作按钮

unknownPersonController.allowsAddingToAddressBook=YES;//是否允许将联系人添加到地址簿

CFRelease(multiValueRef);

CFRelease(recordRef);

//使用导航控制器包装

UINavigationController *navigationController=[[UINavigationController alloc]initWithRootViewController:unknownPersonController];

[self presentViewController:navigationController animated:YES completion:nil];

}

- (IBAction)showPersonClick:(UIButton *)sender {

ABPersonViewController *personController=[[ABPersonViewController alloc]init];

//设置联系人

ABAddressBookRef addressBook=ABAddressBookCreateWithOptions(NULL, NULL);

ABRecordRef recordRef= ABAddressBookGetPersonWithRecordID(addressBook, 1);//取得id为1的联系人记录

personController.displayedPerson=recordRef;

//设置代理

personController.personViewDelegate=self;

//设置其他属性

personController.allowsActions=YES;//是否显示发送信息、共享联系人等按钮

personController.allowsEditing=YES;//允许编辑

// personController.displayedProperties=@[@(kABPersonFirstNameProperty),@(kABPersonLastNameProperty)];//显示的联系人属性信息,默认显示所有信息

//使用导航控制器包装

UINavigationController *navigationController=[[UINavigationController alloc]initWithRootViewController:personController];

[self presentViewController:navigationController animated:YES completion:nil];

}

- (IBAction)selectPersonClick:(UIButton *)sender {

ABPeoplePickerNavigationController *peoplePickerController=[[ABPeoplePickerNavigationController alloc]init];

//设置代理

peoplePickerController.peoplePickerDelegate=self;

[self presentViewController:peoplePickerController animated:YES completion:nil];

}

#pragma mark - ABNewPersonViewController代理方法

//完成新增(点击取消和完成按钮时调用),注意这里不用做实际的通讯录增加工作,此代理方法调用时已经完成新增,当保存成功的时候参数中得person会返回保存的记录,如果点击取消person为NULL

-(void)newPersonViewController:(ABNewPersonViewController *)newPersonView didCompleteWithNewPerson:(ABRecordRef)person{

//如果有联系人信息

if (person) {

NSLog(@"%@ 信息保存成功.",(__bridge NSString *)(ABRecordCopyCompositeName(person)));

}else{

NSLog(@"点击了取消.");

}

//关闭模态视图窗口

[self dismissViewControllerAnimated:YES completion:nil];

}

#pragma mark - ABUnknownPersonViewController代理方法

//保存未知联系人时触发

-(void)unknownPersonViewController:(ABUnknownPersonViewController *)unknownCardViewController didResolveToPerson:(ABRecordRef)person{

if (person) {

NSLog(@"%@ 信息保存成功!",(__bridge NSString *)(ABRecordCopyCompositeName(person)));

}

[self dismissViewControllerAnimated:YES completion:nil];

}

//选择一个人员属性后触发,返回值YES表示触发默认行为操作,否则执行代理中自定义的操作

-(BOOL)unknownPersonViewController:(ABUnknownPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier{

if (person) {

NSLog(@"选择了属性:%i,值:%@.",property,(__bridge NSString *)ABRecordCopyValue(person, property));

}

return NO;

}

#pragma mark - ABPersonViewController代理方法

//选择一个人员属性后触发,返回值YES表示触发默认行为操作,否则执行代理中自定义的操作

-(BOOL)personViewController:(ABPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier{

if (person) {

NSLog(@"选择了属性:%i,值:%@.",property,(__bridge NSString *)ABRecordCopyValue(person, property));

}

return NO;

}

#pragma mark - ABPeoplePickerNavigationController代理方法

//选择一个联系人后,注意这个代理方法实现后属性选择的方法将不会再调用

-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person{

if (person) {

NSLog(@"选择了%@.",(__bridge NSString *)(ABRecordCopyCompositeName(person)));

}

}

//选择属性之后,注意如果上面的代理方法实现后此方法不会被调用

//-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier{

// if (person && property) {

// NSLog(@"选择了属性:%i,值:%@.",property,(__bridge NSString *)ABRecordCopyValue(person, property));

// }

//}

//点击取消按钮

-(void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker{

NSLog(@"取消选择.");

}

@end

运行效果:

ABPersonViewController ABNewPersonViewController

ABUnkownPersonViewController ABPeoplePickerNaviagationController

相关文章
最新文章
热点推荐