您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

iOS 通訊錄開發實戰:直接選號與批量讀取通訊錄

編輯:iOS 相關資訊

本文整理兩個常見的通訊錄場景:一是直接調起系統界面讓用戶挑一個電話號碼,二是把整個通訊錄讀出來自己做界面。

場景一:直接選擇一個聯繫人的電話號碼

這個需求完全不需要自己獲取全部聯繫人、再手寫一份通訊錄列表,直接用系統提供的 AddressBookUI/ABPeoplePickerNavigationController.h 就好。

首先引入三個頭文件:

#import <AddressBookUI/ABPeoplePickerNavigationController.h>
#import <AddressBook/ABPerson.h>
#import <AddressBookUI/ABPersonViewController.h>

接著初始化並呈現 ABPeoplePickerNavigationController:

ABPeoplePickerNavigationController *nav = [[ABPeoplePickerNavigationController alloc] init];
nav.peoplePickerDelegate = self;
if (IOS8_OR_LATER) {
    nav.predicateForSelectionOfPerson = [NSPredicate predicateWithValue:false];
}
[self presentViewController:nav animated:YES completion:nil];

這裡有個 iOS 8 的關鍵差異:必須加上 nav.predicateForSelectionOfPerson = [NSPredicate predicateWithValue:false];,否則選中聯繫人之後會直接 dismiss,根本進不到選擇具體電話號碼的詳情頁。

最後實現代理方法。取消選擇時:

// 取消選擇
- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker {
    [peoplePicker dismissViewControllerAnimated:YES completion:nil];
}

iOS 8 下的代理實現

- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker
       didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property
            identifier:(ABMultiValueIdentifier)identifier {
    ABMultiValueRef phone = ABRecordCopyValue(person, kABPersonPhoneProperty);
    long index = ABMultiValueGetIndexForIdentifier(phone, identifier);
    NSString *phoneNO = (__bridge NSString *)ABMultiValueCopyValueAtIndex(phone, index);
    if ([phoneNO hasPrefix:@"+"]) {
        phoneNO = [phoneNO substringFromIndex:3];
    }
    phoneNO = [phoneNO stringByReplacingOccurrencesOfString:@"-" withString:@""];
    NSLog(@"%@", phoneNO);
    if (phone && [ZXValidateHelper checkTel:phoneNO]) {
        phoneNum = phoneNO;
        [self.tableView reloadData];
        [peoplePicker dismissViewControllerAnimated:YES completion:nil];
        return;
    }
}

- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker
                        didSelectPerson:(ABRecordRef)person {
    ABPersonViewController *personViewController = [[ABPersonViewController alloc] init];
    personViewController.displayedPerson = person;
    [peoplePicker pushViewController:personViewController animated:YES];
}

iOS 7 下的代理實現

的差別在於返回值是 BOOL:返回 YES 表示讓系統繼續前進,返回 NO 表示事件已被你處理掉。

