Assistant को डाइनैमिक शॉर्टकट पुश करें

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

उदाहरण के लिए, उपयोगकर्ता के बनाए गए हर नोट के लिए, एक शॉर्टकट पुश किया जा सकता है नोट लेने के लिए इस्तेमाल किया जाने वाला ऐप्लिकेशन. आपको ऐसे डाइनैमिक लिंक जो Google के प्लैटफ़ॉर्म पर दिखाए जा सकते हैं. जैसे, Assistant अपने प्रोजेक्ट में Google Shortcuts इंटिग्रेशन Jetpack लाइब्रेरी जोड़कर. इस लाइब्रेरी की मदद से Assistant, डाइनैमिक शॉर्टकट इस्तेमाल करती है. इन शॉर्टकट का इस्तेमाल करके ShortcutManagerCompat क्लास, जो कि एक Jetpack रैपर है ShortcutManager एपीआई.

जब आप अपने ऐप्लिकेशन में Google Shortcuts इंटिग्रेशन लाइब्रेरी का इस्तेमाल करते हैं, तो डाइनैमिक Google पर पुश किए जाने वाले शॉर्टकट, लोगों को वॉइस शॉर्टकट के सुझावों के तौर पर दिखते हैं के तौर पर दिखते हैं. आप कई सारे डाइनैमिक शॉर्टकट पुश कर सकते हैं Assistant,pushDynamicShortcut() ShortcutManagerCompat लाइब्रेरी.

अपने डेवलपमेंट प्रोजेक्ट को कॉन्फ़िगर करना

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

इस Jetpack लाइब्रेरी को जोड़ने और अपना प्रोजेक्ट कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:

  1. Jetpack लाइब्रेरी मैनेज करने के लिए अपनी gradle.properties फ़ाइल को अपडेट करें:

    gradle.properties

    android.useAndroidX=true
# Automatically convert third-party libraries to use AndroidX
android.enableJetifier=true

  2. अपने build.gradle में Jetpack लाइब्रेरी डिपेंडेंसी जोड़ें:

    app/build.gradle

    dependencies {
 implementation "androidx.core:core:1.6.0"
 implementation "androidx.core:core-google-shortcuts:1.0.1"
 ...
}

    पिछले सैंपल कोड में, आपने दो Jetpack लाइब्रेरी को इस तरह सूची में जोड़ा है निर्भरता. androidx.core:core:1.6.0 लाइब्रेरी में ShortcutManagerCompat क्लास का इस्तेमाल करती है, जिसका इस्तेमाल डाइनैमिक शॉर्टकट को पुश करने के लिए किया जाता है Google.

    androidx.core:core-google-shortcuts:1.0.1 ही Google है Shortcuts इंटिग्रेशन लाइब्रेरी. इस लाइब्रेरी में डेवलपर के लिए उपलब्ध कोई जानकारी मौजूद नहीं है एपीआई. इसे डिपेंडेंसी के तौर पर जोड़ने पर, Assistant को वे डाइनैमिक शॉर्टकट जिन्हें आपने ShortcutManagerCompat क्लास का इस्तेमाल करके पुश किया है.

डाइनैमिक शॉर्टकट पुश करें

Assistant पर दिखाने की ज़रूरी शर्तें पूरी करने वाले डाइनैमिक शॉर्टकट को पुश करने के लिए, आपको सबसे पहले ShortcutInfoCompat.Builder() का इस्तेमाल करके शॉर्टकट बनाना होगा क्लास.

फिर आप शॉर्टकट का उपयोग करके ShortcutManagerCompat.pushDynamicShortcut() तरीका. शॉर्टकट पुश किए जाते हैं जब कोई उपयोगकर्ता आपके ऐप्लिकेशन में कोई काम की कार्रवाई करता है. नीचे दिया गया सैंपल जब भी कोई उपयोगकर्ता खाने की डिलीवरी करने वाले ऐप्लिकेशन में ऑर्डर करता है, तो कोड एक शॉर्टकट पुश करता है:

ExampleOrderActivity

Kotlin

