您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 獲取通訊錄的四種方式詳解

編輯:iOS 開發綜合

使用場景

一些 App 透過手機號碼推薦好友,如微博、支付寶。流程是:客戶端先獲取通訊錄中的所有手機號並提交到服務器,服務器查找每個手機號對應的 App 帳號後返回客戶端,客戶端再根據帳號列表推薦好友。

獲取聯繫人的方式

方案一:AddressBookUI.framework——提供聯繫人列表、詳情、添加等界面,通常用於選擇聯繫人。

方案二:AddressBook.framework——不提供 UI,需自行搭建界面;純 C 語言 API,僅獲得聯繫人數據;大部分數據類型是 Core Foundation;從 iOS 6 開始需獲得用戶授權才能訪問通訊錄。

方案三:第三方框架 RHAddressBook——對 AddressBook.framework 進行封裝。

方案四:iOS 9.0 最新通訊錄框架。ContactsUI.framework 是方案一的替代品,特點是面向對象、使用簡單、有界面;Contacts.framework 是方案二的替代品,特點是面向對象、使用簡單、無界面。

方案一:AddressBookUI.framework

實現步驟:

1. 創建選擇聯繫人的控制器;2. 設置代理以接收用戶選擇的聯繫人資訊;3. 彈出聯繫人控制器;4. 實現代理方法;5. 在代理方法中獲取聯繫人資訊。

AddressBook.framework

實現步驟:

1. 請求授權;2. 判斷授權狀態,已授權則繼續,未授權則提示用戶;3. 創建通訊錄對象;4. 獲取所有聯繫人;5. 遍歷所有聯繫人;6. 釋放不再使用的對象。

1. AppDelegate 應用啟動時請求授權

#import "AppDelegate.h"
#import <AddressBook/AddressBook.h>

@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [self requestAuthorizationAddressBook];
    return YES;
}
- (void)requestAuthorizationAddressBook {
    // 判斷是否授權
    ABAuthorizationStatus authorizationStatus = ABAddressBookGetAuthorizationStatus();
    if (authorizationStatus == kABAuthorizationStatusNotDetermined) {
        // 請求授權
        ABAddressBookRef addressBookRef = ABAddressBookCreate();
        ABAddressBookRequestAccessWithCompletion(addressBookRef, ^(bool granted, CFErrorRef error) {
            if (granted) {
                // 授權成功
            } else {
                NSLog(@"授權失敗!");
            }
        });
    }
}
@end

2. iOS 10 需要在 Info.plist 配置 NSContactsUsageDescription

<key>NSContactsUsageDescription</key>
<string>請求訪問通訊錄</string>

3. ViewController

#import "ViewController.h"
#import <AddressBook/AddressBook.h>

@implementation ViewController
- (void)touchesBegan:(NSSet<UITouch> *)touches withEvent:(UIEvent *)event {
    // 1. 判斷授權
    ABAuthorizationStatus authorizationStatus = ABAddressBookGetAuthorizationStatus();
    if (authorizationStatus != kABAuthorizationStatusAuthorized) {
        NSLog(@"沒有授權");
        return;
    }
    // 2. 獲取所有聯繫人
    ABAddressBookRef addressBookRef = ABAddressBookCreate();
    CFArrayRef arrayRef = ABAddressBookCopyArrayOfAllPeople(addressBookRef);
    long count = CFArrayGetCount(arrayRef);
    for (int i = 0; i < count; i++) {
        // 獲取聯繫人對象的引用
        ABRecordRef people = CFArrayGetValueAtIndex(arrayRef, i);
        // 獲取當前聯繫人名字
        NSString *firstName = (__bridge NSString *)(ABRecordCopyValue(people, kABPersonFirstNameProperty));
        // 獲取當前聯繫人姓氏
        NSString *lastName = (__bridge NSString *)(ABRecordCopyValue(people, kABPersonLastNameProperty));
        NSLog(@"firstName=%@, lastName=%@", firstName, lastName);
        // 獲取當前聯繫人的電話數組
        NSMutableArray *phoneArray = [[NSMutableArray alloc] init];
        ABMultiValueRef phones = ABRecordCopyValue(people, kABPersonPhoneProperty);
        // 遍歷電話號碼...
    }
}
@end

4. 運行結果


第三方框架:RHAddressBook


https://github.com/heardrwt/RHAddressBook

該框架使用 MRC 管理內存,直接拖入源碼需為每個文件設置編譯標記 -fno-objc-arc,設置後仍可能報錯(部分方法過於古老、多已不支援),因此不建議此方式;可將項目打成靜態庫,或直接把項目拖入工程作為依賴。

直接將 RHAddressBook.xcodeproj 拖入工程:

添加 Target Dependencies 和 Link Binary With Libraries:

Build Settings → Other Linker Flags 添加 -ObjC,用於解決系統分類找不到方法的錯誤:

iOS 10 需在 Info.plist 配置 NSContactsUsageDescription:

<key>NSContactsUsageDescription</key>
<string>請求訪問通訊錄</string>

App 啟動時請求授權訪問通訊錄:

#import "AppDelegate.h"
#import <RHAddressBook/RHAddressBook.h>

@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [self requestAuthorizationForAddressBook];
    return YES;
}
- (void)requestAuthorizationForAddressBook {
    RHAddressBook *ab = [[RHAddressBook alloc] init];
    if ([RHAddressBook authorizationStatus] == RHAuthorizationStatusNotDetermined){
        [ab requestAuthorizationWithCompletion:^(bool granted, NSError *error) {
            if (granted) {
            } else {
                NSLog(@"請求授權拒絕");
            }
        }];
    }
}
@end

