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