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