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

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

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

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

  1. स्टैटिक शॉर्टकट बनाएं में दिए गए निर्देशों का पालन करके, shortcuts.xml संसाधन बनाएं.
  2. अपनी सुविधा में यह ज़रूरी जानकारी शामिल करें:

    • क्षमता का नाम: वह कार्रवाई जो आपको अपने ऐप्लिकेशन में करनी है. जिस सुविधा के लिए क्षमता की परिभाषाएं ज़रूरी हैं उसके कॉम्पोनेंट का दस्तावेज़ देखें.

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

    • पैरामीटर मैपिंग: हर intent में ऐसे पैरामीटर हो सकते हैं जिन्हें इंटेंट के extra डेटा के तौर पर पास किया जाना है.

यहाँ दिए गए उदाहरण में, shortcuts.xml में किसी सुविधा की परिभाषा दी गई है. यह actions.intent.START_EXERCISE के लिए है. यह एक ऐसा BII है जिसकी मदद से उपयोगकर्ता, फ़िटनेस ऐप्लिकेशन में कसरत शुरू करने के लिए, 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 में दौड़ शुरू करो" कहकर इस BII को चालू करता है, तो Assistant, नेस्ट किए गए intent एलिमेंट में दी गई जानकारी का इस्तेमाल करके उपयोगकर्ता के अनुरोध को पूरा करती है. इस सैंपल में मौजूद intent से यह जानकारी मिलती है:

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

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

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