Contacts(CNContactStore)

最新推荐文章于 2025-03-18 12:26:53 发布

原创最新推荐文章于 2025-03-18 12:26:53 发布 · 3.3k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#通讯录

Contacts 专栏收录该内容

7 篇文章

订阅专栏

本文介绍了CNContactStore在iOS设备上用于存储、查询、修改和增加用户联系人数据的功能。包括如何通过唯一标识符获取联系人、权限认证流程以及联系人分组和容器的管理。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

CNContactStore主要用于沟通用户存储联系人的数据仓库，通过它可以对用户通讯录中的联系人进行查询、修改、增加等操作。

1 Fetching Unified Contacts

/// 获取联系人
///
/// - parameter predicate: NSPredicate
/// - parameter keys: [CNKeyDescriptor]
///
/// - returns: void
public func unifiedContactsMatchingPredicate(predicate: NSPredicate, keysToFetch keys: [CNKeyDescriptor]) throws -> [CNContact]

/// 通过唯一标示符获取联系人
///
/// - parameter identifier : String
/// - parameter keys: 要获取相关内容
///
/// - returns: void
public func unifiedContactWithIdentifier(identifier: String, keysToFetch keys: [CNKeyDescriptor]) throws -> CNContact

2 Privacy Access

/// 用户认证的权限
///
/// - parameter entityType: CNEntityType.Contacts
///
/// - returns: CNAuthorizationStatus
public class func authorizationStatusForEntityType(entityType: CNEntityType) -> CNAuthorizationStatus

/// 权限认证
///
/// - parameter entityType: CNEntityType.Contacts
/// - parameter completionHandler: 闭包回调认证结果
///
/// - returns: void
public func requestAccessForEntityType(entityType: CNEntityType, completionHandler: (Bool, NSError?) -> Void)

3 Fetching and Saving

/// 闭包获取联系人
///
/// - parameter fetchRequest : CNContactFetchRequest查询条件
/// - parameter block : 闭包输出
///
/// - returns: void
public func enumerateContactsWithFetchRequest(fetchRequest: CNContactFetchRequest, usingBlock block: (CNContact, UnsafeMutablePointer<ObjCBool>) -> Void) throws

/// 获取分组
///
/// - parameter predicate : NSPredicate?
///
/// - returns : [CNGroup]
public func groupsMatchingPredicate(predicate: NSPredicate?) throws -> [CNGroup]

/// 获取容器
///
/// - parameter predicate : NSPredicate?
///
/// - returns : [CNContainer]
public func containersMatchingPredicate(predicate: NSPredicate?) throws -> [CNContainer]

/// 保存联系人
///
/// - parameter saveRequest : CNSaveRequest联系人修改记录
///
/// - returns: void
public func executeSaveRequest(saveRequest: CNSaveRequest) throws

/// 获取容器唯一标示符
///
/// - returns : String
public func defaultContainerIdentifier() -> String