Android Training项目：联系人头像显示技术详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00535/article/details/148415931

Android Training项目：联系人头像显示技术详解

android-training-course-in-chinese Android官方培训课程中文版项目地址: https://gitcode.com/gh_mirrors/an/android-training-course-in-chinese

概述

在Android应用开发中，联系人功能是常见的需求之一。本文将深入探讨如何在应用中优雅地显示联系人头像，并实现快速联系功能。我们将基于QuickContactBadge组件，讲解如何高效地加载联系人头像缩略图，并实现点击头像快速发起联系的功能。

QuickContactBadge组件介绍

QuickContactBadge是Android提供的一个特殊视图组件，它结合了联系人头像显示和快速联系功能于一体。这个组件的主要特点包括：

头像显示：默认显示联系人缩略图
快速交互：点击后展开对话框，显示完整头像和多种联系方式
智能跳转：根据联系人信息自动适配可用的通讯方式

实现步骤详解

1. 添加QuickContactBadge到布局

首先需要在布局文件中添加QuickContactBadge组件：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
                android:layout_width="match_parent"
                android:layout_height="match_parent">
    <QuickContactBadge
               android:id="@+id/quickbadge"
               android:layout_height="wrap_content"
               android:layout_width="wrap_content"
               android:scaleType="centerCrop"/>
</RelativeLayout>

2. 获取联系人数据

要为QuickContactBadge绑定数据，需要从Contacts Provider获取以下关键信息：

联系人ID
LOOKUP_KEY（查找键）
缩略图URI（Android 3.0+）

对于不同Android版本，查询的列有所不同：

Android 3.0+ (API 11+)

String[] projection = {
    Contacts._ID,
    Contacts.LOOKUP_KEY,
    Contacts.PHOTO_THUMBNAIL_URI
};

Android 2.3.3及以下

String[] projection = {
    Contacts._ID,
    Contacts.LOOKUP_KEY
};

3. 绑定联系人URI

获取到联系人数据后，需要将联系人URI绑定到QuickContactBadge：

// 获取联系人URI
Uri contactUri = Contacts.getLookupUri(
        cursor.getLong(idColumn),
        cursor.getString(lookupKeyColumn));

// 绑定到QuickContactBadge
quickContactBadge.assignContactUri(contactUri);

4. 加载联系人缩略图

加载缩略图需要处理不同Android版本的差异：

private Bitmap loadContactPhotoThumbnail(String photoData) {
    AssetFileDescriptor afd = null;
    try {
        Uri thumbUri;
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
            // Android 3.0+直接使用PHOTO_THUMBNAIL_URI
            thumbUri = Uri.parse(photoData);
        } else {
            // 旧版本需要构造URI
            Uri contactUri = Uri.withAppendedPath(
                    Contacts.CONTENT_URI, photoData);
            thumbUri = Uri.withAppendedPath(
                    contactUri, Photo.CONTENT_DIRECTORY);
        }
        
        afd = getContentResolver().openAssetFileDescriptor(thumbUri, "r");
        FileDescriptor fd = afd.getFileDescriptor();
        if (fd != null) {
            return BitmapFactory.decodeFileDescriptor(fd, null, null);
        }
    } catch (FileNotFoundException e) {
        // 处理文件未找到异常
    } finally {
        if (afd != null) {
            try {
                afd.close();
            } catch (IOException e) {}
        }
    }
    return null;
}

5. 在ListView中使用QuickContactBadge

在列表中使用QuickContactBadge能显著提升用户体验。实现步骤：

创建自定义列表项布局
实现自定义CursorAdapter
在Adapter中处理数据绑定

自定义CursorAdapter示例：

private class ContactsAdapter extends CursorAdapter {
    private LayoutInflater mInflater;
    
    public ContactsAdapter(Context context) {
        super(context, null, 0);
        mInflater = LayoutInflater.from(context);
    }
    
    private class ViewHolder {
        TextView displayName;
        QuickContactBadge quickContact;
    }
    
    @Override
    public View newView(Context context, Cursor cursor, ViewGroup parent) {
        View itemView = mInflater.inflate(R.layout.contact_item_layout, parent, false);
        ViewHolder holder = new ViewHolder();
        holder.displayName = itemView.findViewById(R.id.displayname);
        holder.quickContact = itemView.findViewById(R.id.quickcontact);
        itemView.setTag(holder);
        return itemView;
    }
    
    @Override
    public void bindView(View view, Context context, Cursor cursor) {
        ViewHolder holder = (ViewHolder) view.getTag();
        
        // 设置显示名称
        holder.displayName.setText(cursor.getString(displayNameIndex));
        
        // 设置联系人URI
        Uri contactUri = Contacts.getLookupUri(
                cursor.getLong(idIndex),
                cursor.getString(lookupKeyIndex));
        holder.quickContact.assignContactUri(contactUri);
        
        // 加载并设置缩略图
        String photoData = cursor.getString(photoDataIndex);
        Bitmap thumbnail = loadContactPhotoThumbnail(photoData);
        holder.quickContact.setImageBitmap(thumbnail);
    }
}