重點 (二十九) : 通訊錄

如何訪問用戶的通訊錄

在iOS中，有2個框架可以訪問用戶的通訊錄

AddressBookUI.framework

提供了聯系人列表界面、聯系人詳情界面、添加聯系人界面等

一般用于選擇聯系人

AddressBook.framework

純C語言的API，僅僅是獲得聯系人數據

沒有提供UI界面展示，需要自己搭建聯系人展示界面

里面的數據類型大部分基于Core Foundation框架，使用起來極其蛋疼

從iOS6開始，需要得到用戶的授權才能訪問通訊錄，因此在使用之前，需要檢查用戶是否已經授權

獲得通訊錄的授權狀態：ABAddressBookGetAuthorizationStatus()

授權狀態

kABAuthorizationStatusNotDetermined

用戶還沒有決定是否授權你的程序進行訪問

kABAuthorizationStatusRestricted

iOS設備上的家長控制或其它一些許可配置阻止程序與通訊錄數據庫進行交互

kABAuthorizationStatusDenied

用戶明確的拒絕了你的程序對通訊錄的訪問

kABAuthorizationStatusAuthorized

用戶已經授權給你的程序對通訊錄進行訪問

申請訪問通訊錄

實例化通訊錄對象

ABAddressBookRefaddressBook = ABAddressBookCreateWithOptions(NULL, NULL);

ABAddressBookRequestAccessWithCompletion(addressBook, ^(boolgranted, CFErrorReferror) {

if (granted)

{

    NSLog(@"授權成功！");

} else {

    NSLog(@"授權失敗!");

}

});

CFRelease(addressBook);

提示：申請通訊錄訪問授權的代碼，通常放在AppDelegate中

聯系人屬性定義

所有的屬性常量值都定義在了ABPerson.h頭文件中

聯系人屬性包括以下類型：

簡單屬性：姓、名等

多重屬性：電話號碼、電子郵件等

組合屬性：地址等

注意：使用ABRecordCopyValue可以從一條Person記錄中獲取到對應的記錄，但是后續處理則需要根據記錄的具體類型加以區分

簡單屬性

一個聯系人就是一個ABRecordRef，每個聯系人都有自己的屬性，比如名字、電話、郵件等

使用ABRecordCopyValue函數可以從ABRecordRef中獲得聯系人的簡單屬性（例如：一個字符串）

ABRecordCopyValue函數接收2個參數

第1個參數是ABRecordRef實例

第2個參數是屬性關鍵字，定義在ABPerson.h中

ABPersonCopyLocalizedPropertyName函數可以根據指定的關鍵字獲取對應的標簽文本

獲得所有的聯系人數據

獲取所有聯系人記錄

CFArrayRefarray = ABAddressBookCopyArrayOfAllPeople(addressBook);

NSInteger count = CFArrayGetCount(array);

for (NSInteger i =0; i < count; ++i) {

取出一條記錄

ABRecordRef person =

CFArrayGetValueAtIndex(array, i);

取出個人記錄中的詳細信息

名

CFStringRef firstNameLabel =

ABPersonCopyLocalizedPropertyName(kABPersonFirstNameProperty);

CFStringRef firstName =

ABRecordCopyValue(person, kABPersonFirstNameProperty);

CFStringRef

lastNameLabel = ABPersonCopyLocalizedPropertyName(kABPersonLastNameProperty);

姓

CFStringRef lastName = ABRecordCopyValue(person,

kABPersonLastNameProperty);

NSLog(@"%@ %@ - %@ %@", lastNameLabel,

lastName, firstNameLabel, firstName);

}

CoreFoundation 與 Foundation之間的橋接

獲取通訊錄引用

ABAddressBookRefaddressBook = ABAddressBookCreateWithOptions(NULL, nil);

獲取所有聯系人記錄

NSArray*array = (__bridge NSArray *)(ABAddressBookCopyArrayOfAllPeople(addressBook));

