Android Contacts之二根据4.4实现的联系人列表特效

Contacts系列文章

Android Contacts之一联系人列表特效
Android Contacts之二根据4.4实现的联系人列表特效
Android Contacts之三自定义的联系人列表特效

---

简介

Android 4.4的原生Contacts源码的研究，写了一个仿原生的联系人列表并加了比较酷炫的字母索引表,实现效果如下图：

接下来介绍下实现这个联系人需要的关键部分的代码

---

重要知识点

• 查询系统联系人电话号码，名字，头像等

String[] projection = { 
            Phone._ID, 
            Phone.DISPLAY_NAME, 
            Phone.NUMBER,
            Phone.SORT_KEY_PRIMARY, 
            Phone.CONTACT_ID, 
            Phone.PHOTO_ID,
            Phone.LOOKUP_KEY };
//按sort_key升序查询
queryHandler.startQuery(0, null, Phone.CONTENT_URI, projection, null,
                null, "sort_key COLLATE LOCALIZED asc");

//所需权限
<uses-permission android:name="android.permission.READ_CONTACTS" />

• 获取系统联系人头像

//获取系统联系人的photoid和contactid，如果photoid不为0就可以得到其头像图片
Uri uri = ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI, contactid);
InputStream input = ContactsContract.Contacts.openContactPhotoInputStream(context.getContentResolver(), uri);
Bitmap contactPhoto = BitmapFactory.decodeStream(input);

• 获取索引

//原生的4.4系统就是使用下面这个uri获取联系人数据的
public static final Uri CONTENT_CALLABLES_URI = Uri.withAppendedPath(ContactsContract.Data.CONTENT_URI, "callables").buildUpon()
                .appendQueryParameter(ContactsContract.DIRECTORY_PARAM_KEY, "0")
                .appendQueryParameter("address_book_index_extras", "true")
                .appendQueryParameter("remove_duplicate_entries", "true")
                .build();

//cursor来自于CONTENT_CALLABLES_URI请求后获取到的cursor，由于这个是原生的方法，所以在第三方固件可能不适用，需要自己做相应的处理
Bundle bundle = cursor.getExtras();
if (bundle.containsKey("address_book_index_titles")) {
    String sections[] = bundle.getStringArray("address_book_index_titles");
    int counts[] = bundle.getIntArray("address_book_index_counts");
    sectionIndexer = new ContactsSectionIndexer(sections, counts);
}

ContactsSectionIndexer.java这个类从原生的Contacts中提取出来的做了部分修改。

public class ContactsSectionIndexer implements SectionIndexer {

    private String[] mSections;
    private int[] mPositions;
    private int mCount;
    private static final String BLANK_HEADER_STRING = " ";

    /**
     * Constructor.
     *
     * @param sections a non-null array
     * @param counts a non-null array of the same size as <code>sections</code>
     */
    public ContactsSectionIndexer(String[] sections, int[] counts) {
        if (sections == null || counts == null) {
            throw new NullPointerException();
        }

        if (sections.length != counts.length) {
            throw new IllegalArgumentException(
                    "The sections and counts arrays must have the same length");
        }


        this.mSections = sections;
        mPositions = new int[counts.length];
        int position = 0;
        for (int i = 0; i < counts.length; i++) {
            if (TextUtils.isEmpty(mSections[i])) {
                mSections[i] = BLANK_HEADER_STRING;
            } else if (!mSections[i].equals(BLANK_HEADER_STRING)) {
                mSections[i] = mSections[i].trim();
            }

            mPositions[i] = position;
            position += counts[i];
        }
        mCount = position;
    }

    public Object[] getSections() {
        return mSections;
    }

    public int getPositionForSection(int section) {
        if (section < 0 || section >= mSections.length) {
            return -1;
        }

        return mPositions[section];
    }

    public int getSectionForPosition(int position) {
        if (position < 0 || position >= mCount) {
            return -1;
        }

        int index = Arrays.binarySearch(mPositions, position);

        /*
         * Consider this example: section positions are 0, 3, 5; the supplied
         * position is 4. The section corresponding to position 4 starts at
         * position 3, so the expected return value is 1. Binary search will not
         * find 4 in the array and thus will return -insertPosition-1, i.e. -3.
         * To get from that number to the expected value of 1 we need to negate
         * and subtract 2.
         */
        return index >= 0 ? index : -index - 2;
    }

    public int getPositionForSections(String s) {
        int position = -1;
        for (int i = 0; i < mSections.length; i++) {
            if (mSections[i].equals(s)) {
                position = getPositionForSection(i);
                break;
            }
        }

        return position;
    }
}

• 字母索引的特效

Sidebar这个就不多说了，直接看源码就好了。

---

总结

重要的知识点就是上面这几个了，如果对于联系人特效感兴趣可以看这篇文章Android Contacts之一联系人列表特效,这里介绍了一些博主写的特效可供参考。
当然，本文给的获取联系人的数据是4.4原生的方式，好像对于中文索引这一块也不支持，所以在国内使用的话，还要做中文转拼音的操作，再做一个字母索引，而不是使用系统的方式获取索引。

源码下载