कॉन्टैक्ट पिकर: निजता को प्राथमिकता देने वाली सुविधा, जिससे संपर्क शेयर किए जा सकते हैं

Android के अनुभव में, निजता और उपयोगकर्ता के कंट्रोल को सबसे ज़्यादा अहमियत दी जाती है. जिस तरह फ़ोटो पिकर की मदद से मीडिया शेयर करना सुरक्षित और आसान हो गया है, उसी तरह अब हम संपर्क चुनने के लिए भी निजता, आसानी, और बेहतर उपयोगकर्ता अनुभव देने वाली सुविधा उपलब्ध करा रहे हैं.

संपर्कों की निजता के लिए नया स्टैंडर्ड

पहले, जिन ऐप्लिकेशन को किसी उपयोगकर्ता के संपर्कों को ऐक्सेस करने की ज़रूरत होती थी वे READ_CONTACTS अनुमति का इस्तेमाल करते थे. हालांकि, इस तरीके से अक्सर ऐप्लिकेशन को ज़रूरत से ज़्यादा डेटा मिल जाता था. Android 17 में पेश किया गया नया Android कॉन्टैक्ट पिकर, संपर्क चुनने के लिए एक स्टैंडर्ड, सुरक्षित, और खोजा जा सकने वाला इंटरफ़ेस उपलब्ध कराकर इस समस्या को हल करता है.

इस सुविधा की मदद से, लोग ऐप्लिकेशन को सिर्फ़ उन संपर्कों का ऐक्सेस दे सकते हैं जिन्हें वे चुनते हैं. यह सुविधा, डेटा की पारदर्शिता और अनुमतियों के लिए Android की प्रतिबद्धता के मुताबिक है.

यह कैसे काम करता है

डेवलपर, Intent.ACTION_PICK_CONTACTS इंटेंट का इस्तेमाल करके, कॉन्टैक्ट पिकर को इंटिग्रेट कर सकते हैं. अपडेट किए गए इस एपीआई में कई बेहतरीन सुविधाएं उपलब्ध हैं:

• विस्तृत डेटा अनुरोध: ऐप्लिकेशन, यह तय कर सकते हैं कि उन्हें किन फ़ील्ड का डेटा चाहिए. जैसे, फ़ोन नंबर या ईमेल पते. इससे उन्हें संपर्क की पूरी जानकारी नहीं मिलती.
• एक से ज़्यादा संपर्क चुनने की सुविधा: पिकर की मदद से, एक या एक से ज़्यादा संपर्क चुने जा सकते हैं. इससे डेवलपर को ग्रुप के न्योते जैसी सुविधाओं के लिए ज़्यादा फ़्लेक्सिबिलिटी मिलती है.
• संपर्क चुनने की सीमाएं: डेवलपर, यह तय कर सकते हैं कि कोई व्यक्ति एक बार में कितने संपर्क चुन सकता है.
• अस्थायी ऐक्सेस: संपर्क चुनने पर, सिस्टम एक सेशन यूआरआई दिखाता है. इससे अनुरोध किए गए डेटा को अस्थायी तौर पर पढ़ा जा सकता है. इससे यह पक्का होता है कि ऐक्सेस, ज़रूरत से ज़्यादा समय तक न बना रहे.
• दूसरी प्रोफ़ाइलों का ऐक्सेस: इस नए इंटेंट का इस्तेमाल करने पर, इंटरफ़ेस लोगों को दूसरी प्रोफ़ाइलों से कॉन्टेंट चुनने की अनुमति देगा. जैसे, वर्क प्रोफ़ाइल, क्लोन की गई प्रोफ़ाइल या प्राइवेट स्पेस.
• बेहतर परफ़ॉर्मेंस:  कॉन्टैक्ट पिकर, एक यूआरआई दिखाता है. इससे नतीजों के लिए एक साथ क्वेरी की जा सकती है. इसके लिए, हर संपर्क के यूआरआई के लिए अलग-अलग क्वेरी करने की ज़रूरत नहीं होती. ACTION_PICK इस सुविधा से, सिस्टम का ओवरहेड और कम हो जाता है, क्योंकि इसमें सिर्फ़ एक Binder ट्रांज़ैक्शन का इस्तेमाल होता है.

पुराने सिस्टम के साथ काम करने की सुविधा और इसे लागू करना

Android 17 या इसके बाद के वर्शन वाले डिवाइसों के लिए, सिस्टम, संपर्क डेटा टाइप तय करने वाले पुराने ACTION_PICK इंटेंट को नए और ज़्यादा सुरक्षित इंटरफ़ेस में अपने-आप अपग्रेड कर देता है. हालांकि, एक से ज़्यादा संपर्क चुनने जैसी ऐडवांस सुविधाओं का पूरा फ़ायदा पाने के लिए, डेवलपर को अपने लागू करने के कोड को अपडेट करने और दिखाए गए सेशन यूआरआई के लिए क्वेरी करने के लिए ContentResolver का इस्तेमाल करने का सुझाव दिया जाता है.

कॉन्टैक्ट पिकर को इंटिग्रेट करनाकॉन्टैक्ट पिकर को इंटिग्रेट करने के लिए, डेवलपर 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)

उपयोगकर्ता के संपर्क चुनने के बाद, ऐप्लिकेशन, दिखाए गए सेशन यूआरआई के लिए क्वेरी करके नतीजे को प्रोसेस करता है, ताकि अनुरोध की गई संपर्क जानकारी निकाली जा सके.

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

पूरी जानकारी यहां देखें.

डेवलपर के लिए सबसे सही तरीके

उपयोगकर्ता को बेहतर अनुभव देने और सुरक्षा के ऊंचे स्टैंडर्ड बनाए रखने के लिए, हम आपको ये सुझाव देते हैं:

• डेटा कम से कम इकट्ठा करना: सिर्फ़ उन डेटा फ़ील्ड (जैसे, ईमेल) का अनुरोध करें जिनकी आपके ऐप्लिकेशन को ज़रूरत है.
• चुने गए डेटा को तुरंत सेव करना: चुने गए डेटा को तुरंत सेव करें, क्योंकि सेशन यूआरआई का ऐक्सेस अस्थायी होता है.