// Define the dynamic shortcut for a menu item
var intent = Intent(context, DisplayOrderActivity::class.java)
intent.action = Intent.ACTION_VIEW
var shortcutInfo = ShortcutInfoCompat.Builder(context, id)
    .setShortLabel("Cappuccino")
    .setLongLabel("Order another cappuccino")
    .addCapabilityBinding(
        "actions.intent.ORDER_MENU_ITEM", "menuItem.name", Arrays.asList("cappuccino")
    )
    .setIntent(intent) // Push the shortcut
    .build()

// Push the shortcut
ShortcutManagerCompat.pushDynamicShortcut(context, shortcutInfo)

Java

// Define the dynamic shortcut for a menu item
Intent intent = new Intent(context, DisplayOrderActivity.class);
intent.setAction(Intent.ACTION_VIEW);

ShortcutInfoCompat.Builder shortcutInfo = new ShortcutInfoCompat.Builder(context, id)
    .setShortLabel("Cappuccino")
    .setLongLabel("Order another cappuccino")
    .addCapabilityBinding(
      "actions.intent.ORDER_MENU_ITEM", "menuItem.name", Arrays.asList("cappuccino"))
    .setIntent(intent)
    .build();

// Push the shortcut
ShortcutManagerCompat.pushDynamicShortcut(context, shortcutInfo);

id का रेफ़रंस, पहले दिए गए ShortcutInfoCompat.Builder तरीके में दिया गया है सैंपल कोड, शॉर्टकट ऑब्जेक्ट के shortcutId के बारे में बताता है. यह id लिटरल वैल्यू वाला एक यूनीक स्ट्रिंग होना चाहिए. जानकारी के लिए, यह देखें Android Shortcuts से जुड़ा दस्तावेज़.

पिछले उदाहरण में, addCapabilityBinding तरीका डाइनैमिक को बाइंड करने के लिए इस्तेमाल किया गया है में परिभाषित समान android:name के capability का शॉर्टकट shortcuts.xml. इस तरीके से आप शॉर्टकट को सिमैंटिक बिल्ट-इन इंटेंट (बीआईआई) पैरामीटर.

डाइनैमिक शॉर्टकट को कभी-कभी किसी खास बीआईआई पैरामीटर के बिना पुश किया जाता है असोसिएशन. जब उपयोगकर्ता कॉल करता है, तब Assistant तय किए गए intent को ट्रिगर करती है शॉर्टकट का इस्तेमाल करके, उस कार्रवाई को पूरा किया जा सकता है. नीचे दिए गए उदाहरण में डाइनैमिक है शॉर्टकट, जिसमें कोई पैरामीटर संबंध न हो:

Kotlin

var intent: Intent = Intent(context, DisplayOrderActivity::class.java)
intent.setPackage(this, "com.sample.app")
intent.setAction(Intent.ACTION_VIEW)

var shortcutInfo: ShortcutInfoCompat = ShortcutInfoCompat.Builder(context, id)
    .setShortLabel("Order coffee")
    .setLongLabel("Order a cup of coffee")
    .addCapabilityBinding("actions.intent.ORDER_MENU_ITEM")
    .setIntent(intent)
    .build()

ShortcutManagerCompat.pushDynamicShortcut(context, shortcutInfo);

Java

Intent intent = new Intent(context, DisplayOrderActivity.class);
intent.setPackage(this, "com.sample.app");
intent.setAction(Intent.ACTION_VIEW);

ShortcutInfoCompat shortcutInfo = new ShortcutInfoCompat.Builder(context, id)
  .setShortLabel("Order coffee")
  .setLongLabel("Order a cup of coffee")
  .addCapabilityBinding("actions.intent.ORDER_MENU_ITEM")
  .setIntent(intent)
  .build();

ShortcutManagerCompat.pushDynamicShortcut(context, shortcutInfo);

Assistant की मदद से डाइनैमिक शॉर्टकट की जांच करें

जब Google Assistant आपके यह शॉर्टकट, Assistant का Android ऐप्लिकेशन. Assistant ऐप्लिकेशन, हाल ही में इस्तेमाल किए गए शॉर्टकट के सुझाव देता है पुश नोटिफ़िकेशन लागू नहीं किया.

Assistant की मदद से अपने डाइनैमिक शॉर्टकट की जांच करने के लिए, यह तरीका अपनाएं:

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