for (NSInteger i = 0;
i < array.count; i++) {

    取出一條記錄

    ABRecordRef

person = (__bridge ABRecordRef)(array[i]);

    取出個人記錄中的詳細信息

    NSString *firstNameLabel

= (__bridge NSString*)(ABPersonCopyLocalizedPropertyName(kABPersonFirstNameProperty));

NSString *firstName = (__bridge NSString*)(ABRecordCopyValue(person, kABPersonFirstNameProperty));

NSString *lastNameLabel

= (__bridge NSString*)(ABPersonCopyLocalizedPropertyName(kABPersonLastNameProperty));

NSString *lastName = (__bridge NSString*)(ABRecordCopyValue(person, kABPersonLastNameProperty));

NSLog(@"%@ %@ - %@ %@", lastNameLabel,

lastName, firstNameLabel, firstName);

}

CFRelease(addressBook);

結論：轉換看起來很美~~~

多重屬性

聯系人的有些屬性值就沒這么簡單，一個屬性可能會包含多個值

比如郵箱，分為工作郵箱、住宅郵箱、其他郵箱等

比如電話，分為工作電話、住宅電話、其他電話等

如果是復雜屬性，那么ABRecordCopyValue函數返回的就是ABMultiValueRef類型的數據，例如郵箱或者電話

取電話號碼

ABMultiValueRefphones = ABRecordCopyValue(person, kABPersonPhoneProperty);

取記錄數量

NSInteger phoneCount =ABMultiValueGetCount(phones);

遍歷所有的電話號碼

for (NSInteger i = 0;
i < phoneCount; i++) {

…

獲取復雜屬性的方法

電話標簽

CFStringRefphoneLabel = ABMultiValueCopyLabelAtIndex(phones, i);

本地化電話標簽

CFStringRef
phoneLocalLabel = ABAddressBookCopyLocalizedLabel(phoneLabel);

電話號碼

CFStringRef phoneNumber
= ABMultiValueCopyValueAtIndex(phones, i);

添加聯系人的步驟

通過ABPersonCreate函數創建一個新的聯系人（返回ABRecordRef）

通過ABRecordSetValue函數設置聯系人的屬性

通過ABAddressBookAddRecord函數將聯系人添加到通訊錄數據庫中

通過ABAddressBookSave函數保存剛才所作的修改

可以通過ABAddressBookHasUnsavedChanges函數判斷是否有未保存的修改

當決定是否更改通訊錄數據庫后,你可以分別使用 AbAddressBookSave 或 ABAddressBookRevert 方式來保存或放棄更改

添加群組的步驟

添加群組的步驟大體和添加聯系人一致

通過ABPersonCreate函數創建一個新的組（返回ABRecordRef）

通過ABRecordSetValue函數設置組名

通過ABAddressBookAddRecord函數將組添加到通訊錄數據庫中

通過ABAddressBookSave函數保存剛才所作的修改

操作聯系人的頭像

想操作聯系人的頭像，有以下函數

BPersonHasImageData

判斷通訊錄中的聯系人是否有圖片

ABPersonCopyImageData

取得圖片數據(假如有的話)

ABPersonSetImageData

設置聯系人的圖片數據

*******************筆記**********************

一. 通訊錄獲取

通訊錄應用場景
最常見的是一些即時通訊APP, 關聯聯系人;

通訊錄獲取方案

1.AddressBookUI.framework 框架

提供了聯系人列表界面、聯系人詳情界面、添加聯系人界面等

一般用于選擇聯系人

2.AddressBook.framework 框架

純C語言的API，僅僅是獲得聯系人數據

沒有提供UI界面展示，需要自己搭建聯系人展示界面

里面的數據類型大部分基于Core Foundation框架，使用起來極其蛋疼

3.ContactsUI.framework (iOS9.0最新框架)

方案1/方案2 的替代品

4.第三方框架
RHAddressBook

對AddressBook.framework框架的封裝

獲取通訊錄-AddressBookUI
實現步驟

1.創建選擇聯系人的控制器

2.設置代理(用來接收用戶選擇的聯系人信息)

3.彈出聯系人控制器

4.實現代理

5.在對應的代理方法中獲取聯系人信息

具體代碼實現

1.創建選擇聯系人的控制器

ABPeoplePickerNavigationController
*ppnc = [[ABPeoplePickerNavigationController alloc] init];

2.設置代理(用來接收用戶選擇的聯系人信息)

ppnc.peoplePickerDelegate
= self;

3.彈出聯系人控制器

[self presentViewController:ppnc animated:YES completion:nil];

4.實現代理

選中某個聯系人時調用

(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController
*)peoplePicker didSelectPerson:(ABRecordRef)person

{

}

選中某個聯系人某個屬性時調用

(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController
*)peoplePicker didSelectPerson:(ABRecordRef)person
property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier

{

}

點擊了取消按鈕會執行該方法

(void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController
*)peoplePicker

{

}

5.在對應的代理方法中獲取聯系人信息

獲取選中聯系人的姓名(姓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);

獲取聯系人的電話號碼

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

}

