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

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
}

पूरा दस्तावेज़ यहां देखें.

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

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

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