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