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.property

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

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

   ऐप्लिकेशन/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

// 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)

// 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. इस तरीके से, शॉर्टकट को किसी बिल्ट-इन इंटेंट (बीआईआई) पैरामीटर से जोड़ा जा सकता है.

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

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);

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 की सेटिंग ऐप्लिकेशन में जाकर शॉर्टकट खोलें. आपका डाइनैमिक शॉर्टकट, आपके ऐप्लिकेशन की सूची में दिखता है.