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

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

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

जब आप अपने ऐप्लिकेशन में 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 क्लास का इस्तेमाल करके पुश किया है.

   ध्यान दें: Core और Google Shortcuts इंटिग्रेशन लाइब्रेरी के सबसे नए वर्शन ढूंढने के लिए, Jetpack लाइब्रेरी एक्सप्लोरर पर जाएं.

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

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

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

ExampleOrderActivity

Kotlin

// Define the dynamic shortcut for an item
var intent = Intent(context, DisplayOrderActivity::class.java)
intent.action = Intent.ACTION_VIEW
var shortcutInfo = ShortcutInfoCompat.Builder(context, id)
    .setShortLabel("Running")
    .setLongLabel("Start running")
    .addCapabilityBinding(
        "actions.intent.CREATE_ITEM_LIST", "itemList.name", Arrays.asList("My First List")
    )
    .setIntent(intent) // Push the shortcut
    .build()

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

Java

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

ShortcutInfoCompat.Builder shortcutInfo = new ShortcutInfoCompat.Builder(context, id)
    .setShortLabel("Running")
    .setLongLabel("Start running")
    .addCapabilityBinding(
      "actions.intent.CREATE_ITEM_LIST", "itemList.name", Arrays.asList("My First List"))
    .setIntent(intent)
    .build();

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

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

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

कभी-कभी डाइनैमिक शॉर्टकट, किसी खास BII पैरामीटर के असोसिएशन के बिना भी पुश किए जाते हैं. जब उपयोगकर्ता कॉल करता है, तब 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("Create a list")
    .setLongLabel("Create a list")
    .addCapabilityBinding("actions.intent.CREATE_ITEM_LIST")
    .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("Create a list")
  .setLongLabel("Create a list")
  .addCapabilityBinding("actions.intent.CREATE_ITEM_LIST")
  .setIntent(intent)
  .build();

ShortcutManagerCompat.pushDynamicShortcut(context, shortcutInfo);

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

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

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

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