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