Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

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

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

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

ऊपर दिए गए उदाहरण में, <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 में दौड़ना शुरू करो" कहकर, फ़िटनेस ट्रैकिंग ऐप्लिकेशन में दौड़ना शुरू करता है. Assistant, शॉर्टकट का इस्तेमाल करके capability का कोई इंस्टेंस लॉन्च कर सकती है. यह इंस्टेंस, exercise.name पैरामीटर के लिए "दौड़ना" कसरत की मान्य इकाई तय करता है.