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;
        }