首页 > 代码库 > iOS:访问地址薄
iOS:访问地址薄
地址簿的访问
- 介绍:
地址簿(Address Book)是一个共享的联系人信息数据库。任何iOS应用程序都可以使用。通过提供常用联系人信息,而不是让每一个应用程序管理独立的联系人列表,可改善用户体验。在拥有共享的地址簿后,无需在不同的应用程序中添加联系人多次,在一个应用程序中更新联系人信息后,其他所有应用程序就立刻能够使用它们。iOS通过两个框架提供了全面的地址簿数据库访问功能,分别是Address Book和Address Book UI。
Address Book UI框架是一组用户界面类,封装了Address Book框架,并向用户提供了使用联系人信息的标准方式。使用该界面可以让用户在地址簿中浏览、搜索和选择联系人,显示并编辑选定联系人的信息,以及创建新的联系人。
- 步骤:
<1>为使用框架Address Book做准备
要想显示地址簿UI和地址簿数据,必须导入框架Address Book和Address Book UI的头文件,并指出将实现协议ABPersonPickerNavigationControllerDelegate。
打开文件ViewController.h,在现有编译指令#import后面添加如下代码行:
#import <AddressBook/AddressBook.h> #import <AddressBookUI/AddressBookUI.h>
接下来,修改代码@interface,在其中添加<ABPersonPickerNavigationControllerDelegate>,功能是指出我们要遵守协议ABPersonPickerNavigationControllerDelegate:
@interface ViewController:UIViewController<ABPersonPickerNavigationControllerDelegate>
<2>显示地址薄联系人选择器
当用户单击"选择一个"按钮时,应用程序需显示联系人选择器这一模态视图,它向用户提供与应用程序“通讯录”类似的界面。在文件ViewController.m的方法newBFF中,分配并初始化一个联系人选择器,将其委托设置为视图控制器(self)然后在显示。这个方法的代码如下:
//打开地址薄 - (IBAction)newBFF:(id)sender{ ABPersonPickerNavigationController *picker; picker = [[ABPersonPickerNavigationController alloc]init]; picker.peoplePickerDelegate = self; [self presentViewController:picker animate:YES]; }
<3>处理取消和挖掘
联系人的界面弹出后,既可以选取联系人就取消,也可以继续深究联系人的信息。这里我就只让用户选择朋友后就取消,而不希望用户继续选择或者编辑联系人属性。因此需要将委托方法peoplePickerNavigationController:peoplePicker:shouldContinueAfterSelectingPerson实现为返回NO,这是这个应用程序的核心方法。还需要让委托方法关闭联系人选择器模态视图,并将控制器交给ViewController。
但是还必须实现联系人选择器委托协议定义如下方法:
1.处理用户取消选择的情形(peoplePickerNavigationControllerDidCancel)
2.处理用户深入挖掘联系人属性的情形(peoplePickerNavigationController:shouldContinueAfterSelectingPerson:property:idnetifier)。
在文件ViewController.m中,实现方法peoplePickerNavigationControllerDidCancel,此方法用于处理用户在联系人选择器中取消选择,具体代码如下所示:
//关闭地址薄 - (void) peoplePickerNavigationControllerDidCancel:(ABPersonPickerNavigationController *)peoplePicker{ [self dissmissViewControllerAnimate:YES]; }
将方法peoplePickerNavigationController:shouldContinueAfterSelectingPerson:property:idnetifier实现返回NO,此方法用于处理用户在联系人选择器中取消选择,具体代码如下所示:
//设置不继续深挖联系人信息 -(BOOL)peoplePickerNavigationController:(ABPersonPickerNavigationController *)peoplePicker shouldContinueAfterSelectingPerson:(ABRecordRef) person property:(ABPropertyID)property idntifier:(ABMultiValueIdntifier)idntifier{ //We won‘t get to this delegate method Return NO; }
<4>选择、访问和显示联系人信息
如果用户没有取消选择,将调用委托方法peoplePickerNavigationController:peoplePicker:shouldCotinueAfterSelectingPerson,并通过一个ABRecordRef将选定联系人传递给该方法。ABRecordRef是在AddressBook框架中定义的。这里,将分别读取联系人的名字、照片、电子邮件、邮政编码这四项信息,在读取照片前需要检查联系人是否有照片。在此需要注意,返回的联系人名字和照片并非Cocoa对象(即NSString和UIImage),而是Core Foundation中的C语言数据,因此需要使用AddressBook框架中的函数ABRecordCopyValue和UIImage的方法ImageWithData进行转换。
对于电子邮件地址和邮政编码,必须处理可能返回的多个值的请情形。就这些数据而言,也将使用ABRecordCopyValue获取指向数据集的引用,再使用函数ABMultiValueGetCount来核实联系人至少有一个电子邮件地址(或邮政编码),然后使用ABMultiValueAtIndex复制第一个电子邮件地址或者邮政编码。
在文件ViewController.m中添加一个委托方法peoplePickerNavigationController:shouldContinueAfterSelectingPerson,此方法能够在用户选择联系人时做出响应,具体代码如下:
- (BOOL)peoplePickerNavigationController:(ABPeoplePickerNaivgationController *)peoplePicker shouldContinueAfterSelectingPerson:(ABRecordRef)person{ //Retrieve the friend‘s name from the address book person record NSString *friendName; NSString *friendEmail; NSString *friendZip; //获取联系人的姓名 friendName = (__bridge NSString *)ABRecordCopyValue(person,kABPersonFristNameProperty); NSLog("联系人的姓名:%@",friendName); //获取联系人邮政编码 ABMultiValueRef friendAddressSet; NSDictionary *friendFirstAddress; friendAddressSet = ABRecordCopyValue(person,kABPersonAddressProperty); if(ABMultiValueGetCount(friendAddressSet)>0){ friendFirstAddress = (__bridge NSDictionary *)ABRecordCopyValueAtIndex(friendAddressSet,0); friendZip = [friendFirstAddress objectForKey:"ZIP"]; NSLog("联系人邮政编码:%@",friendZip); } //获取联系人邮件地址 ABMultiValueRef friendEmailAddress; friendEmailAddress = ABRecordCopyValue(person,kABPersonEmailProperty); if(ABMultiValueGetCount(friendEmailAddress)>0){ friendEmail = (__bridge NSString *)ABRecordCopyValueAtIndex(friendEmailAddress,0); NSLog("联系人邮件地址:%@",friendEmail); } //获取联系人的图像 if(ABPersonHasImageData(person)){ UIImage *personImage = [UIImage imageWithData:(__bridge NSData *)ABPersonCopyImageData(person)]; NSLog("联系人的图像:%@",personImage); } //关闭地址薄 [self dissmissViewControllerAnimate:YES]; return NO; }
iOS:访问地址薄