从 Intent.ACTION_PICK 返回的 URI 中获取特定的联系信息

Question

我正在编写一个 Android 应用，它的数据类型代表一个人（特别是孩子的父母或监护人）。我希望能够从 Android 设备的联系人数据库中“导入”相关数据字段。 （这应该是可选的；也就是说，不需要父母/监护人已经在联系人数据库中，如果他们添加新的父母/监护人，联系人数据库也不会更新。）

到目前为止，我已经编写了代码来启动一个新的 Intent 来选择特定的联系人（使用 Intent.ACTION_PICK）。然后我得到一个代表数据库中特定联系人的 URI。

很遗憾，我不知道下一步是什么。看起来这应该是世界上最简单的事情，但显然不是。我已经阅读了 Android 开发者网站上的文档，并且阅读了不止一本 Android 书籍。不开心。

我想得到的具体信息是：

1. 联系人的姓名（如果可能，名字和姓氏分开）

2. 联系人的（主要）电子邮件地址

3. 联系人的手机号码

我想这应该可以通过使用 ContentResolver 进行查询来实现，但我不知道如何使用从 Intent 返回的 URI。大多数文档都假定您拥有联系人 ID，而不是联系人的 URI。此外，我不知道我可以将什么样的字段放入查询的投影中，假设这甚至是做我想做的事情的正确方法。

这是我的起始代码：

// In a button's onClick event handler:
Intent intent = new Intent(Intent.ACTION_PICK, ContactsContract.Contacts.CONTENT_URI);
startActivityForResult(intent, PICK_CONTACT);

// In onActivityResult:
if (resultCode == RESULT_OK) {
    if (requestCode == PICK_CONTACT) {
        contactURI = data.getData();
        // NOW WHAT?
    }
}

Answer 1

好的，经过大量挖掘，我找到了我认为的答案。我发现的解决方案根据您使用的 Android API 级别而有所不同。但是，它们一点也不漂亮，所以如果有更好的解决方案，我很想知道。

无论如何，第一步是通过查询 Intent.ACTION_PICK 返回的 URI 来获取联系人的 ID。当我们在这里时，我们还应该获取显示名称，以及表示联系人是否有电话号码的字符串。 （现代解决方案不需要它们，但旧解决方案需要它们。）

String id, name, phone, hasPhone;
int idx;
Cursor cursor = getContentResolver().query(contactUri, null, null, null, null);
if (cursor.moveToFirst()) {
    idx = cursor.getColumnIndex(ContactsContract.Contacts._ID);
    id = cursor.getString(idx);

    idx = cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME);
    name = cursor.getString(idx);

    idx = cursor.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER);
    hasPhone = cursor.getString(idx);
}

为了记录，从这个 URI 返回的列是 大部分ContactsContract.Profile 类中的常量表示的字段（包括从其他接口继承的常量）。不包括 PHOTO_FILE_ID、PHOTO_THUMBNAIL_URI 或 PHOTO_URI（但包括 PHOTO_ID）。

现在我们有了 ID，我们需要获取相关数据。第一个（也是最简单的）解决方案是查询实体。实体查询一次检索联系人或原始联系人的所有联系人数据。每行代表一个原始联系人，使用ContactsContract.Contacts.Entity 中的常量访问。通常您只关心 RAW_CONTACT_ID、DATA1 和 MIMETYPE。但是，如果您想要分别使用名字和姓氏，Name MIME 类型将名字保存在 DATA2 中，将姓氏保存在 DATA3 中。

通过将 MIMETYPE 列与 ContactsContract.CommonDataKinds 常量匹配来加载变量；例如，电子邮件 MIME 类型为 ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE。

// Build the Entity URI.
Uri.Builder b = Uri.withAppendedPath(ContactsContract.Contacts.CONTENT_URI, id).buildUpon();
b.appendPath(ContactsContract.Contacts.Entity.CONTENT_DIRECTORY);
URI contactUri = b.build();

