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

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

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

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

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

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

• डेटा के लिए ज़्यादा सटीक अनुरोध: ऐप्लिकेशन, पूरी संपर्क जानकारी पाने के बजाय यह तय कर सकते हैं कि उन्हें कौनसे फ़ील्ड की ज़रूरत है. जैसे, फ़ोन नंबर या ईमेल पते.
• एक से ज़्यादा विकल्प चुनने की सुविधा: पिकर में, एक या एक से ज़्यादा संपर्क चुने जा सकते हैं. इससे डेवलपर को ग्रुप में शामिल होने के न्योते जैसी सुविधाओं के लिए ज़्यादा विकल्प मिलते हैं.
• संपर्क चुनने की सीमाएं: डेवलपर, संपर्कों की संख्या के लिए कस्टम सीमाएं सेट कर सकते हैं. इससे यह तय किया जा सकता है कि कोई उपयोगकर्ता एक बार में कितने संपर्क चुन सकता है.
• अस्थायी ऐक्सेस: इस विकल्प को चुनने पर, सिस्टम एक सेशन यूआरआई दिखाता है. इससे अनुरोध किए गए डेटा को पढ़ने का अस्थायी ऐक्सेस मिलता है. इससे यह पक्का होता है कि ऐक्सेस, ज़रूरत से ज़्यादा समय तक न रहे.
• अन्य प्रोफ़ाइलों का ऐक्सेस: इस नए इंटेंट का इस्तेमाल करते समय, इंटरफ़ेस उपयोगकर्ताओं को अन्य प्रोफ़ाइलों से कॉन्टेंट चुनने की अनुमति देगा. जैसे, वर्क प्रोफ़ाइल, क्लोन की गई प्रोफ़ाइल या प्राइवेट स्पेस.
• बेहतर परफ़ॉर्मेंस: संपर्क चुनने की सुविधा, एक Uri दिखाती है. इससे एक साथ कई नतीजों के बारे में क्वेरी की जा सकती है. इससे अलग-अलग संपर्क Uri के बारे में अलग-अलग क्वेरी करने की ज़रूरत नहीं पड़ती. ऐसा करना 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
}

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

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

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

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