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. Giống như 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, các ứng dụng cầ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 rộng. Mặc dù có hiệu quả, nhưng phương pháp này thường cấp cho ứ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) thay đổi cơ chế 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 phạm vi 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 ý định Intent.ACTION_PICK_CONTACTS. API mới này cung cấp một số tính năng mạnh mẽ:

• Yêu cầu dữ liệu chi tiết: Ứng dụng có thể chỉ định chính xác những trường cần thiết, 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 thông tin liên hệ.
• 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 đối với các tính năng như lời mời 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 cung 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.
• 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ơ được 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ả tập thể, loại bỏ nhu cầu truy vấn riêng từng Uri người liên hệ như 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 ý định ACTION_PICK cũ chỉ định loại dữ liệu 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 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, bạn nê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.
• Lưu trữ ngay lập tức: Lưu trữ dữ liệu đã chọn ngay lập tức vì quyền truy cập URI phiên chỉ là tạm thời.