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

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

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

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

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

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

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

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

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

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

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

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

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

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