Iphone AddressBook Framework - 人物属性

Posted 2023-03-06

【中文标题】Iphone AddressBook Framework - 人物属性

【英文标题】：Iphone AddressBook Framework - Person attributes

【发布时间】：2012-10-07 16:31:25

【问题描述】：

我正在尝试找出 iPhone 通讯录中完整的“个人记录”默认具有哪些属性。

它必须隐藏在 API 中的某个地方

https://developer.apple.com/library/content/documentation/ContactData/Conceptual/AddressBookProgrammingGuideforiPhone/Introduction.html#//apple_ref/doc/uid/TP40007744

https://developer.apple.com/documentation/addressbook#//apple_ref/doc/uid/TP40007210

但到目前为止我还没有找到清单。

是否有人列出了属性列表：姓名、姓名、电子邮件、电话和可能的“隐藏”字段，例如已创建条目

【问题讨论】：

列表位于developer.apple.com/documentation/addressbook/…

【参考方案1】：

NSAutoreleasePool* pool  = [[NSAutoreleasePool alloc] init];

ABAddressBookRef addressBook = ABAddressBookCreate();

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

for (id persion in array) 

    ABRecordRef record = (ABRecordRef)persion;

    NSString* firstName=(NSString *)ABRecordCopyValue(record, kABPersonFirstNameProperty);
    NSString* lastName=(NSString *)ABRecordCopyValue(record, kABPersonLastNameProperty);

    //do something

    [firstName release];
    [lastName release];


    ABMultiValueRef mulPhone = (ABMultiValueRef) ABRecordCopyValue(record, kABPersonPhoneProperty) ;
    int count = ABMultiValueGetCount(mulPhone);
    for(CFIndex i=0 ; i < count ; i++)
    
        NSString* phoneLabel = (NSString*) ABMultiValueCopyLabelAtIndex(mulPhone, i) ;        
        NSString* cellPhone =(NSString*) ABMultiValueCopyValueAtIndex(mulPhone, i) ;

        //do something

        [phoneLabel release] ;
        [cellPhone release];
    
    CFRelease(mulPhone) ;


    ABMultiValueRef mulAddress =(ABMultiValueRef) ABRecordCopyValue(record, kABPersonAddressProperty) ;
    count = ABMultiValueGetCount(mulAddress);
    for(CFIndex i=0 ; i< count ; i++)
    
        NSString* addressLabel = (NSString*) ABMultiValueCopyLabelAtIndex(mulAddress, i) ;

        CFDictionaryRef dict = (CFDictionaryRef)ABMultiValueCopyValueAtIndex(mulAddress, i);

        NSString* homeStreet  = (NSString*)CFDictionaryGetValue(dict, kABPersonAddressStreetKey);
        NSString* homeCity    = (NSString*)CFDictionaryGetValue(dict, kABPersonAddressCityKey);
        NSString* homeCountry = (NSString*)CFDictionaryGetValue(dict, kABPersonAddressCountryKey);

       //do something
        CFRelease(dict) ;

        [addressLabel release];
    
    CFRelease(mulAddress) ;



    NSString* company  = (NSString*)ABRecordCopyValue(record, kABPersonOrganizationProperty);
    if (company) 
 //do something
    
    [company release];



    ABMultiValueRef mulEmail = (ABMultiValueRef)ABRecordCopyValue(record, kABPersonEmailProperty) ;
    count = ABMultiValueGetCount(mulEmail);
    for(CFIndex i=0 ; i<  count; i++)
    
        NSString* emailLabel = (NSString*)ABMultiValueCopyLabelAtIndex(mulEmail, i) ;
        NSString* email = (NSString*) ABMultiValueCopyValueAtIndex(mulEmail, i) ;

        //do something
        [emailLabel release];
        [email release];


    
    CFRelease(mulEmail) ;



[array release];
CFRelease(addressBook);


[pool release];

【讨论】：

thx，没有创建条目的时间这样的属性吗？

查看 ABPerson 的 kABPersonCreationDateProperty 和 kABPersonModificationDateProperty

从 ios 10 开始，此答案中使用的许多键不再存在。

【参考方案2】：

Person 的默认属性：https://developer.apple.com/documentation/addressbook/address_book_objective_c_constants/default_person_properties

kABFirstNameProperty：名字。

kABLastNameProperty：姓氏。

kABFirstNamePhoneticProperty：名字的拼音表示。

kABLastNamePhoneticProperty：姓氏的语音表示。

kABNicknameProperty：昵称。

kABMaidenNameProperty：娘家姓。

kABBirthdayProperty：出生日期。

kABBirthdayComponentsProperty：作为日期组件的出生日期。

kABOrganizationProperty：公司名称。

kABJobTitleProperty：职位。

kABHomePageProperty：主页。

kABURLsProperty：网页。

kABCalendarURIsProperty：日历 URI。

kABEmailProperty：电子邮件地址。

kABAddressProperty：街道地址。

kABOtherDatesProperty：与人关联的日期。

kABOtherDateComponentsProperty：与人关联的日期，作为日期组件。

kABRelatedNamesProperty：与某个人相关的人的姓名。

kABDepartmentProperty：部门名称。

kABPersonFlags：指定地址簿应用程序中记录的名称排序和配置的属性。见Person Flags。

kABhoneProperty：通用电话号码。

kABInstantMessageProperty：即时消息 ID。

kABNoteProperty：备注。

kABSocialProfileProperty：社交网络配置文件。

kABMiddleNameProperty：中间名。

kABMiddleNamePhoneticProperty：中间名的拼音表示。

kABTitleProperty：头衔，例如“先生”、“夫人”、“将军”、“红衣主教”或“勋爵”。

kABSuffixProperty：后缀，例如“Sr.”、“Jr.”、“III.”或“Esq.”

而且由于 Person 是一个 Record，它也有：https://developer.apple.com/documentation/addressbook/address_book_objective_c_constants/default_record_properties

kABUIDProperty：此记录的唯一 ID。无论记录发生多少变化，它都保证永远不会改变。如果您需要存储对记录的引用，请使用此值。

kABCreationDateProperty：首次保存记录的日期。

kABModificationDateProperty：上次保存记录的日期。

注意，properties() 应该返回一个 Person 的所有属性的列表。