- (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker
      shouldContinueAfterSelectingPerson:(ABRecordRef)person {
    return YES;
}

- (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker
    shouldContinueAfterSelectingPerson:(ABRecordRef)person
                            property:(ABPropertyID)property
                          identifier:(ABMultiValueIdentifier)identifier {
    ABMultiValueRef phone = ABRecordCopyValue(person, kABPersonPhoneProperty);
    long index = ABMultiValueGetIndexForIdentifier(phone, identifier);
    NSString *phoneNO = (__bridge NSString *)ABMultiValueCopyValueAtIndex(phone, index);
    if ([phoneNO hasPrefix:@"+"]) {
        phoneNO = [phoneNO substringFromIndex:3];
    }
    phoneNO = [phoneNO stringByReplacingOccurrencesOfString:@"-" withString:@""];
    NSLog(@"%@", phoneNO);
    if (phone && [ZXValidateHelper checkTel:phoneNO]) {
        phoneNum = phoneNO;
        [self.tableView reloadData];
        [peoplePicker dismissViewControllerAnimated:YES completion:nil];
        return NO;
    }
    return YES;
}

效果演示:

實務上有幾點值得注意:号码取出後通常要做清洗(去掉國際碼前綴與分隔符)再校驗;CF 系列 API 遵循「Create Rule」,凡是帶 Copy / Create 的調用完都要相應地 CFRelease 或利用 ARC 的橋接,否則在大量數據場景下容易洩漏。

場景二:讀取整個通訊錄

這裡需要自己拿到全部數據。首先引入頭文件:

#import <AddressBook/AddressBook.h>

然後依據權限狀態決定如何取得通訊錄引用:

- (void)loadPerson {
    ABAddressBookRef addressBookRef = ABAddressBookCreateWithOptions(NULL, NULL);
    if (ABAddressBookGetAuthorizationStatus() == kABAuthorizationStatusNotDetermined) {
        ABAddressBookRequestAccessWithCompletion(addressBookRef, ^(bool granted, CFErrorRef error) {
            CFErrorRef *error1 = NULL;
            ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, error1);
            [self copyAddressBook:addressBook];
        });
    } else if (ABAddressBookGetAuthorizationStatus() == kABAuthorizationStatusAuthorized) {
        CFErrorRef *error = NULL;
        ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, error);
        [self copyAddressBook:addressBook];
    } else {
        dispatch_async(dispatch_get_main_queue(), ^{
            // 更新界面
            [hud turnToError:@"沒有獲取通訊錄權限"];
        });
    }
}

這段代碼覆蓋了三種授權狀態:尚未決定(主動向用戶請求)、已授權(直接讀取)、以及被拒絕(提示用戶)。記得在 Info.plist 中配置 NSContactsUsageDescription 這類用途說明,否則請求授權時 App 會直接崩潰。

接著遍歷每個聯繫人,把字段讀出來。建議自己定義一個 model 來存,而不是到處傳 ABRecordRef:

