注：本文翻譯自Google官方的Android Developers Training文檔，譯者技術一般，由于喜愛安卓而產生了翻譯的念頭，純屬個人興趣愛好。
原文鏈接： http://developer.android.com/training/contacts-provider/display-contact-badge.html
這節課將會向你展示如何添加一個 QuickContactBadge 到你的UI中，以及如何將數據和它捆綁起來。一個 QuickContactBadge 是一個顯示縮略圖的空間。雖然你可以使用 Bitmap 顯示任何縮略圖，但是你必須要將聯系人照片進行解碼。
縮略圖的作用類似于一個控制器：當用戶點擊縮略圖時，
QuickContactBadge
會擴展成一個對話框，其中包含如下內容：
一個放大的圖標
一個和該聯系人關聯的大圖標，如果沒有的話，就用一個默認的占位圖片代替。
應用圖標
每一個具體的聯系人信息旁會有一個應用圖標，它說明該數據可被此內置應用處理。例如，如果聯系人的數據中有一個或多個email地址，那么就會出現一個email的圖標。當用戶點擊這個圖標，聯系人的所有email地址會顯示出來，之后用戶如果點擊了某一個email地址，會打開電子郵件應用，其中的收件人地址就是所選中的email地址。
QuickContactBadge 提供了一個指向聯系人詳細信息的即時訪問，以及一個和聯系人溝通的快速渠道。用戶不需要查詢聯系人列表，尋找并拷貝信息，之后再把它粘貼到其它的應用界面中去。取而代之的，它們只需要在 QuickContactBadge 上進行點擊，選擇他們想要使用的溝通方式，并直接通過相關的應用發送消息即可。
一）. 添加一個QuickContactBadge視圖
要添加一個 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
>
二）. 檢索提供器的數據
要在 QuickContactBadge 中顯示一個聯系人，你需要一個聯系人的內容URI還有縮略圖的 Bitmap 對象。你從Contacts Provider搜索的列數據用來創建內容URI和 Bitmap 對象。指定這些列左右你在 Cursor 中用來加載數據的投影的一部分。
對Android 3.0（API版本11）及之后的版本，在你的投影中包含下面幾列：
對Android 2.3.3（API版本10）及之前的版本，在你的投影中包含下面幾列：
我們假設在這節課之前，你已經加載了一個 Cursor ，它包含了上面的這些列，還有一些你已經選擇了的列。要學習如何使用 Cursor 檢索這些列數據，可以參閱： Retrieving a List of Contacts （博客鏈接： http://www.cnblogs.com/jdneo/p/3674830.html ）
三）. 設置內容URI和縮略圖
一旦你有了必要的列，你就可以將數據綁定到 QuickContactBadge 上。
設置內容URI
要為聯系人的內容URI，調用 getLookupUri(id,lookupKey) 來獲取一個 CONTENT_LOOKUP_URI ，然后調用 assignContactUri() 來設置聯系人。例如：
//
The Cursor that contains contact rows
Cursor mCursor;
//
The index of the _ID column in the Cursor
int
mIdColumn;
//
The index of the LOOKUP_KEY column in the Cursor
int
mLookupKeyColumn;
//
A content URI for the desired contact
Uri mContactUri;
//
A handle to the QuickContactBadge view
QuickContactBadge mBadge;
...
mBadge
=
(QuickContactBadge) findViewById(R.id.quickbadge);
/*
* Insert code here to move to the desired cursor row
*/
//
Gets the _ID column index
mIdColumn =
mCursor.getColumnIndex(Contacts._ID);
//
Gets the LOOKUP_KEY index
mLookupKeyColumn =
mCursor.getColumnIndex(Contacts.LOOKUP_KEY);
//
Gets a content URI for the contact
mContactUri =
Contacts.getLookupUri(
mCursor.getLong(mIdColumn),
mCursor.getString(mLookupKeyColumn)
);
mBadge.assignContactUri(mContactUri);
當用戶點擊了 QuickContactBadge 圖標后，聯系人的詳細信息會自動顯示在對話框中。
設置照片縮略圖
為 QuickContactBadge 設置聯系人的URI并不會自動的加載他的照片。要加載照片，需要從聯系人的 Cursor 行中獲取照片的URI，使用它來打開包含有壓縮后的照片縮略圖文件，并將該文件讀入一個 Bitmap 對象。
Note：
PHOTO_THUMBNAIL_URI 列在Android 3.0之前的版本中是沒有的。對于那些較早的版本，你必須從 Contacts.Photo 自表中獲取URI。
首先，為訪問包含有 Contacts._ID 和 Contacts.LOOKUP_KEY 列的 Cursor 設置變量，如下所示：
//
The column in which to find the thumbnail ID
int
mThumbnailColumn;
/*
* The thumbnail URI, expressed as a String.
* Contacts Provider stores URIs as String values.
*/
String mThumbnailUri;
...
/*
* Gets the photo thumbnail column index if
* platform version >= Honeycomb
*/
if
(Build.VERSION.SDK_INT >=
Build.VERSION_CODES.HONEYCOMB) {
mThumbnailColumn
=
mCursor.getColumnIndex(Contacts.PHOTO_THUMBNAIL_URI);
//
Otherwise, sets the thumbnail column to the _ID column
}
else
{
mThumbnailColumn
=
mIdColumn;
}
/*
* Assuming the current Cursor position is the contact you want,
* gets the thumbnail ID
*/
mThumbnailUri
=
mCursor.getString(mThumbnailColumn);
...
定義一個方法，它獲取聯系人的照片數據，以及縮略圖的目標大小，并將照片以一個適當尺寸的 Bitmap 形式返回。我們首先從構造一個指向該縮略圖的URI開始：
/**
* Load a contact photo thumbnail and return it as a Bitmap,
* resizing the image to the provided image dimensions as needed.
*
@param
photoData photo ID Prior to Honeycomb, the contact's _ID value.
* For Honeycomb and later, the value of PHOTO_THUMBNAIL_URI.
*
@return
A thumbnail Bitmap, sized to the provided width and height.
* Returns null if the thumbnail is not found.
*/
private
Bitmap loadContactPhotoThumbnail(String photoData) {
//
Creates an asset file descriptor for the thumbnail file.
AssetFileDescriptor afd =
null
;
//
try-catch block for file not found
try
{
//
Creates a holder for the URI.
Uri thumbUri;
//
If Android 3.0 or later
if
(Build.VERSION.SDK_INT
>=
Build.VERSION_CODES.HONEYCOMB) {
//
Sets the URI from the incoming PHOTO_THUMBNAIL_URI
thumbUri =
Uri.parse(photoData);
}
else
{
//
Prior to Android 3.0, constructs a photo Uri using _ID
/*
* Creates a contact URI from the Contacts content URI
* incoming photoData (_ID)
*/
final
Uri contactUri =
Uri.withAppendedPath(
Contacts.CONTENT_URI, photoData);
/*
* Creates a photo URI by appending the content URI of
* Contacts.Photo.
*/
thumbUri
=
Uri.withAppendedPath(
contactUri, Photo.CONTENT_DIRECTORY);
}
/*
* Retrieves an AssetFileDescriptor object for the thumbnail
* URI
* using ContentResolver.openAssetFileDescriptor
*/
afd
=
getActivity().getContentResolver().
openAssetFileDescriptor(thumbUri,
"r"
);
/*
* Gets a file descriptor from the asset file descriptor.
* This object can be used across processes.
*/
FileDescriptor fileDescriptor
=
afd.getFileDescriptor();
//
Decode the photo file and return the result as a Bitmap
//
If the file descriptor is valid
if
(fileDescriptor !=
null
) {
//
Decodes the bitmap
return
BitmapFactory.decodeFileDescriptor(
fileDescriptor,
null
,
null
);
}
//
If the file isn't found
}
catch
(FileNotFoundException e) {
/*
* Handle file not found errors
*/
}
//
In all cases, close the asset file descriptor
}
finally
{
if
(afd !=
null
) {
try
{
afd.close();
}
catch
(IOException e) {}
}
}
return
null
;
}
在你的代碼中調用 loadContactPhotoThumbnail() 來獲取縮略圖的 Bitmap 對象，將結果用來設置你的 QuickContactBadge 中的聯系人縮略圖：
...
/*
* Decodes the thumbnail file to a Bitmap.
*/
Bitmap mThumbnail
=
loadContactPhotoThumbnail(mThumbnailUri);
/*
* Sets the image in the QuickContactBadge
* QuickContactBadge inherits from ImageView, so
*/
mBadge.setImageBitmap(mThumbnail);
三）. 添加一個QuickContactBadge到ListView中
一個 QuickContactBadge 是一個ListView的非常有用的控件，它會顯示聯系人的列表。使用 QuickContactBadge 為每一個聯系人顯示他的縮略圖；當用戶點擊縮略圖后， QuickContactBadge 對話框會出現。
添加QuickContactBadge元素
首先，添加一個 QuickContactBadge 視圖元素到你的列表項布局中。例如，如果你想要顯示一個 QuickContactBadge 還有你檢索的每個聯系人的名字，將下列XML放置到一個布局文件中：
<
RelativeLayout
xmlns:android
="http://schemas.android.com/apk/res/android"
android:layout_width
="match_parent"
android:layout_height
="wrap_content"
>
<
QuickContactBadge
android:id
="@+id/quickcontact"
android:layout_height
="wrap_content"
android:layout_width
="wrap_content"
android:scaleType
="centerCrop"
/>
<
TextView
android:id
="@+id/displayname"
android:layout_width
="match_parent"
android:layout_height
="wrap_content"
android:layout_toRightOf
="@+id/quickcontact"
android:gravity
="center_vertical"
android:layout_alignParentRight
="true"
android:layout_alignParentTop
="true"
/>
</
RelativeLayout
>
?
在下面的章節中，這一文件我們稱它為： contact_item_layout.xml 。
配置一個自定義CursorAdapter
要將一個
CursorAdapter
綁定到一個包含有
QuickContactBadge
的
ListView
上，自定義一個自定義的適配器，它繼承自
CursorAdapter
。這一方法允許你在將
Cursor
綁定到
QuickContactBadge
之前，可以在
Cursor
內處理數據。同時這個方法還允許你將多個
Cursor
列綁定到
QuickContactBadge
上。這些方法對于一個傳統的
CursorAdapter
而言是不可能做到的。
對于 CursorAdapter 的子類，你必須覆寫下列方法：
填充一個新的 View 對象來顯示列表項布局。在該方法的覆寫版本中，保存布局中子 View 對象的句柄，包括子 QuickContactBadge 。通過使用這一方法，你可以避免每次你填充一個新的布局時去獲取子 View 對象的句柄。
你必須要覆寫這一方法，這樣你才能獲取每個自 View 對象的句柄。這一方法允許你在 CursorAdapter.bindView() 方法中控制他們的捆綁關系。
將數據從當前的 Cursor 行移動到列表項布局中子 View 對象里。你必須覆寫這一方法這樣你就能同時將聯系人URI和縮略圖捆綁到 QuickContactBadge 上。而默認的實現值允許一列數據和一個 View 間一對一的對應關系。
下面的代碼片段包含了自定義子類 CursorAdapter 的一個例子：
定義自定義列表適配器
定義 CursorAdapter 的子類，包括它的構造函數，覆寫 newView() 和 bindView() ：
/**
*
*
*/
private
class
ContactsAdapter
extends
CursorAdapter {
private
LayoutInflater mInflater;
...
public
ContactsAdapter(Context context) {
super
(context,
null
, 0
);
/*
* Gets an inflater that can instantiate
* the ListView layout from the file.
*/
mInflater
=
LayoutInflater.from(context);
...
}
...
/**
* Defines a class that hold resource IDs of each item layout
* row to prevent having to look them up each time data is
* bound to a row.
*/
private
class
ViewHolder {
TextView displayname;
QuickContactBadge quickcontact;
}
..
@Override
public
View newView(
Context context,
Cursor cursor,
ViewGroup viewGroup) {
/*
Inflates the item layout. Stores resource IDs in a
* in a ViewHolder class to prevent having to look
* them up each time bindView() is called.
*/
final
View itemView =
mInflater.inflate(
R.layout.contact_list_layout,
viewGroup,
false
);
final
ViewHolder holder =
new
ViewHolder();
holder.displayname
=
(TextView) view.findViewById(R.id.displayname);
holder.quickcontact
=
(QuickContactBadge)
view.findViewById(R.id.quickcontact);
view.setTag(holder);
return
view;
}
...
@Override
public
void
bindView(
View view,
Context context,
Cursor cursor) {
final
ViewHolder holder =
(ViewHolder) view.getTag();
final
String photoData =
cursor.getString(mPhotoDataIndex);
final
String displayName =
cursor.getString(mDisplayNameIndex);
...
//
Sets the display name in the layout
holder.displayname =
cursor.getString(mDisplayNameIndex);
...
/*
* Generates a contact URI for the QuickContactBadge.
*/
final
Uri contactUri =
Contacts.getLookupUri(
cursor.getLong(mIdIndex),
cursor.getString(mLookupKeyIndex));
holder.quickcontact.assignContactUri(contactUri);
String photoData
=
cursor.getString(mPhotoDataIndex);
/*
* Decodes the thumbnail file to a Bitmap.
* The method loadContactPhotoThumbnail() is defined
* in the section "Set the Contact URI and Thumbnail"
*/
Bitmap thumbnailBitmap
=
loadContactPhotoThumbnail(photoData);
/*
* Sets the image in the QuickContactBadge
* QuickContactBadge inherits from ImageView
*/
holder.quickcontact.setImageBitmap(thumbnailBitmap);
}
設置變量
在你的代碼中，設置變量，包括一個 Cursor 投影，它包含了必要的那些列。
Note：
下面的代碼片段使用了 loadContactPhotoThumbnail() 方法，這在之前的章節中該方法已經詳細敘述過了。
例如：
public
class
ContactsFragment
extends
Fragment
implements
LoaderManager.LoaderCallbacks
<Cursor>
{
...
//
Defines a ListView
private
ListView mListView;
//
Defines a ContactsAdapter
private
ContactsAdapter mAdapter;
...
//
Defines a Cursor to contain the retrieved data
private
Cursor mCursor;
/*
* Defines a projection based on platform version. This ensures
* that you retrieve the correct columns.
*/
private
static
final
String[] PROJECTION =
{
Contacts._ID,
Contacts.LOOKUP_KEY,
(Build.VERSION.SDK_INT
>=
Build.VERSION_CODES.HONEYCOMB)
?
Contacts.DISPLAY_NAME_PRIMARY :
Contacts.DISPLAY_NAME
(Build.VERSION.SDK_INT
>=
Build.VERSION_CODES.HONEYCOMB)
?
Contacts.PHOTO_THUMBNAIL_ID :
/*
* Although it's not necessary to include the
* column twice, this keeps the number of
* columns the same regardless of version
*/
Contacts_ID
...
};
/*
* As a shortcut, defines constants for the
* column indexes in the Cursor. The index is
* 0-based and always matches the column order
* in the projection.
*/
//
Column index of the _ID column
private
int
mIdIndex = 0
;
//
Column index of the LOOKUP_KEY column
private
int
mLookupKeyIndex = 1
;
//
Column index of the display name column
private
int
mDisplayNameIndex = 3
;
/*
* Column index of the photo data column.
* It's PHOTO_THUMBNAIL_URI for Honeycomb and later,
* and _ID for previous versions.
*/
private
int
mPhotoDataIndex =
Build.VERSION.SDK_INT
>= Build.VERSION_CODES.HONEYCOMB ?
3
:
0
;
...
設置ListView
在 Fragment.onCreate() 中，實例化自定義的 cursor適配器，并獲得一個 ListView 的句柄：
@Override
public
void
onCreate(Bundle savedInstanceState) {
...
/*
* Instantiates the subclass of
* CursorAdapter
*/
ContactsAdapter mContactsAdapter
=
new
ContactsAdapter(getActivity());
/*
* Gets a handle to the ListView in the file
* contact_list_layout.xml
*/
mListView
=
(ListView) findViewById(R.layout.contact_list_layout);
...
}
...
在 onActivityCreated() 中，將 ContactsAdapter 和 ListView 綁定起來：
@Override
public
void
onActivityCreated(Bundle savedInstanceState) {
...
//
Sets up the adapter for the ListView
mListView.setAdapter(mAdapter);
...
}
...
當你獲取了一個包含有聯系人數據的 Cursor ，通常是在 onLoadFinished() ，調用 swapCursor() 將 Cursor 數據移動到 ListView 。這會為聯系人列表中的每一個條目顯示 QuickContactBadge ：
public
void
onLoadFinished(Loader<Cursor>
loader, Cursor cursor) {
//
When the loader has completed, swap the cursor into the adapter.
mContactsAdapter.swapCursor(cursor);
}
當你通過一個
CursorAdapter
（或它的子類）將一個
Cursor
綁定到
ListView
上，并且你使用
CursorLoader
加載
Cursor
，一定要記得在
onLoaderReset()
的實現中清楚
Cursor
的引用，例如：
@Override
public
void
onLoaderReset(Loader<Cursor>
loader) {
//
Removes remaining reference to the previous Cursor
mContactsAdapter.swapCursor(
null
);
}
【Android Developers Training】 101. 顯示快速聯系人掛件（Quick Contact Badge）
更多文章、技術交流、商務合作、聯系博主
微信掃碼或搜索：z360901061
微信掃一掃加我為好友
QQ號聯系： 360901061
您的支持是博主寫作最大的動力，如果您喜歡我的文章，感覺我的文章對您有幫助，請用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧，狠狠點擊下面給點支持吧，站長非常感激您！手機微信長按不能支付解決辦法：請將微信支付二維碼保存到相冊，切換到微信，然后點擊微信右上角掃一掃功能，選擇支付二維碼完成支付。
【本文對您有幫助就好】元
