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

shortcuts.xml में मौजूद सुविधाओं की मदद से, यह बताया जा सकता है कि उपयोगकर्ता आपके ऐप्लिकेशन को लॉन्च करने और सीधे किसी खास टास्क को पूरा करने के लिए, किस तरह की कार्रवाइयां कर सकते हैं.

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

shortcuts.xml में सुविधाओं के बारे में बताना

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

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

2. अपनी क्षमता में यह ज़रूरी जानकारी शामिल करें:

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

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

   • पैरामीटर की मैपिंग: हर 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 BII की जानकारी मिलती है. अगर कोई उपयोगकर्ता Assistant से यह बोलकर, इस बीआईआई को शुरू करता है, "Ok Google, ExampleApp में रन बनाओ," Assistant उपयोगकर्ता के अनुरोध को पूरा करने के लिए इनका इस्तेमाल करती है नेस्ट किए गए intent एलिमेंट में दी गई जानकारी. इस सैंपल में intent, इन चीज़ों की जानकारी देता है:

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

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

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

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