Android快速获取本机通讯录联系人

2023-11-27 06:29:37

如何利用 ContentProvider 轻松访问 Android 通讯录联系人

在 Android 应用程序中，获取设备通讯录联系人至关重要，可用于拨打电话、发送短信或创建地址簿。本文将深入探讨使用 Android ContentProvider API 高效获取本机通讯录联系人的方法。

请求访问权限

在访问通讯录联系人之前，必须在 AndroidManifest.xml 文件中添加权限声明，以请求读取联系人权限：

<uses-permission android:name="android.permission.READ_CONTACTS" />

利用 ContentProvider 查询联系人

Android 提供了 ContentProvider API，可便捷访问系统数据，包括联系人。以下是使用 ContentProvider 查询联系人的步骤：

创建 ContentResolver 实例： 此实例用于访问 ContentProvider。
构建联系人 URI： 联系人数据的 URI 为 content://contacts/people。
查询联系人： 使用 ContentResolver.query() 方法查询联系人数据，指定联系人 URI 和要返回的列。
解析查询结果： 使用 Cursor 对象解析查询结果，获取所需信息，如联系人姓名、电话号码和电子邮件地址。

代码示例：查询联系人

val contentResolver = contentResolver
val contactUri = ContactsContract.Contacts.CONTENT_URI

val projection = arrayOf(
    ContactsContract.Contacts._ID,
    ContactsContract.Contacts.DISPLAY_NAME,
    ContactsContract.Contacts.HAS_PHONE_NUMBER
)

val cursor = contentResolver.query(contactUri, projection, null, null, null)

while (cursor.moveToNext()) {
    val id = cursor.getLong(cursor.getColumnIndex(ContactsContract.Contacts._ID))
    val name = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME))
    val hasPhoneNumber = cursor.getInt(cursor.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER))
}

cursor.close()