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