Trình chọn người liên hệ: Chia sẻ người liên hệ ưu tiên quyền riêng tư

Quyền riêng tư và quyền kiểm soát của người dùng vẫn là yếu tố cốt lõi trong trải nghiệm Android. Tương tự như cách công cụ chọn ảnh giúp việc chia sẻ nội dung nghe nhìn trở nên an toàn và dễ triển khai, giờ đây, chúng tôi cũng mang đến mức độ riêng tư, sự đơn giản và trải nghiệm người dùng tuyệt vời tương tự cho việc chọn người liên hệ.

Tiêu chuẩn mới về quyền riêng tư của người liên hệ

Trước đây, những ứng dụng cần quyền truy cập vào danh bạ của một người dùng cụ thể đều dựa vào quyền READ_CONTACTS diện rộng. Mặc dù có chức năng, nhưng phương pháp này thường cấp cho các ứng dụng nhiều dữ liệu hơn mức cần thiết. Trình chọn người liên hệ mới của Android (ra mắt trong Android 17) sẽ thay đổi động thái này bằng cách cung cấp một giao diện chuẩn hoá, an toàn và có thể tìm kiếm để chọn người liên hệ.

Tính năng này cho phép người dùng chỉ cấp cho ứng dụng quyền truy cập vào những người liên hệ cụ thể mà họ chọn, phù hợp với cam kết của Android về tính minh bạch của dữ liệu và giảm thiểu dấu vết của quyền.

Cách hoạt động

Nhà phát triển có thể tích hợp Trình chọn người liên hệ bằng cách sử dụng ý định Intent.ACTION_PICK_CONTACTS. API mới này cung cấp một số chức năng mạnh mẽ:

• Yêu cầu dữ liệu thật chi tiết: Các ứng dụng có thể chỉ định chính xác những trường mà chúng cần, chẳng hạn như số điện thoại hoặc địa chỉ email, thay vì nhận toàn bộ bản ghi danh bạ.
• Hỗ trợ chọn nhiều mục: Trình chọn hỗ trợ cả việc chọn một và nhiều người liên hệ, giúp nhà phát triển linh hoạt hơn cho các tính năng như lời mời tham gia nhóm.
• Giới hạn lựa chọn: Nhà phát triển có thể đặt giới hạn tuỳ chỉnh về số lượng người liên hệ mà người dùng có thể chọn cùng một lúc.
• Quyền truy cập tạm thời: Khi bạn chọn, hệ thống sẽ trả về một URI phiên cấp quyền đọc tạm thời đối với dữ liệu được yêu cầu, đảm bảo rằng quyền truy cập không kéo dài hơn mức cần thiết.
• Quyền truy cập vào các hồ sơ khác:  Khi sử dụng ý định mới này, giao diện sẽ cho phép người dùng chọn nội dung từ các hồ sơ người dùng khác, chẳng hạn như hồ sơ công việc, hồ sơ sao chép hoặc không gian riêng tư.
• Hiệu suất tối ưu:  Trình chọn người liên hệ trả về một Uri duy nhất cho phép truy vấn kết quả chung, loại bỏ nhu cầu truy vấn riêng từng Uri người liên hệ theo yêu cầu của ACTION_PICK. Hiệu quả này giúp giảm thêm mức hao tổn hệ thống bằng cách sử dụng một giao dịch Binder duy nhất.

Khả năng tương thích ngược và cách triển khai

Đối với các thiết bị chạy Android 17 trở lên, hệ thống sẽ tự động nâng cấp các ý định ACTION_PICK cũ chỉ định kiểu dữ liệu người liên hệ lên giao diện mới, an toàn hơn. Tuy nhiên, để tận dụng tối đa các tính năng nâng cao như chọn nhiều mục, nhà phát triển nên cập nhật mã triển khai và sử dụng ContentResolver để truy vấn URI phiên được trả về.

Tích hợp trình chọn người liên hệĐể tích hợp Trình chọn người liên hệ, nhà phát triển sử dụng ý định ACTION_PICK_CONTACTS. Dưới đây là ví dụ về mã minh hoạ cách khởi chạy bộ chọn và yêu cầu các trường dữ liệu cụ thể, chẳng hạn như email và số điện thoại.

// 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)

Sau khi người dùng lựa chọn, ứng dụng sẽ xử lý kết quả bằng cách truy vấn URI phiên được trả về để trích xuất thông tin liên hệ được yêu cầu.

// 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
}

Xem toàn bộ tài liệu tại đây.

Các phương pháp hay nhất dành cho nhà phát triển

Để mang lại trải nghiệm tốt nhất cho người dùng và duy trì các tiêu chuẩn bảo mật cao, chúng tôi đề xuất bạn làm như sau:

• Giảm tối đa việc thu thập dữ liệu: Chỉ yêu cầu các trường dữ liệu cụ thể (ví dụ: email) mà ứng dụng của bạn cần.
• Tính năng duy trì ngay lập tức: Duy trì dữ liệu đã chọn ngay lập tức, vì quyền truy cập URI của phiên là tạm thời.