// Create the projection (SQL fields) and sort order.
String[] projection = {
        ContactsContract.Contacts.Entity.RAW_CONTACT_ID,
        ContactsContract.Contacts.Entity.DATA1,
        ContactsContract.Contacts.Entity.MIMETYPE };
String sortOrder = ContactsContract.Contacts.Entity.RAW_CONTACT_ID + " ASC";
cursor = getContentResolver().query(contactUri, projection, null, null, sortOrder);

String mime;
int mimeIdx = cursor.getColumnIndex(ContactsContract.Contacts.Entity.MIMETYPE);
int dataIdx = cursor.getColumnIndex(ContactsContract.Contacts.Entity.DATA1);
if (cursor.moveToFirst()) {
    do {
        mime = cursor.getString(mimeIdx);
        if (mime.equalsIgnoreCase(ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE)) {
            email = cursor.getString(dataIdx);
        }
        if (mime.equalsIgnoreCase(ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)) {
            phone = cursor.getString(dataIdx);
        }
        // ...etc.
    } while (cursor.moveToNext());
}

不幸的是，在 API 11（Android 3.0，Honeycomb）中没有引入实体，这意味着该代码与市场上大约 65% 的 Android 设备不兼容（截至撰写本文时）。如果你尝试一下，你会从 URI 中得到一个IllegalArgumentException。

第二种解决方案是构建一个查询字符串，并为您要使用的每种数据类型进行一次查询：

// Get phone number - if they have one
if ("1".equalsIgnoreCase(hasPhone)) {
    cursor = getContentResolver().query(
            ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
            null,
            ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = "+ id, 
            null, null);
    if (cursor.moveToFirst()) {
        colIdx = cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER);
        phone = cursor.getString(colIdx);
    }
    cursor.close();
}

// Get email address
cursor = getContentResolver().query(
        ContactsContract.CommonDataKinds.Email.CONTENT_URI,
        null,
        ContactsContract.CommonDataKinds.Email.CONTACT_ID + " = " + id,
        null, null);
if (cursor.moveToFirst()) {
    colIdx = cursor.getColumnIndex(ContactsContract.CommonDataKinds.Email.ADDRESS);
    email = cursor.getString(colIdx);
}
cursor.close();

// ...etc.

显然，这种方式会导致大量单独的数据库查询，因此出于效率原因不推荐。

我想出的解决方案是尝试使用实体查询的版本，捕获 IllegalArgumentException，并将遗留代码放入 catch 块中：