釋放不再使用的對象

CFRelease(phones);

獲取通訊錄-AddressBook
實現步驟

1.請求授權

2.判斷授權狀態, 如果已授權, 則繼續; 未授權, 則提示用戶, 并返回;

3.創建通訊錄對象

4.從通信錄對象中, 獲取所有的聯系人

5.遍歷所有的聯系人

6.釋放不再使用的對象

代碼實現

1.請求授權

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(@"授權失敗");


  }

});

}

2.判斷授權狀態, 如果已授權, 則繼續; 未授權, 則提示用戶, 并返回;

1.獲取授權的狀態

ABAuthorizationStatus
status = ABAddressBookGetAuthorizationStatus();

2.如果用戶已經授權

if (status != kABAuthorizationStatusAuthorized)return;

3.創建通訊錄對象

ABAddressBookRef
addressBook = ABAddressBookCreateWithOptions(NULL,
NULL);

4.從通信錄對象中, 獲取所有的聯系人

CFArrayRef
peopleArray = ABAddressBookCopyArrayOfAllPeople(addressBook);

5.遍歷所有的聯系人

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

}

6.釋放不再使用的對象

CFRelease(peopleArray);

CFRelease(addressBook);

獲取通訊錄-第三方框架RHAddressBook
實現步驟

1.集成框架

2.使用框架獲取所有聯系人信息

具體實現

1.集成框架

將整個工程拖入項目

添加工程依賴

Build
Phases -> Target Dependencies -> +

添加鏈接項

Build
Settings -> Other Linker Flags -> -ObjC -all_load

導入框架頭文件

import <RHAddressBook/AddressBoook.h>

2.使用框架獲取所有聯系人信息

請求授權

獲取授權狀態

RHAuthorizationStatus
status = [RHAddressBook authorizationStatus];

if (status == RHAuthorizationStatusNotDetermined)

{

2. 創建通訊錄對象

RHAddressBook *addressBook = [[RHAddressBook alloc] init];

3. 請求授權

[addressBook requestAuthorizationWithCompletion:^(bool granted, NSError *error) {

  if (granted)


  {

        NSLog(@"授權成功!");


  }


  else


  {

        NSLog(@"授權失敗");


  }

}];

}

獲取聯系人信息

判斷當前授權狀態

RHAuthorizationStatus
status = [RHAddressBook authorizationStatus];

if (status != RHAuthorizationStatusAuthorized) {

return;

}

創建通訊錄對象

RHAddressBook
*addressBook = [[RHAddressBook alloc] init];

獲取所有聯系人

NSArray
*peoples = addressBook.people;

遍歷所有聯系人

for (RHPerson *person in
peoples)

