उपयोगकर्ता को किसी अन्य ऐप्लिकेशन पर भेजना

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

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

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

इंप्लिसिट इंटेंट बनाना

इंप्लिसिट इंटेंट, कॉम्पोनेंट को शुरू करने के लिए क्लास के नाम का एलान नहीं करते. इसके बजाय, वे किसी कार्रवाई को करने का एलान करते हैं. कार्रवाई से पता चलता है कि आपको क्या करना है. जैसे, कुछ देखना, बदलाव करना, भेजना या पाना.

इंटेंट ऐक्शन को डेटा से जोड़ना

इंटेंट में अक्सर कार्रवाई से जुड़ा डेटा भी शामिल होता है. जैसे, वह पता जिसे आपको देखना है या वह ईमेल मैसेज जिसे आपको भेजना है. आपको जिस इंटेंट को बनाना है उसके आधार पर, डेटा Uri या कई अन्य डेटा टाइप में से कोई एक हो सकता है. इसके अलावा, ऐसा भी हो सकता है कि इंटेंट को डेटा की ज़रूरत ही न हो.

अगर आपका डेटा Uri है, तो एक आसान Intent() कंस्ट्रक्टर है. इसका इस्तेमाल करके, कार्रवाई और डेटा को तय किया जा सकता है.

उदाहरण के लिए, फ़ोन कॉल शुरू करने के लिए इंटेंट बनाने का तरीका यहां बताया गया है. इसके लिए, टेलीफ़ोन नंबर बताने के लिए Uri डेटा का इस्तेमाल करें:

Kotlin

val callIntent: Intent = Uri.parse("tel:5551234").let { number ->
    Intent(Intent.ACTION_DIAL, number)
}

Java

Uri number = Uri.parse("tel:5551234");
Intent callIntent = new Intent(Intent.ACTION_DIAL, number);

जब आपका ऐप्लिकेशन startActivity() को कॉल करके इस इंटेंट को शुरू करता है, तो फ़ोन ऐप्लिकेशन दिए गए फ़ोन नंबर पर कॉल शुरू कर देता है.

यहां कुछ अन्य इंटेंट और उनकी कार्रवाई और Uri डेटा के जोड़े दिए गए हैं:

मैप देखना

Kotlin

// Map point based on address
val mapIntent: Intent = Uri.parse(
        "geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California"
).let { location ->
    // Or map point based on latitude/longitude
    // val location: Uri = Uri.parse("geo:37.422219,-122.08364?z=14") // z param is zoom level
    Intent(Intent.ACTION_VIEW, location)
}

Java

// Map point based on address
Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");
// Or map point based on latitude/longitude
// Uri location = Uri.parse("geo:37.422219,-122.08364?z=14"); // z param is zoom level
Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);

कोई वेब पेज देखना

Kotlin

val webIntent: Intent = Uri.parse("https://www.android.com").let { webpage ->
    Intent(Intent.ACTION_VIEW, webpage)
}

Java

Uri webpage = Uri.parse("https://www.android.com");
Intent webIntent = new Intent(Intent.ACTION_VIEW, webpage);

किसी इंटेंट में अतिरिक्त जानकारी जोड़ना

अन्य तरह के इंप्लिसिट इंटेंट के लिए, "अतिरिक्त" डेटा की ज़रूरत होती है. यह डेटा, अलग-अलग तरह का हो सकता है, जैसे कि स्ट्रिंग. putExtra() के अलग-अलग तरीकों का इस्तेमाल करके, एक या इससे ज़्यादा अतिरिक्त डेटा जोड़ा जा सकता है.

डिफ़ॉल्ट रूप से, सिस्टम यह तय करता है कि किसी इंटेंट के लिए कौनसा एमआईएमई टाइप सही है. यह फ़ैसला, Uri में शामिल डेटा के आधार पर लिया जाता है. अगर इंटेंट में Uri शामिल नहीं किया जाता है, तो आम तौर पर आपको setType() का इस्तेमाल करके, इंटेंट से जुड़े डेटा का टाइप बताना चाहिए. एमआईएमई टाइप सेट करने से, यह तय होता है कि किस तरह की गतिविधियों को इंटेंट मिलना चाहिए.

यहां कुछ और इंटेंट दिए गए हैं, जो किसी कार्रवाई के बारे में बताने के लिए ज़्यादा डेटा जोड़ते हैं:

अटैचमेंट के साथ ईमेल भेजना

Kotlin

Intent(Intent.ACTION_SEND).apply {
    // The intent does not have a URI, so declare the "text/plain" MIME type
    type = "text/plain"
    putExtra(Intent.EXTRA_EMAIL, arrayOf("jan@example.com")) // recipients
    putExtra(Intent.EXTRA_SUBJECT, "Email subject")
    putExtra(Intent.EXTRA_TEXT, "Email message text")
    putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment"))
    // You can also attach multiple items by passing an ArrayList of Uris
}

Java

Intent emailIntent = new Intent(Intent.ACTION_SEND);
// The intent does not have a URI, so declare the "text/plain" MIME type
emailIntent.setType(HTTP.PLAIN_TEXT_TYPE);
emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[] {"jan@example.com"}); // recipients
emailIntent.putExtra(Intent.EXTRA_SUBJECT, "Email subject");
emailIntent.putExtra(Intent.EXTRA_TEXT, "Email message text");
emailIntent.putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment"));
// You can also attach multiple items by passing an ArrayList of Uris

कैलेंडर ईवेंट बनाएं

ध्यान दें: कैलेंडर इवेंट के लिए यह इंटेंट, सिर्फ़ एपीआई लेवल 14 और इसके बाद के वर्शन के साथ काम करता है.

Kotlin

// Event is on January 23, 2021 -- from 7:30 AM to 10:30 AM.
Intent(Intent.ACTION_INSERT, Events.CONTENT_URI).apply {
    val beginTime: Calendar = Calendar.getInstance().apply {
        set(2021, 0, 23, 7, 30)
    }
    val endTime = Calendar.getInstance().apply {
        set(2021, 0, 23, 10, 30)
    }
    putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.timeInMillis)
    putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.timeInMillis)
    putExtra(Events.TITLE, "Ninja class")
    putExtra(Events.EVENT_LOCATION, "Secret dojo")
}

Java

// Event is on January 23, 2021 -- from 7:30 AM to 10:30 AM.
Intent calendarIntent = new Intent(Intent.ACTION_INSERT, Events.CONTENT_URI);
Calendar beginTime = Calendar.getInstance();
beginTime.set(2021, 0, 23, 7, 30);
Calendar endTime = Calendar.getInstance();
endTime.set(2021, 0, 23, 10, 30);
calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.getTimeInMillis());
calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.getTimeInMillis());
calendarIntent.putExtra(Events.TITLE, "Ninja class");
calendarIntent.putExtra(Events.EVENT_LOCATION, "Secret dojo");

ध्यान दें: यह ज़रूरी है कि Intent को ज़्यादा से ज़्यादा सटीक तरीके से तय किया जाए. उदाहरण के लिए, अगर आपको ACTION_VIEW इंटेंट का इस्तेमाल करके कोई इमेज दिखानी है, तो आपको image/* का एमआईएमई टाइप तय करना चाहिए. इससे ऐसे ऐप्लिकेशन को इंटेंट से ट्रिगर होने से रोका जाता है जो अन्य तरह का डेटा "देख" सकते हैं. जैसे, मैप ऐप्लिकेशन.

इंटेंट के साथ कोई गतिविधि शुरू करना

Intent बनाने और अतिरिक्त जानकारी सेट करने के बाद, उसे सिस्टम में भेजने के लिए startActivity() को कॉल करें:

Kotlin

startActivity(intent)

Java

startActivity(intent);

ऐसी स्थिति को मैनेज करना जिसमें कोई भी ऐप्लिकेशन इंटेंट को रिसीव नहीं कर सकता

डिवाइस पर इंस्टॉल किया गया कोई दूसरा ऐप्लिकेशन, जैसे कि फ़ोन, ईमेल या कैलेंडर ऐप्लिकेशन, कई इंटेंट को मैनेज कर सकता है. हालांकि, आपके ऐप्लिकेशन को ऐसी स्थिति के लिए तैयार रहना चाहिए जहां कोई भी गतिविधि आपके ऐप्लिकेशन के इंटेंट को मैनेज न कर सके. जब भी किसी इंटेंट को शुरू किया जाए, तो ActivityNotFoundException को कैच करने के लिए तैयार रहें. ऐसा तब होता है, जब आपके ऐप्लिकेशन के इंटेंट को हैंडल करने के लिए कोई दूसरी गतिविधि न हो:

Kotlin

try {
    startActivity(intent)
} catch (e: ActivityNotFoundException) {
    // Define what your app should do if no activity can handle the intent.
}

Java

try {
    startActivity(intent);
} catch (ActivityNotFoundException e) {
    // Define what your app should do if no activity can handle the intent.
}

इस अपवाद को पकड़ने के बाद, तय करें कि आपके ऐप्लिकेशन को आगे क्या करना चाहिए. यह अगला चरण, उस इंटेंट की खास विशेषताओं पर निर्भर करता है जिसे आपने शुरू करने की कोशिश की थी. उदाहरण के लिए, अगर आपको किसी ऐसे ऐप्लिकेशन के बारे में पता है जो इंटेंट को हैंडल कर सकता है, तो उपयोगकर्ता को ऐप्लिकेशन डाउनलोड करने के लिए एक लिंक दें. Google Play पर अपने प्रॉडक्ट को लिंक करने के तरीके के बारे में ज़्यादा जानें.

डिसऐंबिग्युएशन डायलॉग

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

स्क्रीन पर सबसे नीचे एक पैनल दिखेगा. इस पैनल में उन अलग-अलग ऐप्लिकेशन की सूची होती है जो इंटेंट को हैंडल कर सकते हैं.

पहली इमेज. जब एक से ज़्यादा ऐप्लिकेशन किसी इंटेंट को हैंडल कर सकते हैं, तब दिखने वाले सिलेक्शन डायलॉग का उदाहरण.

पूरी जानकारी वाला उदाहरण

यहां एक पूरा उदाहरण दिया गया है, जिसमें मैप देखने के लिए इंटेंट बनाने, इंटेंट को हैंडल करने के लिए ऐप्लिकेशन मौजूद होने की पुष्टि करने, और फिर उसे शुरू करने का तरीका बताया गया है:

Kotlin

// Build the intent.
val location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California")
val mapIntent = Intent(Intent.ACTION_VIEW, location)

// Try to invoke the intent.
try {
    startActivity(mapIntent)
} catch (e: ActivityNotFoundException) {
    // Define what your app should do if no activity can handle the intent.
}

Java

// Build the intent.
Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);

// Try to invoke the intent.
try {
    startActivity(mapIntent);
} catch (ActivityNotFoundException e) {
    // Define what your app should do if no activity can handle the intent.
}

ऐप्लिकेशन चुनने वाला डायलॉग बॉक्स दिखाना

दूसरी इमेज. चुनने वाला डायलॉग बॉक्स.

ध्यान दें कि जब Intent को startActivity() में पास करके कोई गतिविधि शुरू की जाती है और इंटेंट का जवाब देने वाले एक से ज़्यादा ऐप्लिकेशन होते हैं, तो उपयोगकर्ता यह चुन सकता है कि डिफ़ॉल्ट रूप से किस ऐप्लिकेशन का इस्तेमाल किया जाए. इसके लिए, डायलॉग बॉक्स में सबसे नीचे मौजूद चेकबॉक्स को चुनें. इमेज 1 देखें. यह तब अच्छा होता है, जब कोई ऐसी कार्रवाई की जा रही हो जिसके लिए उपयोगकर्ता आम तौर पर हर बार एक ही ऐप्लिकेशन का इस्तेमाल करना चाहता है. जैसे, कोई वेब पेज खोलते समय (उपयोगकर्ता शायद सिर्फ़ एक वेब ब्राउज़र का इस्तेमाल करते हैं) या फ़ोटो लेते समय (उपयोगकर्ता शायद एक कैमरा पसंद करते हैं).

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

चुनने वाला टूल दिखाने के लिए, createChooser() का इस्तेमाल करके Intent बनाएं और उसे startActivity() को पास करें. उदाहरण के लिए:

Kotlin

val intent = Intent(Intent.ACTION_SEND)

// Create intent to show chooser
val chooser = Intent.createChooser(intent, /* title */ null)

// Try to invoke the intent.
try {
    startActivity(chooser)
} catch (e: ActivityNotFoundException) {
    // Define what your app should do if no activity can handle the intent.
}

Java

Intent intent = new Intent(Intent.ACTION_SEND);

// Create intent to show chooser
Intent chooser = Intent.createChooser(intent, /* title */ null);

// Try to invoke the intent.
try {
    startActivity(chooser);
} catch (ActivityNotFoundException e) {
    // Define what your app should do if no activity can handle the intent.
}

इससे एक डायलॉग बॉक्स दिखता है. इसमें उन ऐप्लिकेशन की सूची होती है जो createChooser() तरीके को पास किए गए इंटेंट का जवाब देते हैं. अगर कार्रवाई ACTION_SEND या ACTION_SEND_MULTIPLE नहीं है, तो title पैरामीटर दिया जा सकता है