Swift - 访问通讯录联系人(使用纯代码实现)
注意:自 iOS9 起,AddressBook 框架已废弃使用。建议采用 Contacts 框架作为替代。相关文章如下:
1,通讯录访问介绍
1,通讯录访问介绍
通讯录(或叫地址簿,电话簿)是一个数据库,里面储存了联系人的相关信息。要实现访问通讯录有如下两种方式:
(1)AddressBook.framework框架 : 没有界面,通过代码来获取所有联系人信息(本文样例使用此方式)
(2)AddressBookUI.framework框架 : 通过系统提供的通讯录交互界面来访问
2,联系人记录的属性
在一条联系人记录中,有很多属性,而这些属性又分为单值属性和多值属性。
(1)单值属性是只有一个值的属性:
kABPersonLastNameProperty :姓
kABPersonFirstNameProperty :名
kABPersonMiddleNameProperty :中间名
kABPersonPrefixProperty :前缀
kABPersonSuffixProperty :后缀
kABPersonLastNamePhoneticProperty :姓氏汉语拼音或音标
kABPersonFirstNamePhoneticProperty :名字汉语拼音或音标
kABPersonNicknameProperty :昵称
kABPersonOrganizationProperty :公司(组织)
kABPersonJobTitleProperty :职位
kABPersonDepartmentProperty :部门
kABPersonNoteProperty :备注
(2)多值属性是包含多个值的集合类型:
kABPersonPhoneProperty :电话
kABPersonEmailProperty :Email
kABPersonAddressProperty :地址
kABPersonURLProperty : URL属性
kABPersonDateProperty :纪念日
kABPersonInstantMessageProperty :获取即时通讯(IM)
kABPersonSocialProfileProperty :社交账号
kABPersonRelatedNamesProperty :亲属关系人
3,多值属性标签的本地名称
在多值属性中包含了label(标签)、value(值)和ID等部分,其中标签和值都是可以重复的,而ID是不能重复的。
对于标签,我们可以使用ABAddressBookCopyLocalizedLabel()方法转为本地标签名(即能看得懂的标签名,比如work、home)。要不然打印出来的是_$!<Home>!$_,_$!<Work>!$_这样的数据。
4,下面样例使用代码遍历所有的联系人,并打印输出相关属性
import UIKit import AddressBook import AddressBookUI class ViewController: UIViewController { //address Book对象,用来获取电话簿句柄 var addressBook:ABAddressBookRef? override func viewDidLoad() { super.viewDidLoad() //定义一个错误标记对象,判断是否成功 var error:Unmanaged<CFErrorRef>? addressBook = ABAddressBookCreateWithOptions(nil, &error).takeRetainedValue() //发出授权信息 let sysAddressBookStatus = ABAddressBookGetAuthorizationStatus() if (sysAddressBookStatus == ABAuthorizationStatus.NotDetermined) { println("requesting access...") var errorRef:Unmanaged<CFError>? = nil //addressBook = extractABAddressBookRef(ABAddressBookCreateWithOptions(nil, &errorRef)) ABAddressBookRequestAccessWithCompletion(addressBook, { success, error in if success { //获取并遍历所有联系人记录 self.readRecords(); } else { println("error") } }) } else if (sysAddressBookStatus == ABAuthorizationStatus.Denied || sysAddressBookStatus == ABAuthorizationStatus.Restricted) { println("access denied") } else if (sysAddressBookStatus == ABAuthorizationStatus.Authorized) { println("access granted") //获取并遍历所有联系人记录 self.readRecords(); } } //获取并遍历所有联系人记录 func readRecords(){ var sysContacts:NSArray = ABAddressBookCopyArrayOfAllPeople(addressBook) .takeRetainedValue() as NSArray for contact in sysContacts { //获取姓 var lastName = ABRecordCopyValue(contact, kABPersonLastNameProperty)? .takeRetainedValue() as! String? ?? "" println("姓:\(lastName)") //获取名 var firstName = ABRecordCopyValue(contact, kABPersonFirstNameProperty)? .takeRetainedValue() as! String? ?? "" println("名:\(firstName)") //昵称 var nikeName = ABRecordCopyValue(contact, kABPersonNicknameProperty)? .takeRetainedValue() as! String? ?? "" println("昵称:\(nikeName)") //公司(组织) var organization = ABRecordCopyValue(contact, kABPersonOrganizationProperty)? .takeRetainedValue() as! String? ?? "" println("公司(组织):\(organization)") //职位 var jobTitle = ABRecordCopyValue(contact, kABPersonJobTitleProperty)? .takeRetainedValue() as! String? ?? "" println("职位:\(jobTitle)") //部门 var department = ABRecordCopyValue(contact, kABPersonDepartmentProperty)? .takeRetainedValue() as! String? ?? "" println("部门:\(department)") //备注 var note = ABRecordCopyValue(contact, kABPersonNoteProperty)? .takeRetainedValue() as! String? ?? "" println("备注:\(note)") //获取电话 var phoneValues:ABMutableMultiValueRef? = ABRecordCopyValue(contact, kABPersonPhoneProperty).takeRetainedValue() if phoneValues != nil { println("电话:") for i in 0 ..< ABMultiValueGetCount(phoneValues){ // 获得标签名 var phoneLabel = ABMultiValueCopyLabelAtIndex(phoneValues, i).takeRetainedValue() as CFStringRef; // 转为本地标签名(能看得懂的标签名,比如work、home) var localizedPhoneLabel = ABAddressBookCopyLocalizedLabel(phoneLabel) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(phoneValues, i) var phone = value.takeRetainedValue() as! String println(" \(localizedPhoneLabel):\(phone)") } } //获取Email var emailValues:ABMutableMultiValueRef? = ABRecordCopyValue(contact, kABPersonEmailProperty).takeRetainedValue() if emailValues != nil { println("Email:") for i in 0 ..< ABMultiValueGetCount(emailValues){ // 获得标签名 var label = ABMultiValueCopyLabelAtIndex(emailValues, i).takeRetainedValue() as CFStringRef; var localizedLabel = ABAddressBookCopyLocalizedLabel(label) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(emailValues, i) var email = value.takeRetainedValue() as! String println(" \(localizedLabel):\(email)") } } //获取地址 var addressValues:ABMutableMultiValueRef? = ABRecordCopyValue(contact, kABPersonAddressProperty).takeRetainedValue() if addressValues != nil { println("地址:") for i in 0 ..< ABMultiValueGetCount(addressValues){ // 获得标签名 var label = ABMultiValueCopyLabelAtIndex(addressValues, i).takeRetainedValue() as CFStringRef; var localizedLabel = ABAddressBookCopyLocalizedLabel(label) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(addressValues, i) var addrNSDict:NSMutableDictionary = value.takeRetainedValue() as! NSMutableDictionary var country:String = addrNSDict.valueForKey(kABPersonAddressCountryKey as String) as? String ?? "" var state:String = addrNSDict.valueForKey(kABPersonAddressStateKey as String) as? String ?? "" var city:String = addrNSDict.valueForKey(kABPersonAddressCityKey as String) as? String ?? "" var street:String = addrNSDict.valueForKey(kABPersonAddressStreetKey as String) as? String ?? "" var contryCode:String = addrNSDict .valueForKey(kABPersonAddressCountryCodeKey as String) as? String ?? "" print(" \(localizedLabel): Contry:\(country) State:\(state) ") println("City:\(city) Street:\(street) ContryCode:\(contryCode) ") } } //获取纪念日 var dateValues:ABMutableMultiValueRef? = ABRecordCopyValue(contact, kABPersonDateProperty).takeRetainedValue() if dateValues != nil { println("纪念日:") for i in 0 ..< ABMultiValueGetCount(dateValues){ // 获得标签名 var label = ABMultiValueCopyLabelAtIndex(emailValues, i).takeRetainedValue() as CFStringRef; var localizedLabel = ABAddressBookCopyLocalizedLabel(label) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(dateValues, i) var date = (value.takeRetainedValue() as? NSDate)?.description ?? "" println(" \(localizedLabel):\(date)") } } //获取即时通讯(IM) var imValues:ABMutableMultiValueRef? = ABRecordCopyValue(contact, kABPersonInstantMessageProperty).takeRetainedValue() if imValues != nil { println("即时通讯(IM):") for i in 0 ..< ABMultiValueGetCount(imValues){ // 获得标签名 var label = ABMultiValueCopyLabelAtIndex(imValues, i).takeRetainedValue() as CFStringRef; var localizedLabel = ABAddressBookCopyLocalizedLabel(label) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(imValues, i) var imNSDict:NSMutableDictionary = value.takeRetainedValue() as! NSMutableDictionary var serves:String = imNSDict .valueForKey(kABPersonInstantMessageServiceKey as String) as? String ?? "" var userName:String = imNSDict .valueForKey(kABPersonInstantMessageUsernameKey as String) as? String ?? "" println(" \(localizedLabel): Serves:\(serves) UserName:\(userName)") } } } } override func didReceiveMemoryWarning() { super.didReceiveMemoryWarning() } }
很详细,谢谢分享~