1176549-b5aa0acd402b2a56.png.jpeg
在ios中,有兩個框架可以訪問用戶的通訊錄
- AddressBookUI.framework
- 提供了聯(lián)系人列表界面, 聯(lián)系人詳情界面, 添加聯(lián)系人界面等
- 一般用于選擇聯(lián)系人
- AddressBook.framework
- 純C語言的API, 僅僅能獲取到聯(lián)系人數(shù)據(jù)
- 沒有提供UI界面展示, 需要自己搭建聯(lián)系人展示界面
- 里面的數(shù)據(jù)類型大部分基于Core Foundation框架
- 從ios6開始, 需要得到用戶的授權(quán)才能訪問通訊錄, 因此在使用之前需要檢查用戶是否已經(jīng)授權(quán)(使用AddressBookUI默認(rèn)已經(jīng)授權(quán))
- 獲得通訊錄的授權(quán)狀態(tài):ABAddressBookGetAuthorizationStatus()
- kABAuthorizationStatusNotDetermined: 用戶還沒有決定是否授權(quán)你的應(yīng)用程序進行訪問
- kABAuthorizationStatusRestricted: iOS設(shè)備上一些許可配置阻止程序與通訊錄數(shù)據(jù)庫進行交互
- kABAuthorizationStatusDenied: 用戶明確的拒絕了你的程序?qū)νㄓ嶄浀脑L問
- kABAuthorizationStatusAuthorized: 用戶已經(jīng)授權(quán)給你的程序?qū)νㄓ嶄涍M行訪問
- 申請通訊錄訪問授權(quán)(一般在程序啟動時的application:didFinishLaunchingWithOptions:代理里面寫)
// 1.獲取授權(quán)的狀態(tài)
ABAuthorizationStatus status = ABAddressBookGetAuthorizationStatus();
// 2.判斷授權(quán)狀態(tài),如果是未決定狀態(tài),才需要請求
if (status == kABAuthorizationStatusNotDetermined) {
// 2.1.創(chuàng)建通信錄對象
ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, NULL);
// 2.2.請求授權(quán)
ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error) {
if (granted) {
NSLog(@"授權(quán)成功");
} else {
NSLog(@"授權(quán)失敗");
}
});
}
1.使用<AddressBookUI.framework>
訪問通訊錄
- 導(dǎo)入框架
import <AddressBookUI/AddressBookUI.h>
- 導(dǎo)入框架
- 創(chuàng)建通訊錄界面
// 1.創(chuàng)建選擇聯(lián)系人的界面
ABPeoplePickerNavigationController *ppnc = [[ABPeoplePickerNavigationController alloc] init];
// 2.設(shè)置代理
ppnc.peoplePickerDelegate = self;
// 3.彈出選擇聯(lián)系人界面
[self presentViewController:ppnc animated:YES completion:nil];
- 3.實現(xiàn)代理方法
// 實現(xiàn)代理
@interface ViewController<ABPeoplePickerNavigationControllerDelegate>
@end
#pragma mark - 實現(xiàn)ABPeoplePickerNavigationController的代理方法
// 選中某一個聯(lián)系人的時候,會執(zhí)行該代理方法
// 如果實現(xiàn)了該方法,那么就不會進入聯(lián)系人的詳細(xì)界面
- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person
{
/*
__bridge NSString * : 將CoreFoundation框架的對象所有權(quán)交給Foundation框架來使用,但是Foundation框架中的對象并不能管理該對象內(nèi)存
__bridge_transfer NSString * : 將CoreFoundation框架的對象所有權(quán)交給Foundation來管理,如果Foundation中對象銷毀,那么我們之前的對象(CoreFoundation)會一起銷毀
*/
// 1.獲取選中聯(lián)系人的姓名(姓lastname和名firstname)
CFStringRef firstname = ABRecordCopyValue(person, kABPersonFirstNameProperty);
CFStringRef lastname = ABRecordCopyValue(person, kABPersonLastNameProperty);
NSString *firstName = (__bridge_transfer NSString *)(firstname);
NSString *lastName = (__bridge_transfer NSString *)(lastname);
NSLog(@"%@ %@", firstName, lastName);
// 2.獲取聯(lián)系人的電話號碼
ABMultiValueRef phones = ABRecordCopyValue(person, kABPersonPhoneProperty);
CFIndex count = ABMultiValueGetCount(phones);
for (CFIndex i = 0; i < count; i++) {
NSString *phoneLabel = (__bridge_transfer NSString *)ABMultiValueCopyLabelAtIndex(phones, i);
NSString *phoneValue = (__bridge_transfer NSString *)ABMultiValueCopyValueAtIndex(phones, i);
NSLog(@"label : %@ value : %@", phoneLabel, phoneValue);
}
// 3.釋放不再使用的對象
CFRelease(phones);
}
// 選擇某一個聯(lián)系人的某一個屬性時,會執(zhí)行該方法
// property選中的屬性
// identifier : 每一個屬性都由一個對應(yīng)標(biāo)示
// 如果實現(xiàn)了該方法,那么選中一個聯(lián)系人的屬性時,就會推出控制器.不會進入下一個頁面
- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier
{
NSLog(@"選擇了某一個聯(lián)系人的某一個屬性");
}
// 點擊了取消按鈕會執(zhí)行該方法
- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker
{
}
2.使用<AddressBook.framework>
訪問通訊錄
- 1.導(dǎo)入框架
import <AddressBook/AddressBook.h>
- 2.訪問通訊錄
// 1.獲取授權(quán)的狀態(tài)
ABAuthorizationStatus status = ABAddressBookGetAuthorizationStatus();
// 2.如果用戶已經(jīng)授權(quán)
if (status != kABAuthorizationStatusAuthorized) return;
// 3.創(chuàng)建通信錄對象
ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, NULL);
// 4.從通信錄對象中,將所有的聯(lián)系人拷貝出來
CFArrayRef peopleArray = ABAddressBookCopyArrayOfAllPeople(addressBook);
// 5.遍歷所有的聯(lián)系人(每一個聯(lián)系人都是一條記錄)
CFIndex peopleCount = CFArrayGetCount(peopleArray);
for (CFIndex i = 0; i < peopleCount; i++) {
// 6.獲取到聯(lián)系人
ABRecordRef person = CFArrayGetValueAtIndex(peopleArray, i);
// 7.獲取姓名
NSString *lastname = (__bridge_transfer NSString *)ABRecordCopyValue(person, kABPersonLastNameProperty);
NSString *firstName = (__bridge_transfer NSString *)ABRecordCopyValue(person, kABPersonFirstNameProperty);
NSLog(@"%@ %@", lastname, firstName);
}
// 8.釋放不再使用的對象
CFRelease(peopleArray);
CFRelease(addressBook);
3.使用第三方框架<RHAddressBook/AddressBook.h>訪問通訊錄
- 1.授權(quán)
#import <RHAddressBook/AddressBook.h>
// 1.獲取授權(quán)狀態(tài)
RHAuthorizationStatus status = [RHAddressBook authorizationStatus];
// 2.判斷授權(quán)狀態(tài),如果未決定狀態(tài),則請求授權(quán)
if (status == RHAuthorizationStatusNotDetermined) {
// 3.創(chuàng)建通信錄對象
RHAddressBook *addressBook = [[RHAddressBook alloc] init];
// 4.請求授權(quán)
[addressBook requestAuthorizationWithCompletion:^(bool granted, NSError *error) {
if (granted) {
NSLog(@"授權(quán)成功");
} else {
NSLog(@"授權(quán)失敗");
}
}];
}
- 2.訪問通訊錄
// 1.獲取授權(quán)狀態(tài)
RHAuthorizationStatus status = [RHAddressBook authorizationStatus];
// 2.判斷如果是未授權(quán),則直接返回
if (status != RHAuthorizationStatusAuthorized) return;
// 3.創(chuàng)建通信錄
RHAddressBook *addressBook = [[RHAddressBook alloc] init];
// 4.獲取所有的聯(lián)系人
NSArray *peopleArray = addressBook.people;
// 5.遍歷所有的聯(lián)系人
for (RHPerson *person in peopleArray) {
// 6.獲取聯(lián)系人的姓名
NSLog(@"%@ %@", person.firstName, person.lastName);
// 7.獲取電話號碼
RHMultiValue *phones = person.phoneNumbers;
for (int i = 0; i < phones.count; i++) {
// 8.獲取電話號碼和對應(yīng)的Label
NSString *phoneLabel = [phones labelAtIndex:i];
NSString *phoneValue = [phones valueAtIndex:i];
NSLog(@"%@ %@", phoneLabel, phoneValue);
}
}