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

Question

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

到目前为止，我已经编写了代码来启动一个新的 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 中的常量表示的字段。类(包括从其他接口(interface)继承的常量)。不包括 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 设备不兼容(截至撰写本文时)。如果你尝试一下，你会得到一个 IllegalArgumentException来自 URI。

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

// 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 block 中:

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
}

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