- (void)copyAddressBook:(ABAddressBookRef)addressBook {
    CFIndex numberOfPeople = ABAddressBookGetPersonCount(addressBook);
    CFArrayRef people = ABAddressBookCopyArrayOfAllPeople(addressBook);
    for (int i = 0; i < numberOfPeople; i++) {
        ABRecordRef person = CFArrayGetValueAtIndex(people, i);

        // 單值字段
        NSString *firstName = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonFirstNameProperty));
        NSString *lastName = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonLastNameProperty));
        NSString *middleName = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonMiddleNameProperty));
        NSString *prefix = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonPrefixProperty));
        NSString *suffix = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonSuffixProperty));
        NSString *nickname = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonNicknameProperty));

        // 拼音音標
        NSString *firstNamePhonetic = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonFirstNamePhoneticProperty));
        NSString *lastNamePhonetic = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonLastNamePhoneticProperty));
        NSString *middleNamePhonetic = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonMiddleNamePhoneticProperty));

        // 組織信息
        NSString *organization = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonOrganizationProperty));
        NSString *jobTitle = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonJobTitleProperty));
        NSString *department = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonDepartmentProperty));

        NSDate *birthday = (__bridge NSDate *)(ABRecordCopyValue(person, kABPersonBirthdayProperty));
        NSString *note = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonNoteProperty));
        NSString *firstKnow = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonCreationDateProperty));
        NSString *lastKnow = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonModificationDateProperty));

        // 郵箱(多值)
        ABMultiValueRef email = ABRecordCopyValue(person, kABPersonEmailProperty);
        int emailCount = ABMultiValueGetCount(email);
        for (int x = 0; x < emailCount; x++) {
            NSString *emailLabel = (__bridge NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(email, x));
            NSString *emailContent = (__bridge NSString *)ABMultiValueCopyValueAtIndex(email, x);
        }

        // 地址(多值,每項是字典)
        ABMultiValueRef address = ABRecordCopyValue(person, kABPersonAddressProperty);
        int addressCount = ABMultiValueGetCount(address);
        for (int j = 0; j < addressCount; j++) {
            NSString *addressLabel = (__bridge NSString *)ABMultiValueCopyLabelAtIndex(address, j);
            NSDictionary *personAddress = (__bridge NSDictionary *)ABMultiValueCopyValueAtIndex(address, j);
            NSString *country = [personAddress valueForKey:(NSString *)kABPersonAddressCountryKey];
            NSString *city = [personAddress valueForKey:(NSString *)kABPersonAddressCityKey];
            NSString *state = [personAddress valueForKey:(NSString *)kABPersonAddressStateKey];
            NSString *street = [personAddress valueForKey:(NSString *)kABPersonAddressStreetKey];
            NSString *zip = [personAddress valueForKey:(NSString *)kABPersonAddressZIPKey];
            NSString *countryCode = [personAddress valueForKey:(NSString *)kABPersonAddressCountryCodeKey];
        }

        // 日期(多值,如週年紀念)
        ABMultiValueRef dates = ABRecordCopyValue(person, kABPersonDateProperty);
        int datesCount = ABMultiValueGetCount(dates);
        for (int y = 0; y < datesCount; y++) {
            NSString *datesLabel = (__bridge NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(dates, y));
            NSString *datesContent = (__bridge NSString *)ABMultiValueCopyValueAtIndex(dates, y);
        }

        // 類型:個人 or 公司
        CFNumberRef recordType = ABRecordCopyValue(person, kABPersonKindProperty);
        if (recordType == kABPersonKindOrganization) {
            NSLog(@"it's a company");
        } else {
            NSLog(@"it's a person, resource, or room");
        }

        // 即時通訊賬號(多值)
        ABMultiValueRef instantMessage = ABRecordCopyValue(person, kABPersonInstantMessageProperty);
        for (int l = 0; l < ABMultiValueGetCount(instantMessage); l++) {
            NSString *imLabel = (__bridge NSString *)ABMultiValueCopyLabelAtIndex(instantMessage, l);
            NSDictionary *imContent = (__bridge NSDictionary *)ABMultiValueCopyValueAtIndex(instantMessage, l);
            NSString *username = [imContent valueForKey:(NSString *)kABPersonInstantMessageUsernameKey];
            NSString *service = [imContent valueForKey:(NSString *)kABPersonInstantMessageServiceKey];
        }

        // 電話(多值)
        ABMultiValueRef phone = ABRecordCopyValue(person, kABPersonPhoneProperty);
        for (int k = 0; k < ABMultiValueGetCount(phone); k++) {
            NSString *phoneLabel = (__bridge NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(phone, k));
            NSString *phoneNumber = (__bridge NSString *)ABMultiValueCopyValueAtIndex(phone, k);
        }

        // 網址(多值)
        ABMultiValueRef url = ABRecordCopyValue(person, kABPersonURLProperty);
        for (int m = 0; m < ABMultiValueGetCount(url); m++) {
            NSString *urlLabel = (__bridge NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(url, m));
            NSString *urlContent = (__bridge NSString *)ABMultiValueCopyValueAtIndex(url, m);
        }

        // 頭像
        NSData *image = (__bridge NSData *)ABPersonCopyImageData(person);
    }
}

讀取通訊錄時,實務上最容易踩的三個坑:

  1. 性能:通訊錄动辄上千條,同步遍歷加上頭像解碼很容易卡住主線程。應該放到後台隊列處理,只把結果回主線程刷新界面,並對結果做緩存。
  2. 內存:示例中每個 ABRecordCopyValue 返回的對象都由 Core Foundation 持有所有權,正式代碼裡應逐一 CFRelease,或統一用 ARC 橋接管理,避免大量重複讀取時內存持續攀升。
  3. API 選型:ABAddressBook 這套 C API 從 iOS 9 起已被 Contacts 框架(CNContactStore、CNContact)取代。新項目應直接採用 Contacts 框架,接口更清晰、內存管理也更友好;只有在需要兼容 iOS 8 及更早系統時,才需要繼續使用這套 AddressBook API。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved