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

时间:2012-12-28 12:10:25

标签: android android-intent android-contentprovider android-contacts

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

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

不幸的是,我不知道下一步是什么。看起来这应该是世界上最简单的事情,但显然不是。我已经阅读了Android开发者网站上的文档,并查看了多本Android手册。没有快乐。

我想获得的具体信息是:

  1. 联系人的姓名(如果可能,请分别为第一个和最后一个)

  2. 联系人(主要)电子邮件地址

  3. 联系人的手机号码

  4. 我想通过使用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?
        }
    }
    

3 个答案:

答案 0 :(得分:17)

好的,经过大量的挖掘,我发现了我认为的答案。我发现的解决方案根据您使用的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,我们需要获取相关数据。第一个(也是最简单的)解决方案是查询实体。实体查询一次检索联系人或原始联系人的所有联系人数据。每行代表一个Raw Contact,使用ContactsContract.Contacts.Entity中的常量访问。通常,您只关心RAW_CONTACT_ID,DATA1和MIMETYPE。但是,如果您希望单独使用名字和姓氏,则名称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());
}

不幸的是,实体没有引入unti 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
}

我希望这有助于某人。而且,如果有更好的方法可以做到这一点,我全都听见了。

答案 1 :(得分:16)

事实证明,更好的方法。

正如我所提到的,ContactsContract.Contacts.Entity类在API 11之前不可用。但是,ContactsContract.Data类在API 5中可用,并且您可以使用该类的方式与你使用实体类。

我已经更新了我的代码。它与Entity类的代码非常相似,并且工作方式基本相同。但是,我用手机运行姜饼测试了它,它运行得很好。

我必须做的一个改变是:似乎没有办法从初始查询中获取ContactsContract.Data.RAW_CONTACT_ID,并且该ID 与你从中获得的身份证ContactsContract.Contacts._ID。相反,我查询ContactsContract.Contacts.DISPLAY_NAME常量,这在几乎所有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());
            }
        }

答案 2 :(得分: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)之前,对联系人提供程序执行查询(如上所示)需要您的应用程序声明READ_CONTACTS权限(请参阅安全性和权限)。但是,从Android 2.3开始,Contacts / People应用程序授予您的应用程序临时权限,以便在返回结果时从联系人提供程序中读取。临时权限仅适用于请求的特定联系人,因此除非您声明了READ_CONTACTS权限,否则您无法查询意图的Uri指定的联系人之外的联系人。