शॉर्टकट में सुविधाएं जोड़ें

shortcuts.xml की क्षमताओं की मदद से, यह बताया जा सकता है कि उपयोगकर्ता किस तरह की कार्रवाइयां कर सकते हैं लें और सीधे कोई ख़ास टास्क करें.

उदाहरण के लिए, Google Assistant की 'ऐप्लिकेशन कार्रवाइयां' सुविधा, डेवलपर को यह सुविधा देने के लिए सुविधाओं का इस्तेमाल करती है ऐप्लिकेशन में मौजूद सुविधाओं को बिल्ट-इन इंटेंट (बीआईआई) तक बढ़ाएं, ताकि उपयोगकर्ता और बोले गए निर्देशों का इस्तेमाल करके उन सुविधाओं को कंट्रोल कर सकते हैं. क्षमता में यह शामिल होता है आपके ऐप्लिकेशन में डेस्टिनेशन को टारगेट करने वाली कार्रवाई का नाम और intent उपयोगकर्ता के इंटेंट का समाधान करता है.

शॉर्टकट.xml में क्षमताओं को तय करें

आप अपनी shortcuts.xml संसाधन फ़ाइल में capability एलिमेंट को तय करते हैं Android ऐप्लिकेशन डेवलपमेंट प्रोजेक्ट. capability एलिमेंट तय करने के लिए, यह करें फ़ॉलो किया जा रहा है:

1. में दिए गए निर्देशों का पालन करके, shortcuts.xml संसाधन बनाएं स्टैटिक शॉर्टकट.

2. अपनी क्षमता में, नीचे दी गई ज़रूरी जानकारी शामिल करें:

   • क्षमता का नाम: वह कार्रवाई जिसके लिए आपको अपने ऐप्लिकेशन से मदद चाहिए. इससे संदर्भ लें उस सुविधा के लिए कॉम्पोनेंट दस्तावेज़ जिसे क्षमता की ज़रूरत होती है परिभाषाएं. ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों के लिए बोलकर दिए जाने वाले निर्देश, बीआईआई Action ID का इस्तेमाल करते हैं दिया गया है, जो आपको बीआईआई के रेफ़रंस में मिल सकता है. उदाहरण के लिए, GET_THING बीआईआई में Action ID को actions.intent.GET_THING के तौर पर बताया गया है.

   • ऐप्लिकेशन डेस्टिनेशन: आपके ऐप्लिकेशन में वह डेस्टिनेशन जहां कार्रवाई लॉन्च होती है उपयोगकर्ता के अनुरोध को पूरा करें. intent एलिमेंट का इस्तेमाल करके, ऐप्लिकेशन के डेस्टिनेशन तय करें capability में नेस्ट किया गया है.

   • पैरामीटर की मैपिंग: हर intent में पैरामीटर शामिल हो सकते हैं इंटेंट के extra डेटा के रूप में पास किया गया. उदाहरण के लिए, ऐप्लिकेशन की हर खास कार्रवाई के लिए बीआईआई इसमें ऐसे फ़ील्ड शामिल होते हैं जो उपयोगकर्ताओं की क्वेरी में अक्सर उपलब्ध कराई जाने वाली जानकारी को दिखाते हैं बीआईआई को ट्रिगर करना है.

यहां दिए गए उदाहरण में, shortcuts.xml में सुविधा की परिभाषा के बारे में बताया गया है actions.intent.START_EXERCISE के लिए, एक बीआईआई है जो लोगों को 'बोलकर दिया गया जवाब' सुविधा का इस्तेमाल करने देता है फ़िटनेस ऐप्लिकेशन में कसरत शुरू करने के लिए, Assistant को ये निर्देश दें:

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
  <capability android:name="actions.intent.START_EXERCISE">
    <intent
      android:action="android.intent.action.VIEW"
      android:targetPackage="com.example.sampleApp"
      android:targetClass="com.example.sampleApp.ExerciseActivity">
      <parameter
        android:name="exercise.name"
        android:key="exerciseType"/>
    </intent>
  </capability>
</shortcuts>

पिछले उदाहरण में, <capability> android:name एट्रिब्यूट इसका मतलब है START_EXERCISE बीआईआई. अगर कोई उपयोगकर्ता Assistant से यह बोलकर, इस बीआईआई को शुरू करता है, "Ok Google, ExampleApp में रन बनाओ," Assistant उपयोगकर्ता के अनुरोध को पूरा करने के लिए इनका इस्तेमाल करती है नेस्ट किए गए intent एलिमेंट में दी गई जानकारी. इस सैंपल में मौजूद intent नीचे दी गई जानकारी के बारे में बताता है:

• android:targetPackage इसके लिए टारगेट ऐप्लिकेशन पैकेज सेट करता है इंटेंट.
• android:targetClass फ़ील्ड, डेस्टिनेशन गतिविधि के बारे में बताता है: com.example.sampleApp.ExerciseActivity.
• इंटेंट parameter, बीआईआई पैरामीटर के साथ काम करने का एलान करता है exercise.name इकट्ठा की गई पैरामीटर वैल्यू को पास करने का तरीका उपयोगकर्ता से—intent में अतिरिक्त डेटा के रूप में.

शॉर्टकट को किसी सुविधा से जोड़ें

किसी सुविधा को तय करने के बाद, उस सुविधा को स्टैटिक या डाइनैमिक शॉर्टकट का इस्तेमाल करें. शॉर्टकट को capability से कैसे लिंक किया जाता है लागू की जा रही सुविधा और उसमें उपयोगकर्ता के अनुरोध पर कार्रवाई करते हैं. उदाहरण के लिए, जब कोई उपयोगकर्ता आपकी फ़िटनेस ट्रैकिंग में दौड़ना शुरू करता है ऐप में Assistant से कहें, "Ok Google, ExampleApp में दौड़ना शुरू करो." असिस्टेंट शॉर्टकट का इस्तेमाल करके, capability के ऐसे इंस्टेंस को लॉन्च कर सकता है जो "रन" की कसरत की इकाई exercise.name पैरामीटर के लिए.

शॉर्टकट को ऐप्लिकेशन की खास सुविधाओं के साथ जोड़ने के बारे में ज़्यादा जानने के लिए, ऐप्लिकेशन की सेटिंग पर जाएं कार्रवाइयों के बारे में खास जानकारी.