try {
    // Build the Entity URI.
    Uri.Builder b = Uri.withAppendedPath(ContactsContract.Contacts.CONTENT_URI, id).buildUpon();
    b.appendPath(ContactsContract.Contacts.Entity.CONTENT_DIRECTORY);
        // ...etc...
} catch (IllegalArgumentException e) {
    // Get phone number - if they have one
    if ("1".equalsIgnoreCase(hasPhone)) {   
        // ...etc...
} finally {
    // If you want to display the info in GUI objects, put the code here
}

我希望这对某人有所帮助。而且，如果有更好的方法可以做到这一点，我会全力以赴。

Answer 2

事实证明，有更好的方法来做到这一点。

正如我所提到的，ContactsContract.Contacts.Entity 类直到 API 11 才可用。但是，ContactsContract.Data 类早在 API 5 中就可以使用，您可以以与您使用的方式大致相同的方式使用该类实体类。

我已经更新了我的代码。它与 Entity 类的代码非常相似，并且工作方式大致相同。不过，我已经用运行 Gingerbread 的手机对其进行了测试，效果很好。

我必须做的一个更改是：似乎没有办法从初始查询中获取 ContactsContract.Data.RAW_CONTACT_ID，并且该 ID 不与您的 ID 相同从例如ContactsContract.Contacts._ID。相反，我查询了 ContactsContract.Contacts.DISPLAY_NAMEconstant，这在几乎所有 ContactsContract 类中都是一致的。

这是工作代码：

        Cursor cursor;  // Cursor object
        String mime;    // MIME type
        int dataIdx;    // Index of DATA1 column
        int mimeIdx;    // Index of MIMETYPE column
        int nameIdx;    // Index of DISPLAY_NAME column

        // Get the name
        cursor = getContentResolver().query(params[0],
                new String[] { ContactsContract.Contacts.DISPLAY_NAME },
                null, null, null);
        if (cursor.moveToFirst()) {
            nameIdx = cursor.getColumnIndex(
                    ContactsContract.Contacts.DISPLAY_NAME);
            name = cursor.getString(nameIdx);

            // Set up the projection
            String[] projection = {
                    ContactsContract.Data.DISPLAY_NAME,
                    ContactsContract.Contacts.Data.DATA1,
                    ContactsContract.Contacts.Data.MIMETYPE };

            // Query ContactsContract.Data
            cursor = getContentResolver().query(
                    ContactsContract.Data.CONTENT_URI, projection,
                    ContactsContract.Data.DISPLAY_NAME + " = ?",
                    new String[] { name },
                    null);

            if (cursor.moveToFirst()) {
                // Get the indexes of the MIME type and data
                mimeIdx = cursor.getColumnIndex(
                        ContactsContract.Contacts.Data.MIMETYPE);
                dataIdx = cursor.getColumnIndex(
                        ContactsContract.Contacts.Data.DATA1);

                // Match the data to the MIME type, store in variables
                do {
                    mime = cursor.getString(mimeIdx);
                    if (ContactsContract.CommonDataKinds.Email
                            .CONTENT_ITEM_TYPE.equalsIgnoreCase(mime)) {
                        email = cursor.getString(dataIdx);
                    }
                    if (ContactsContract.CommonDataKinds.Phone
                            .CONTENT_ITEM_TYPE.equalsIgnoreCase(mime)) {
                        phone = cursor.getString(dataIdx);
                        phone = PhoneNumberUtils.formatNumber(phone);
                    }
                } while (cursor.moveToNext());
            }
        }

Answer 3

//Add a permission to read contacts data to your application manifest.
<uses-permission android:name="android.permission.READ_CONTACTS"/>

//Use Intent.ACTION_PICK in your Activity 
Intent contactPickerIntent = new Intent(Intent.ACTION_PICK,
                ContactsContract.CommonDataKinds.Phone.CONTENT_URI);
        startActivityForResult(contactPickerIntent, RESULT_PICK_CONTACT);

//Then Override the onActivityResult() and retrieve the ID,Phone number and Name in the data. 
 @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        // check whether the result is ok
        if (resultCode == RESULT_OK) {
            // Check for the request code, we might be usign multiple startActivityForReslut
            switch (requestCode) {
            case RESULT_PICK_CONTACT:
               Cursor cursor = null;
        try {
            String phoneNo = null ;
            String name = null;           
            Uri uri = data.getData();            
            cursor = getContentResolver().query(uri, null, null, null, null);
            cursor.moveToFirst();           
            int  phoneIndex =cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER);
            phoneNo = cursor.getString(phoneIndex); 
            textView2.setText(phoneNo);
        } catch (Exception e) {
            e.printStackTrace();
        }
                break;
            }
        } else {
            Log.e("MainActivity", "Failed to pick contact");
        }
    }

注意：在 Android 2.3（API 级别 9）之前，对联系人提供程序（如上所示）执行查询需要您的应用声明 READ_CONTACTS 权限（请参阅安全性和权限）。但是，从 Android 2.3 开始，Contacts/People 应用程序会在您返回结果时授予您的应用程序从 Contacts Provider 读取的临时权限。临时权限仅适用于请求的特定联系人，因此您不能查询除意图的 Uri 指定的联系人以外的联系人，除非您声明了 READ_CONTACTS 权限。