獲取所有聯繫人資訊(姓名、手機號等):

#import "ViewController.h"
#import <RHAddressBook/RHAddressBook.h>
#import <RHAddressBook/RHAddressBook.h>

@implementation ViewController
- (void)touchesBegan:(NSSet<UITouch> *)touches withEvent:(UIEvent *)event {
    RHAddressBook *addressBook = [[RHAddressBook alloc] init];
    if ([RHAddressBook authorizationStatus] != RHAuthorizationStatusAuthorized){
        NSLog(@"沒有授權");
        return;
    }
    NSArray *peopleArray = addressBook.people;
    for (int i = 0; i < peopleArray.count; i++) {
        RHPerson *people = (RHPerson *)peopleArray[i];
        NSLog(@"%@", people.name);
        RHMultiStringValue *phoneNumbers = people.phoneNumbers;
        for (int i = 0; i < phoneNumbers.count; i++) {
            NSString *label = [phoneNumbers labelAtIndex:i];
            NSString *value = [phoneNumbers valueAtIndex:i];
            NSLog(@"label=%@, value=%@", label, value);
        }
        NSLog(@"----------------------------------------------");
    }
}
@end

運行結果:


ContactsUI.framework


#import "ViewController.h"
#import <ContactsUI/ContactsUI.h>

@interface ViewController () <CNContactPickerDelegate>
@end

@implementation ViewController
- (void)viewDidLoad {
    [super viewDidLoad];
    CNContactPickerViewController *contactPickerViewController = [[CNContactPickerViewController alloc] init];
    contactPickerViewController.delegate = self;
    [self presentViewController:contactPickerViewController animated:YES completion:nil];
}
// 選中單個聯繫人時調用(實現此方法後不再出現詳情界面)
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact {
    NSLog(@"選中某一個聯繫人時調用-----------------");
    [self printContactInfo:contact];
}
// 同時選中多個聯繫人
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContacts:(NSArray<CNContact *> *)contacts {
    for (CNContact *contact in contacts) {
        NSLog(@"================================================");
        [self printContactInfo:contact];
    }
}
- (void)printContactInfo:(CNContact *)contact {
    NSString *givenName = contact.givenName;
    NSString *familyName = contact.familyName;
    NSLog(@"givenName=%@, familyName=%@", givenName, familyName);
    NSArray *phoneNumbers = contact.phoneNumbers;
    for (CNLabeledValue<CNPhoneNumber*> *phone in phoneNumbers) {
        NSString *label = phone.label;
        CNPhoneNumber *phonNumber = (CNPhoneNumber *)phone.value;
        NSLog(@"label=%@, value=%@", label, phonNumber.stringValue);
    }
}
// 注意: 若實現下面這個方法,上面那個就不能實現,兩者只能選其一
// - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty {
//     NSLog(@"選中某個聯繫人的某個屬性時調用");
// }
@end

選擇單個聯繫人時的運行效果:

選擇多個聯繫人的界面:


Contacts.framework


iOS 10 需要在 Info.plist 配置 NSContactsUsageDescription:

<key>NSContactsUsageDescription</key>
<string>請求訪問通訊錄</string>

應用啟動時請求授權:

#import "AppDelegate.h"
#import <Contacts/Contacts.h>

@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [self requestAuthorizationForAddressBook];
    return YES;
}
- (void)requestAuthorizationForAddressBook {
    CNAuthorizationStatus authorizationStatus = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
    if (authorizationStatus == CNAuthorizationStatusNotDetermined) {
        CNContactStore *contactStore = [[CNContactStore alloc] init];
        [contactStore requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
            if (granted) {
            } else {
                NSLog(@"授權失敗, error=%@", error);
            }
        }];
    }
}
@end

獲取通訊錄資訊:

#import "ViewController.h"
#import <Contacts/Contacts.h>

@implementation ViewController
- (void)touchesBegan:(NSSet<UITouch> *)touches withEvent:(UIEvent *)event {
    CNAuthorizationStatus authorizationStatus = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
    if (authorizationStatus == CNAuthorizationStatusAuthorized) {
        NSLog(@"已授權...");
    }
    // 獲取指定字段,需指定具體字段而非全部
    NSArray *keysToFetch = @[CNContactGivenNameKey, CNContactFamilyNameKey, CNContactPhoneNumbersKey];
    CNContactFetchRequest *fetchRequest = [[CNContactFetchRequest alloc] initWithKeysToFetch:keysToFetch];
    CNContactStore *contactStore = [[CNContactStore alloc] init];
    [contactStore enumerateContactsWithFetchRequest:fetchRequest error:nil usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) {
        NSLog(@"-------------------------------------------------------");
        NSString *givenName = contact.givenName;
        NSString *familyName = contact.familyName;
        NSLog(@"givenName=%@, familyName=%@", givenName, familyName);
        NSArray *phoneNumbers = contact.phoneNumbers;
        for (CNLabeledValue *labelValue in phoneNumbers) {
            NSString *label = labelValue.label;
            CNPhoneNumber *phoneNumber = labelValue.value;
            NSLog(@"label=%@, phone=%@", label, phoneNumber.stringValue);
        }
        // *stop = YES; // 停止循環,相當於 break
    }];
}
@end

運行效果:

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved