विजेट को खोजने लायक बनाना

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

दूसरी इमेज. विजेट को पिन करने का उदाहरण.

उपयोगकर्ताओं को विजेट पिन करने की अनुमति देना

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

1. पक्का करें कि आपने अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल में विजेट का एलान किया हो.

2. नीचे दिए गए कोड स्निपेट में दिखाए गए तरीके से, requestPinAppWidget() तरीका कॉल करें:

Kotlin

val appWidgetManager = AppWidgetManager.getInstance(context)
val myProvider = ComponentName(context, ExampleAppWidgetProvider::class.java)

if (appWidgetManager.isRequestPinAppWidgetSupported()) {
    // Create the PendingIntent object only if your app needs to be notified
    // when the user chooses to pin the widget. Note that if the pinning
    // operation fails, your app isn't notified. This callback receives the ID
    // of the newly pinned widget (EXTRA_APPWIDGET_ID).
    val successCallback = PendingIntent.getBroadcast(
            /* context = */ context,
            /* requestCode = */ 0,
            /* intent = */ Intent(...),
            /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT)

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)
}

Java

AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
ComponentName myProvider = new ComponentName(context, ExampleAppWidgetProvider.class);

if (appWidgetManager.isRequestPinAppWidgetSupported()) {
    // Create the PendingIntent object only if your app needs to be notified
    // when the user chooses to pin the widget. Note that if the pinning
    // operation fails, your app isn't notified. This callback receives the ID
    // of the newly pinned widget (EXTRA_APPWIDGET_ID).
    PendingIntent successCallback = PendingIntent.getBroadcast(
            /* context = */ context,
            /* requestCode = */ 0,
            /* intent = */ new Intent(...),
            /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT);

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback);
}

ध्यान दें: अगर आपके ऐप्लिकेशन को इस बात की सूचना नहीं देनी है कि सिस्टम ने, इस्तेमाल किए जा सकने वाले लॉन्चर पर विजेट को पिन किया है या नहीं, तो requestPinAppWidget() के तीसरे आर्ग्युमेंट के तौर पर null डाला जा सकता है.

डिज़ाइन से जुड़े दिशा-निर्देश

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