產品最新消息

聯絡人選擇工具：隱私權優先的聯絡人分享功能

4 分鐘讀物
查看 Roxanna Aliabadi Walker 的個人資料
Roxanna Aliabadi Walker Android 產品經理

隱私權和使用者控制項仍是 Android 體驗的核心。相片挑選工具讓媒體分享功能更安全、更容易導入，現在我們也將同樣的隱私保護、簡易性和優質使用者體驗，帶到聯絡人選取功能。

聯絡人隱私權新標準

以往，需要存取特定使用者聯絡人的應用程式，會仰賴廣泛的 READ_CONTACTS 權限。雖然這種做法可行，但往往會授予應用程式過多資料。Android 17 推出全新的 Android 聯絡人選擇工具，提供標準化、安全且可搜尋的聯絡人選取介面，改變了這項機制。

這項功能可讓使用者僅授予應用程式存取特定聯絡人的權限，符合 Android 對資料透明度和最小化權限足跡的承諾。

picker.png
selection.png

運作方式

開發人員可以使用 Intent.ACTION_PICK_CONTACTS 意圖整合聯絡人選擇工具。這項更新後的 API 提供多項強大功能：

  • 精細資料要求：應用程式可以指定所需欄位 (例如電話號碼或電子郵件地址)，不必接收整筆聯絡人記錄。
  • 支援多重選取：選擇工具支援單一和多重聯絡人選取，讓開發人員能更靈活地運用群組邀請等功能。
  • 選取限制：開發人員可以自訂使用者一次可選取的聯絡人數量上限。
  • 暫時存取權：選取後，系統會傳回工作階段 URI，提供所要求資料的暫時讀取權限，確保存取權不會超過必要時間。
  • 存取其他使用者個人資料： 使用這個新意圖時，使用者可以透過介面選取其他使用者個人資料中的內容，例如工作資料夾、複製的使用者個人資料或私人空間。
  • 效能最佳化： 聯絡人選擇工具會傳回單一 Uri，可一併查詢結果，不必像 ACTION_PICK 那樣，需要個別查詢聯絡人 Uri。這項效率可透過單一 Binder 交易進一步減少系統負擔。

回溯相容性和導入方式

如果裝置搭載 Android 17 以上版本，系統會自動將指定聯絡人資料類型的舊版 ACTION_PICK 意圖，升級為更安全的新介面。不過，為了充分運用多重選取等進階功能，建議開發人員更新實作程式碼，並使用 ContentResolver 查詢傳回的工作階段 URI。


整合聯絡人選擇工具如要整合聯絡人選擇工具，開發人員應使用 ACTION_PICK_CONTACTS 意圖。以下程式碼範例說明如何啟動挑選器，並要求電子郵件和電話號碼等特定資料欄位。

// State to hold the list of selected contacts
var contacts by remember { mutableStateOf<List>(emptyList()) }
// Launcher for the Contact Picker intent
val pickContact = rememberLauncherForActivityResult(StartActivityForResult()) {
if (it.resultCode == Activity.RESULT_OK) {
val resultUri = it.data?.data ?: return@rememberLauncherForActivityResult
    // Process the result URI in a background thread
    coroutine.launch {
        contacts = processContactPickerResultUri(resultUri, context)
    }
}
}
// Define the specific contact data fields you need
val requestedFields = arrayListOf(
Email.CONTENT_ITEM_TYPE,
Phone.CONTENT_ITEM_TYPE,
)
// Set up the intent for the Contact Picker
val pickContactIntent = Intent(ACTION_PICK_CONTACTS).apply {
putExtra(EXTRA_PICK_CONTACTS_SELECTION_LIMIT, 5)
putStringArrayListExtra(
EXTRA_PICK_CONTACTS_REQUESTED_DATA_FIELDS,
requestedFields
)
putExtra(EXTRA_PICK_CONTACTS_MATCH_ALL_DATA_FIELDS, false)
}
// Launch the picker
pickContact.launch(pickContactIntent)

使用者選取後，應用程式會查詢傳回的工作階段 URI，擷取要求的聯絡資訊，藉此處理結果。

// Data class representing a parsed Contact with selected details
data class Contact(val id: String, val name: String, val email: String?, val phone: String?)

// Helper function to query the content resolver with the URI returned by the Contact Picker.
// Parses the cursor to extract contact details such as name, email, and phone number
private suspend fun processContactPickerResultUri(
    sessionUri: Uri,
    context: Context
): List<Contact> = withContext(Dispatchers.IO) {
    // Define the columns we want to retrieve from the ContactPicker ContentProvider
    val projection = arrayOf(
        ContactsContract.Contacts._ID,
        ContactsContract.Contacts.DISPLAY_NAME_PRIMARY,
        ContactsContract.Data.MIMETYPE, // Type of data (e.g., email or phone)
        ContactsContract.Data.DATA1, // The actual data (Phone number / Email string)
    )

    val results = mutableListOf<Contact>()

    // Note: The Contact Picker Session Uri doesn't support custom selection & selectionArgs.
    context.contentResolver.query(sessionUri, projection, null, null, null)?.use { cursor ->
        // Get the column indices for our requested projection
        val contactIdIdx = cursor.getColumnIndex(ContactsContract.Contacts._ID)
        val mimeTypeIdx = cursor.getColumnIndex(ContactsContract.Data.MIMETYPE)
        val nameIdx = cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME_PRIMARY)
        val data1Idx = cursor.getColumnIndex(ContactsContract.Data.DATA1)

        while (cursor.moveToNext()) {
            val contactId = cursor.getString(contactIdIdx)
            val mimeType = cursor.getString(mimeTypeIdx)
            val name = cursor.getString(nameIdx) ?: ""
            val data1 = cursor.getString(data1Idx) ?: ""

            // Determine if the current row represents an email or a phone number
            val email = if (mimeType == Email.CONTENT_ITEM_TYPE) data1 else null
            val phone = if (mimeType == Phone.CONTENT_ITEM_TYPE) data1 else null

            // Add the parsed contact to our results list
            results.add(Contact(contactId, name, email, phone))
        }
    }

    return@withContext results
}

如要查看完整說明文件，請按這裡。

開發人員最佳做法

為提供最佳使用者體驗並維持高安全性標準，建議您採取下列做法：

  • 資料最小化原則：只要求應用程式所需的特定資料欄位 (例如電子郵件)。
  • 立即保留：工作階段 URI 存取權為暫時性，因此會立即保留所選資料。
作者：
繼續閱讀