15

我正在编写一个具有代表一个人（特别是孩子的父母或监护人）的数据类型的 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?
    }
}
4

3 回答 3

20

好的，经过大量挖掘，我找到了我认为的答案。我发现的解决方案根据您使用的 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
}

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

于 2012-12-29T13:13:00.143 回答
18

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

正如我所提到的，ContactsContract.Contacts.Entity 类直到 API 11 才可用。但是，ContactsContract.Data类早在 API 5 中就可以使用，并且您可以像使用 Entity 类一样使用该类.

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

我必须做出的一个改变是：似乎没有办法从ContactsContract.Data.RAW_CONTACT_ID初始查询中获取 ，并且该 ID与您从 eg 获得的 ID 不同。相反，我查询了常量，它几乎在每个 ContactsContract 类中都是一致的。ContactsContract.Contacts._IDContactsContract.Contacts.DISPLAY_NAME

这是工作代码：

        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());
            }
        }
于 2013-06-12T13:37:22.570 回答
2 
//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）之前，对 Contacts Provider（如上所示）执行查询需要您的应用声明 READ_CONTACTS 权限（请参阅安全和权限）。但是，从 Android 2.3 开始，Contacts/People 应用程序会在您返回结果时授予您的应用程序从 Contacts Provider 读取的临时权限。临时权限仅适用于请求的特定联系人，因此您不能查询意图 Uri 指定的联系人以外的联系人，除非您声明了 READ_CONTACTS 权限。

于 2016-02-10T12:40:39.807 回答