通讯录开发主要是获取用户手机中的联系人,进而可以在应用中添加好友
一 .如何访问通讯录
(1)在iOS9之前,有两个框架可以访问用户的通讯录
AddressBookUI.framework: 提供了联系人列表界面,联系人详情界面,添加练习人界面等,一般用于选择联系人
AddressBook.framework: 纯C语言的API,仅仅是获的联系人数据,没有提供UI界面展示,需要自己搭建联系人展示界面,里面的数据类型大部分基于Core Foundation框架，使用起来极其蛋疼
(2)在iOS9开始,也有两个框架可以访问用户的通讯录
ContactsUI.framework: 对应AddressBookUI.framework
Contacts.framework: 对应AddressBook.framework
二.代码演示
(1)AddressBookUI的使用
使用步骤
1)创建选择联系人控制器
2)设置代理
3)实现代理方法(在代理方法中拿到用户选择的联系人)
4)弹出控制器
代码如下:
import UIKit import AddressBookUI class ViewController: UIViewController { override func viewDidLoad() { super.viewDidLoad() } override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) { // 1.创建联系人选择的控制器 let ppnc = ABPeoplePickerNavigationController() // 2.设置代理 ppnc.peoplePickerDelegate = self // 3.弹出控制器 present(ppnc, animated: true, completion: nil) } } extension ViewController : ABPeoplePickerNavigationControllerDelegate { // 用户选中了某一个联系人 func peoplePickerNavigationController(_ peoplePicker: ABPeoplePickerNavigationController, didSelectPerson person: ABRecord) { // 1.获取联系人的姓名 /* Unmanaged<CFTypeRef>? : 非托管对象 * 在Swift和C语言进行混编的过程中,产生的一个临时对象,真正使用的时候需要将非托管对象,转成真正的对象才能进行使用 * takeUnretainedValue : 表示在转化的过程中,不会对对象进行一次retain操作 * takeRetainedValue : 表示在转化的过程中,有对对象进行一次retain操作 注意:一旦使用takeRetainedValue,那么必须对之前的非托管对象进行一次release(),否则就会产生内存泄漏 let UnManageObjc = ABRecordCopyValue(person, kABPersonLastNameProperty) let lastname = UnManageObjc?.takeRetainedValue() as? String UnManageObjc?.release() */ guard let lastname = ABRecordCopyValue(person, kABPersonLastNameProperty).takeUnretainedValue() as? String else { return } guard let firstname = ABRecordCopyValue(person, kABPersonFirstNameProperty).takeUnretainedValue() as? String else { return } print("姓名:\(firstname) \(lastname)") // 2.获取联系人的电话号码 // ABMultiValue 类似于一个字典,里面有key/value // 2.1.从person中拷贝出来所有的电话号码 let phones = ABRecordCopyValue(person, kABPersonPhoneProperty).takeUnretainedValue() as ABMultiValue // 2.2.遍历ABMultiValue中的所有电话 // guard let count = phones.count else { return } 错误写法 let count = ABMultiValueGetCount(phones) for i in 0..<count { let phoneLabel = ABMultiValueCopyLabelAtIndex(phones, i).takeUnretainedValue() as String guard let phoneValue = ABMultiValueCopyValueAtIndex(phones, i).takeUnretainedValue() as? String else { continue } print("phoneLabel:\(phoneLabel) phoneValue:\(phoneValue)") } } }
注意: 这里有一种对象 :Unmanaged<CFTypeRef>? : 非托管对象,这种对象是在Swift和C语言进行混编的过程中,出现的.需要用takeUnretainedValue() 或者 takeRetainedValue()进行转化.
运行结果如下图:
(2)AddressBook的使用
1)获取用户的授权
获取授权状态
如果用户是未决定状态,则请求授权
2)获取联系人信息
获取授权状态
如果是已经授权,则获取联系人信息
创建通讯录对象
获取通信录中所有的联系人
遍历所有的联系人,获取联系人信息
获取用户授权的代码实现,通常在应用启动时就询问用户授权
AppDelegate中代码如下所示:
import UIKit import AddressBook @UIApplicationMain class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool { // 1.获取用户的授权状态 let status = ABAddressBookGetAuthorizationStatus() // 2.判断授权状态是否未决定 if status == .notDetermined { // 2.1.创建通信录对象 let addressBook = ABAddressBookCreate().takeUnretainedValue() // 2.2.请求授权 ABAddressBookRequestAccessWithCompletion(addressBook, { (isFlag : Bool, error : CFError?) in if isFlag { print("授权成功") } else { print("授权失败") } }) } return true } }
ViewController中代码如下所示:
import UIKit import AddressBook class ViewController: UIViewController { override func viewDidLoad() { super.viewDidLoad() } override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) { // 1.获取用户授权状态 let status = ABAddressBookGetAuthorizationStatus() // 2.判断是否是已经授权 guard status == .authorized else { return } // 3.创建通信录对象 let addressBook = ABAddressBookCreate().takeUnretainedValue() // 4.从对象中,拷贝出来所有的联系人 let peopleArray = ABAddressBookCopyArrayOfAllPeople(addressBook).takeUnretainedValue() // 5.遍历数组,获取每一个联系人 let count = CFArrayGetCount(peopleArray) for i in 0..<count { // 5.1.获取指针 let pointer = CFArrayGetValueAtIndex(peopleArray, i) // 5.2.获取指针指向的对象 // unsafeBitCast : 将指针转成某一个对象 let person = unsafeBitCast(pointer, to: ABRecord.self) // 5.3.获取该联系人的姓名 guard let lastname = ABRecordCopyValue(person, kABPersonLastNameProperty).takeUnretainedValue() as? String else { continue } guard let firstname = ABRecordCopyValue(person, kABPersonFirstNameProperty).takeUnretainedValue() as? String else { continue } print("姓名:\(firstname) \(lastname)") // 5.4.获取电话号码 let phones = ABRecordCopyValue(person, kABPersonPhoneProperty).takeUnretainedValue() as ABMultiValue let phoneCount = ABMultiValueGetCount(phones) for i in 0..<phoneCount { // let phoneLabel = ABMultiValueCopyLabelAtIndex(phones, i).takeUnretainedValue() as String guard let phoneValue = ABMultiValueCopyValueAtIndex(phones, i).takeUnretainedValue() as? String else { continue } print(phoneValue) } } } }
注意: 由于需要访问请求授权,需要在info.plist配置NSContactsUsageDescription这个key
(3)ContactsUI的使用
1)使用步骤
创建选择联系人控制器
设置代理
实现代理方法(在代理中拿到用户选择的联系人)
弹出控制器
2)代码实现
import UIKit import ContactsUI class ViewController: UIViewController { override func viewDidLoad() { super.viewDidLoad() } override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) { // 1.创建联系人选择的控制器 let cpvc = CNContactPickerViewController() // 2.设置代理 cpvc.delegate = self // 3.弹出控制器 present(cpvc, animated: true, completion: nil) } } extension ViewController : CNContactPickerDelegate { func contactPicker(_ picker: CNContactPickerViewController, didSelect contact: CNContact) { // 1.获取用户的姓名 // lastname --> familyName // firstname --> givenname let lastname = contact.familyName let firstname = contact.givenName print("姓名:\(firstname) \(lastname)") // 2.获取用户电话号码(ABMultivalue) let phones = contact.phoneNumbers for phone in phones { let phoneLabel = phone.label let phoneValue = phone.value.stringValue print("phoneLabel:\(phoneLabel). phoneValue:\(phoneValue)") } } }
输出结果和AddressBookUI.framework中的输出结果类似
4)Contacts
1)获取用户的授权
获取授权状态
如果用户是未决定状态,则请求授权
2)获取联系人信息
获取授权状态
如果是已经授权,则获取联系人信息
创建通讯录对象
获取通信录中所有的联系人
遍历所有的联系人,获取联系人信息
获取用户授权的代码实现,通常在应用启动时就询问用户授权,请求授权需要在info.plist配置NSContactsUsageDescription这个key
AppDelegate代码如下所示:
import UIKit import Contacts @UIApplicationMain class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool { // 1.获取授权状态 // CNContactStore --> 通信录对象 let status = CNContactStore.authorizationStatus(for: .contacts) // 2.判断如果是未决定状态,请求授权 if status == .notDetermined { // 2.1.创建通信录对象 let store = CNContactStore() // 2.2.请求授权 store.requestAccess(for: .contacts, completionHandler: { (isFlag : Bool, error : Error?) in if isFlag { print("授权成功") } else { print("授权失败") } }) } return true } }
ViewController中代码如下:
import UIKit import Contacts class ViewController: UIViewController { override func viewDidLoad() { super.viewDidLoad() } override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) { // 1.获取授权状态 let status = CNContactStore.authorizationStatus(for: .contacts) // 2.判断是否是已经授权 guard status == .authorized else { return } // 3.创建通信录对象 let store = CNContactStore() // 4.从通信录中获取所有的联系人 // 4.1.获取fetch,并且指定之后要获取联系人中的什么属性 let keys = [CNContactFamilyNameKey as NSString, CNContactGivenNameKey as NSString, CNContactPhoneNumbersKey as NSString] // 4.2.创建请求对象 let request = CNContactFetchRequest(keysToFetch: keys) // 4.3.遍历所有的联系人 do { try store.enumerateContacts(with: request, usingBlock: { (contact : CNContact, stop : UnsafeMutablePointer<ObjCBool>) -> Void in // 1.获取姓名 let lastname = contact.familyName let firstname = contact.givenName print(lastname, firstname) // 2.获取电话号码 let phoneNumers = contact.phoneNumbers for phone in phoneNumers { print(phone.label ?? "没有Label") print(phone.value.stringValue) } }) } catch { print(error) } } }
368
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
