shortcuts.xml में मौजूद सुविधाओं की मदद से, यह तय किया जा सकता है कि उपयोगकर्ता किन कार्रवाइयों को करके आपका ऐप्लिकेशन लॉन्च कर सकते हैं और सीधे कोई खास टास्क पूरा कर सकते हैं.
उदाहरण के लिए, Google Assistant की ऐप्लिकेशन कार्रवाइयों की सुविधाओं का इस्तेमाल करके डेवलपर, ऐप्लिकेशन में मौजूद सुविधाओं को पहले से मौजूद इंटेंट (बीआईआई) तक पहुंचा सकते हैं. इससे उपयोगकर्ता, बोलकर दिए गए निर्देशों का इस्तेमाल करके उन सुविधाओं को चालू और कंट्रोल कर सकते हैं. किसी सुविधा में, कार्रवाई का नाम और आपके ऐप्लिकेशन में मौजूद डेस्टिनेशन को टारगेट करने वाला intent शामिल होता है. इससे उपयोगकर्ता के मकसद को पूरा किया जा सकता है.
shortcuts.xml फ़ाइल में सुविधाओं के बारे में जानकारी देना
capability एलिमेंट को, Android ऐप्लिकेशन डेवलपमेंट प्रोजेक्ट में मौजूद shortcuts.xml रिसॉर्स फ़ाइल में तय किया जाता है. capability एलिमेंट को तय करने के लिए, यह तरीका अपनाएं:
- स्टैटिक शॉर्टकट बनाएं में दिए गए निर्देशों का पालन करके,
shortcuts.xmlसंसाधन बनाएं. अपनी सुविधा में यह ज़रूरी जानकारी शामिल करें:
क्षमता का नाम: वह कार्रवाई जिसे आपको अपने ऐप्लिकेशन में शामिल करना है. उस सुविधा के कॉम्पोनेंट का दस्तावेज़ देखें जिसके लिए क्षमता की परिभाषाएं ज़रूरी हैं. ऐप्लिकेशन की कार्रवाइयों के लिए, आवाज़ से कंट्रोल की जा सकने वाली सुविधाओं के नाम के लिए, BII
Action IDका इस्तेमाल किया जाता है. इसे BII के रेफ़रंस में देखा जा सकता है. उदाहरण के लिए,GET_THINGबीआईआई, अपनेAction IDकोactions.intent.GET_THINGके तौर पर दिखाता है.ऐप्लिकेशन डेस्टिनेशन: आपके ऐप्लिकेशन में वह डेस्टिनेशन जहां उपयोगकर्ता के अनुरोध को पूरा करने के लिए कार्रवाई शुरू होती है.
intentमें नेस्ट किए गए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 से "ठीक है 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, exercise.name पैरामीटर के लिए "run" की मान्य एक्सरसाइज़ इकाई को तय करता है.
ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों से शॉर्टकट जोड़ने के बारे में ज़्यादा जानने के लिए, ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों की खास जानकारी देखें.