当前位置：首页 > 行业动态 > 正文

如何读取Android手机通信录？

admin
行业动态
2025-03-07
1

在Android中，可使用 ContentResolver查询 ContactsContract.CommonDataKinds.Phone来读取通信录。

在Android开发中，读取通信录是一个常见的需求，以下是关于如何实现这一功能的详细步骤和代码示例：

一、申请权限

1、添加权限到AndroidManifest.xml

权限	描述
	允许应用读取设备上的联系人数据。

2、动态请求权限（针对Android 6.0及以上版本）

在活动中检查权限是否已经被授予。

如果未授予，向用户请求权限。

处理用户的响应（允许或拒绝）。

二、读取通信录数据

1、获取ContentResolver实例

使用getContentResolver()方法获取当前活动的ContentResolver实例。

2、查询联系人数据

使用query()方法查询联系人数据，你会查询ContactsContract.CommonDataKinds.Phone.CONTENT_URI来获取电话号码和其他相关信息。

构建一个Uri对象来指定要查询的联系人数据类型（如电话、邮箱等）。

创建一个包含查询条件的Bundle对象（可选）。

定义一个字符串数组来指定要返回的列（如姓名、电话号码等）。

定义排序顺序（可选）。

执行查询并获取结果。

3、处理查询结果

使用moveToFirst()方法移动到第一行数据。

使用getString()或其他适当的方法从每一列中提取数据。

遍历所有行以读取所有联系人数据。

三、显示或处理联系人数据

1、更新UI

根据读取到的联系人数据更新UI元素（如列表视图、文本框等）。

确保在主线程上进行UI更新以避免并发问题。

2、其他处理

根据需要对读取到的数据进行进一步处理或存储。

四、完整代码示例

以下是一个简化的代码示例，展示了如何在Android活动中读取并显示联系人姓名和电话号码：

import android.Manifest;
import android.content.ContentResolver;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import java.util.ArrayList;
import java.util.List;
public class MainActivity extends AppCompatActivity {
    private static final int PERMISSIONS_REQUEST_READ_CONTACTS = 100;
    private ListView listView;
    private ArrayAdapter<String> adapter;
    private List<String> contactsList = new ArrayList<>();
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        listView = findViewById(R.id.listView);
        adapter = new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, contactsList);
        listView.setAdapter(adapter);
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_CONTACTS}, PERMISSIONS_REQUEST_READ_CONTACTS);
        } else {
            readContacts();
        }
    }
    private void readContacts() {
        ContentResolver contentResolver = getContentResolver();
        Uri uri = ContactsContract.CommonDataKinds.Phone.CONTENT_URI;
        Cursor cursor = contentResolver.query(uri, null, null, null, null);
        if (cursor != null && cursor.getCount() > 0) {
            while (cursor.moveToNext()) {
                String name = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
                String phoneNumber = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
                contactsList.add(name + " " + phoneNumber);
            }
            cursor.close();
        }
        adapter.notifyDataSetChanged();
    }
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == PERMISSIONS_REQUEST_READ_CONTACTS) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                readContacts();
            } else {
                // Permission denied, disable the functionality that depends on this permission.
            }
        }
    }
}