{

4.1 獲取聯系人姓名

NSString *firstName = person.firstName;

NSString *lastName = person.lastName;

NSLog(@"%@---%@",
firstName, lastName);

4.2 獲取聯系人電話

RHMultiStringValue *mv = person.phoneNumbers;

for (int
i = 0; i < mv.count; i ++)

{

    4.2.1 獲取電話標簽


  NSString *label = [mv labelAtIndex:i];


 

    4.2.2 獲取電話號碼


  NSString *phone = [mv valueAtIndex:i];


  NSLog(@"%@--%@",

label, phone);

}

最后編輯于：2017.12.04 05:48:29

?著作權歸作者所有,轉載或內容合作請聯系作者

人面猴
序言：七十年代末，一起剝皮案震驚了整個濱河市，隨后出現的幾起案子，更是在濱河造成了極大的恐慌，老刑警劉巖，帶你破解...
沈念sama閱讀 227,533評論 6贊 531
死咒
序言：濱河連續發生了三起死亡事件，死亡現場離奇詭異，居然都是意外死亡，警方通過查閱死者的電腦和手機，發現死者居然都...
沈念sama閱讀 98,055評論 3贊 414
救了他兩次的神仙讓他今天三更去死
文/潘曉璐我一進店門，熙熙樓的掌柜王于貴愁眉苦臉地迎上來，“玉大人，你說我怎么就攤上這事。” “怎么了？”我有些...
開封第一講書人閱讀 175,365評論 0贊 373
道士緝兇錄：失蹤的賣姜人
文/不壞的土叔我叫張陵，是天一觀的道長。經常有香客問我，道長，這世上最難降的妖魔是什么？我笑而不...
開封第一講書人閱讀 62,561評論 1贊 307
?港島之戀（遺憾婚禮）
正文為了忘掉前任，我火速辦了婚禮，結果婚禮上，老公的妹妹穿的比我還像新娘。我一直安慰自己，他們只是感情好，可當我...
茶點故事閱讀 71,346評論 6贊 404
惡毒庶女頂嫁案：這布局不是一般人想出來的
文/花漫我一把揭開白布。她就那樣靜靜地躺著，像睡著了一般。火紅的嫁衣襯著肌膚如雪。梳的紋絲不亂的頭發上，一...
開封第一講書人閱讀 54,889評論 1贊 321
城市分裂傳說
那天，我揣著相機與錄音，去河邊找鬼。笑死，一個胖子當著我的面吹牛，可吹牛的內容都是我干的。我是一名探鬼主播，決...
沈念sama閱讀 42,978評論 3贊 439
雙鴛鴦連環套：你想象不到人心有多黑
文/蒼蘭香墨我猛地睜開眼，長吁一口氣：“原來是場噩夢啊……” “哼！你這毒婦竟也來了？” 一聲冷哼從身側響起，我...
開封第一講書人閱讀 42,118評論 0贊 286
萬榮殺人案實錄
序言：老撾萬榮一對情侶失蹤，失蹤者是張志新（化名）和其女友劉穎，沒想到半個月后，有當地人在樹林里發現了一具尸體，經...
沈念sama閱讀 48,637評論 1贊 333
?護林員之死
正文獨居荒郊野嶺守林人離奇死亡，尸身上長有42處帶血的膿包…… 初始之章·張勛以下內容為張勛視角年9月15日...
茶點故事閱讀 40,558評論 3贊 354
?白月光啟示錄
正文我和宋清朗相戀三年，在試婚紗的時候發現自己被綠了。大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
茶點故事閱讀 42,739評論 1贊 369
活死人
序言：一個原本活蹦亂跳的男人離奇死亡，死狀恐怖，靈堂內的尸體忽然破棺而出，到底是詐尸還是另有隱情，我是刑警寧澤，帶...
沈念sama閱讀 38,246評論 5贊 355
?日本核電站爆炸內幕
正文年R本政府宣布，位于F島的核電站，受9級特大地震影響，放射性物質發生泄漏。R本人自食惡果不足惜，卻給世界環境...
茶點故事閱讀 43,980評論 3贊 346
男人毒藥：我在死后第九天來索命
文/蒙蒙一、第九天我趴在偏房一處隱蔽的房頂上張望。院中可真熱鬧，春花似錦、人聲如沸。這莊子的主人今日做“春日...
開封第一講書人閱讀 34,362評論 0贊 25
一樁弒父案，背后竟有這般陰謀
文/蒼蘭香墨我抬頭看了看天上的太陽。三九已至，卻和暖如春，著一層夾襖步出監牢的瞬間，已是汗流浹背。一陣腳步聲響...
開封第一講書人閱讀 35,619評論 1贊 280
情欲美人皮
我被黑心中介騙來泰國打工，沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留，地道東北人。一個月前我還...
沈念sama閱讀 51,347評論 3贊 390
代替公主和親
正文我出身青樓，卻偏偏與公主長得像，于是被迫代替她去往敵國和親。傳聞我的和親對象是個殘疾皇子，可洞房花燭夜當晚...
茶點故事閱讀 47,702評論 2贊 370

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频

重點 (二十九) : 通訊錄

重點 (二十九) : 通訊錄

import <RHAddressBook/AddressBoook.h>

推薦閱讀更多精彩內容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美 国产 综合 欧美 视频

重點 (二十九) : 通訊錄

import <RHAddressBook/AddressBoook.h>

推薦閱讀更多精彩內容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频