- ABAddressBookRef:代表通訊錄對象,通過該對象開發(fā)人員不用過多的關(guān)注通訊錄的存儲(chǔ)方式,可以直接以透明的方式去訪問、保存(在使用AddressBook.framework操作聯(lián)系人時(shí),所有的增加、刪除、修改后都必須執(zhí)行保存操作,類似于Core Data)等。
- ABRecordRef:代表一個(gè)通用的記錄對象,可以是一條聯(lián)系人信息,也可以是一個(gè)群組,可以通過ABRecordGetRecordType()函數(shù)獲得具體類型。如果作為聯(lián)系人(事實(shí)上也經(jīng)常使用它作為聯(lián)系人),那么這個(gè)記錄記錄了一個(gè)完整的聯(lián)系人信息(姓名、性別、電話、郵件等),每條記錄都有一個(gè)唯一的ID標(biāo)示這條記錄(可以通過ABRecordGetRecordID()函數(shù)獲得)。
- ABPersonRef:代表聯(lián)系人信息,很少直接使用,實(shí)際開發(fā)過程中通常會(huì)使用類型為“kABPersonType”的ABRecordRef來表示聯(lián)系人(由此可見ABPersonRef其實(shí)是一種類型為“kABPersonType”的ABRecordRef)
- ABGroupRef:代表群組,與ABPersonRef類似,很少直接使用ABGroupRef,而是使用類型為“kABGroupType”的ABRecordRef來表示群組,一個(gè)群組可以包含多個(gè)聯(lián)系人,一個(gè)聯(lián)系人也同樣可以多個(gè)群組。
- ABPersonCreate():創(chuàng)建一個(gè)類型為“kABPersonType”的ABRecordRef。
- ABRecordCopyValue():取得指定屬性的值。
- ABRecordCopyCompositeName():取得聯(lián)系人(或群組)的復(fù)合信息(對于聯(lián)系人則包括:姓、名、公司等信息,對于群組則返回組名稱)。
- ABRecordSetValue():設(shè)置ABRecordRef的屬性值。注意在設(shè)置ABRecordRef的值時(shí)又分為單值屬性和多值屬性:單值屬性設(shè)置只要通過ABRecordSetValue()方法指定屬性名和值即可;多值屬性則要先通過創(chuàng)建一個(gè)
- ABMutableMultiValueRef類型的變量,然后通過ABMultiValueAddValueAndLabel()方法依次添加屬性值,最后通過ABRecordSetValue()方法將ABMutableMultiValueRef類型的變量設(shè)置為記錄值。
- ABRecordRemoveValue():刪除指定的屬性值。
訪問通訊錄代碼:
//
// WJAddressBookManager.h
// iOS通訊錄
//
// Created by 幻想無極(譚啟宏) on 16/8/18.
// Copyright ? 2016年 幻想無極(譚啟宏). All rights reserved.
//
#import <Foundation/Foundation.h>
@interface WJAddressBookModel : NSObject
@property (nonatomic,copy)NSString *firstName; //名
@property (nonatomic,copy)NSString *lastName; //姓
@property (nonatomic,copy)NSArray *phoneNumbers;//電話號(hào)碼(可能有多條手機(jī)號(hào))
@end
typedef void (^personArrayBlock)(NSArray <WJAddressBookModel *>* array);
/**通訊錄管理類*/
@interface WJAddressBookManager : NSObject
-(void)requestAddressBookWithArray:(personArrayBlock)array;
@end
//
// WJAddressBookManager.m
// iOS通訊錄
//
// Created by 幻想無極(譚啟宏) on 16/8/18.
// Copyright ? 2016年 幻想無極(譚啟宏). All rights reserved.
//
#import "WJAddressBookManager.h"
#import <AddressBook/AddressBook.h>
@implementation WJAddressBookModel
@end
@interface WJAddressBookManager ()
@property (assign,nonatomic) ABAddressBookRef addressBook;//通訊錄
@property (strong,nonatomic) NSMutableArray *allPerson;//通訊錄所有人員
@end
@implementation WJAddressBookManager
#pragma mark - 私有方法
/**
* 請求訪問通訊錄
*/
-(void)requestAddressBookWithArray:(personArrayBlock)array {
//創(chuàng)建通訊錄對象
self.addressBook = ABAddressBookCreateWithOptions(NULL, NULL);
//請求訪問用戶通訊錄,注意無論成功與否block都會(huì)調(diào)用
ABAddressBookRequestAccessWithCompletion(self.addressBook, ^(bool granted, CFErrorRef error) {
if (!granted) {
NSLog(@"未獲得通訊錄訪問權(quán)限!");
}
[self initAllPersonArray:array];
});
}
/**
* 取得所有通訊錄記錄
*/
-(void)initAllPersonArray:(personArrayBlock)array {
//取得通訊錄訪問授權(quán)
ABAuthorizationStatus authorization= ABAddressBookGetAuthorizationStatus();
//如果未獲得授權(quán)
if (authorization!=kABAuthorizationStatusAuthorized) {
NSLog(@"尚未獲得通訊錄訪問授權(quán)!");
return ;
}
//取得通訊錄中所有人員記錄
CFArrayRef allPeople= ABAddressBookCopyArrayOfAllPeople(self.addressBook);
self.allPerson=(__bridge NSMutableArray *)allPeople;
array([self getPersonListArray]);
//釋放資源
CFRelease(allPeople);
}
- (NSArray <WJAddressBookModel *>*)getPersonListArray {
NSMutableArray *array = [NSMutableArray array];
for (int i = 0; i < self.allPerson.count; i++) {
ABRecordRef recordRef=(__bridge ABRecordRef)self.allPerson[i];
//取得記錄中得信息
NSString *firstName=(__bridge NSString *) ABRecordCopyValue(recordRef, kABPersonFirstNameProperty);//注意這里進(jìn)行了強(qiáng)轉(zhuǎn),不用自己釋放資源
NSString *lastName=(__bridge NSString *)ABRecordCopyValue(recordRef, kABPersonLastNameProperty);
ABMultiValueRef phoneNumbersRef= ABRecordCopyValue(recordRef, kABPersonPhoneProperty);//獲取手機(jī)號(hào),注意手機(jī)號(hào)是ABMultiValueRef類,有可能有多條
NSArray *phoneNumbers=(__bridge NSArray *)ABMultiValueCopyArrayOfAllValues(phoneNumbersRef);//取得CFArraryRef類型的手機(jī)記錄并轉(zhuǎn)化為NSArrary
// long count= ABMultiValueGetCount(phoneNumbersRef);
// for(int i=0;i<count;++i){
// NSString *phoneLabel= (__bridge NSString *)(ABMultiValueCopyLabelAtIndex(phoneNumbersRef, i));
// NSString *phoneNumber=(__bridge NSString *)(ABMultiValueCopyValueAtIndex(phoneNumbersRef, i));
// NSLog(@"%@:%@",phoneLabel,phoneNumber);
// }
NSLog(@"%@,%@",firstName,lastName);
WJAddressBookModel *model = [[WJAddressBookModel alloc]init];
model.firstName = firstName;
model.lastName = lastName;
model.phoneNumbers = phoneNumbers;
[array addObject:model];
}
return array;
}
@end