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