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

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

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

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

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

स्टैटिक शॉर्टकट बनाएं में दिए गए निर्देशों का पालन करके, shortcuts.xml संसाधन बनाएं.
अपनी सुविधा में यह ज़रूरी जानकारी शामिल करें:
- क्षमता का नाम: वह कार्रवाई जो आपको अपने ऐप्लिकेशन के लिए चाहिए. उस सुविधा के कॉम्पोनेंट का दस्तावेज़ देखें जिसके लिए क्षमता की परिभाषाएं ज़रूरी हैं. ऐप्लिकेशन की कार्रवाइयों के लिए, बोलकर इस्तेमाल की जाने वाली सुविधाओं के नाम के लिए, बीआईआई 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 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 के किसी इंस्टेंस को लॉन्च करने के लिए शॉर्टकट का इस्तेमाल कर सकती है. यह capability पैरामीटर के लिए, "run" की मान्य कसरत इकाई को तय करता है.exercise.name

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