ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों के लिए पहले से मौजूद इंटेंट

बिल्ट-इन इंटेंट (बीआईआई) की मदद से आपका ऐप्लिकेशन, ग्राहक को आइटम भेजने की अपनी क्षमताओं की जानकारी दे सकता है अपने Pixel डिवाइस के अनुभव को बेहतर बनाने में मदद करें. अपनी शॉर्टकट.xml फ़ाइल में क्षमताओं की जानकारी देकर और इंटेंट पैरामीटर को फ़ुलफ़िलमेंट में मैप करते हैं, तो ऐसा जब Google Assistant, क्वेरी पूछी जाती है, ताकि उपयोगकर्ता टास्क पूरा कर सके.

बिल्ट-इन इंटेंट को ऐप्लिकेशन की कैटगरी के हिसाब से ग्रुप किया जाता है. हर कैटगरी सामान्य कामों के एक सेट को दिखाता है, जिसे उपयोगकर्ता अक्सर अपने दिखाई देता है. उपलब्ध बीआईआई की पूरी सूची, उनके पैरामीटर, और उदाहरण जिन क्वेरी की जांच की जा सकती है वे बिल्ट-इन इंटेंट रेफ़रंस में मौजूद होती हैं.

कई बीआईआई के डिप्लॉयमेंट की खास शर्तें होती हैं. साथ ही, देखें. इन ज़रूरी शर्तों और सुझावों से, आपके ऐप्लिकेशन को उपयोगकर्ताओं को बेहतरीन अनुभव दे सकें.

पहली इमेज. START_EXERCISE बीआईआई को बोलकर शुरू करें Assistant से सवाल पूछें.

दूसरी इमेज. ऐप्लिकेशन को किसी खास स्क्रीन पर लॉन्च करें START_EXERCISE टास्क शुरू करने के लिए.

तीसरी इमेज. किसी क्वेरी के जवाब में विजेट दिखाएं.

​

बीआईआई लागू करना और इंटेंट पैरामीटर को हैंडल करना

ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों के लिए, क्षमताओं की जानकारी दी जाती है और बीआईआई पैरामीटर को हैंडल किया जाता है शॉर्टकट.xml फ़ाइल में. बीआईआई को लागू करना और पैरामीटर को एक्सपोर्ट करने के लिए, यह तरीका अपनाएं:

1. चुने गए बीआईआई के साथ capability के बारे में बताएं.
2. हर उस बीआईआई फ़ील्ड के लिए, नेस्ट किए गए parameter एलिमेंट जोड़ें जिन्हें आपको जोड़ना है.
   1. अगर targetClass या targetPackage का इस्तेमाल किया जा रहा है, तो उन्हें Android पर मैप करें इंटेंट extras का इस्तेमाल करके अपने चुने हुए नाम का इस्तेमाल करें.
   2. डीप लिंक यूआरएल का इस्तेमाल करने पर, क्वेरी में नाम वाले पैरामीटर का इस्तेमाल करें स्ट्रिंग डालें.

बीआईआई पैरामीटर को हैंडल करने के लिए, बीआईआई पैरामीटर को आपके capability में किसी साफ़ Android इंटेंट का पैरामीटर भी होना चाहिए. इसके बाद, अपने ऐप्लिकेशन में इसकी वैल्यू का इस्तेमाल किया जा सकता है. आपके ऐप्लिकेशन को हैंडल करने की ज़रूरत नहीं है बीआईआई पैरामीटर. हालांकि, "सुझाया गया" के तौर पर मार्क किए गए डेटा फ़ील्ड को मैनेज करने की कोशिश करें पहले से मौजूद इंटेंट के रेफ़रंस में.

आपके पास कई इंटेंट फ़ुलफ़िलमेंट को तय करने का विकल्प है. हर इंटेंट के अपने सेट के साथ सुझाए गए पैरामीटर. Google, वाहन बेचने के तरीके के आधार पर सही ग्राहक को आइटम भेजता है क्षमता पैरामीटर, जिसे यह उपयोगकर्ता की क्वेरी और बताए गए पैरामीटर से पहचानता है इंटेंट के हिसाब से.

उदाहरण के लिए, actions.intent.START_EXERCISE इंटेंट का सुझाव है कि आपका ऐप्लिकेशन exercise.name बीआईआई पैरामीटर को हैंडल करे, लेकिन आपके ऐप्लिकेशन में बिना किसी पैरामीटर के बीआईआई लागू कर सकता है. अगर आपको खास जानकारी के बिना उपयोगकर्ता क्वेरी को मैनेज करना है, तो यह किया जा सकता है कसरत का नाम, जैसे कि "पूछे जाने वाले ऐप्लिकेशन में कसरत को ट्रैक करने के लिए कहें."

कॉन्टेंट बनाने इस स्निपेट में, बिना किसी ज़रूरी पैरामीटर के फ़ुलबैक के तौर पर फ़ॉलबैक दिया गया है अगर उपयोगकर्ता की क्वेरी में पैरामीटर शामिल नहीं हैं:

<?xml version="1.0" encoding="utf-8"?>
<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:targetClass="com.example.myapplication.Activity1"
            android:targetPackage="com.example.myapplication">
            <parameter
                android:name="exercise.name"
                android:key="exerciseType"
                android:required="true"
                />
        </intent>
        <intent
            android:action="android.intent.action.VIEW"
            android:targetClass="com.example.myapplication.Activity2">
        </intent>
    </capability>
</shortcuts>

Google Assistant, ग्राहकों को सबसे काम की जानकारी देने की पूरी कोशिश करती है उपयोगकर्ता आपके ऐप्लिकेशन में पैरामीटर मान लौटाते समय उपयोगकर्ता. उदाहरण के लिए, उपयोगकर्ता क्वेरी उदाहरण रेस्टोरेंट के मोबाइल ऐप से पिज़्ज़ा ऑर्डर करने के लिए हमेशा स्थान. उपयोगकर्ता को बेहतर सेवा देने के लिए, Assistant अक्षांश की जानकारी दे सकती है और उस ऐप्लिकेशन के निकटतम Example Restaurant के देशांतर वैल्यू.

एक अतिरिक्त शर्त के तौर पर, आपको नहीं चाहिए कि आपका ऐप्लिकेशन, सीधे ऐसी कार्रवाई जिससे उपयोगकर्ता की असल ज़िंदगी में बदलाव होता हो. उदाहरण के लिए, ट्रांसफ़र करना पैसे चुकाने, ऑर्डर करने या मैसेज भेजने से पहले पुष्टि करें कि उपयोगकर्ता से संपर्क करते हैं.

ध्यान दें: ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयां, जैसे कि पहले से मौजूद इंटेंट के साथ काम करने वाली सभी कार्रवाइयां, कई बातों पर निर्भर करता है. इनमें क्वालिटी और उपयोगकर्ता के अनुरोध के हिसाब से काम करना शामिल है. इन बातों के आधार पर, Google यह तय करने के लिए आपकी कार्रवाई कर सकता है कि वह कार्रवाई उपयोगकर्ताओं के अनुरोध शामिल हैं.

साफ़ तौर पर जानकारी देना

<url-parameter> या इंटेंट एक्स्ट्रा के ज़रिए आपके ऐप्लिकेशन को दिए गए आर्ग्युमेंट उस आइटम की खास तौर पर पहचान करें जिसे आपको उपयोगकर्ता को दिखाना है. इस मामले में, तर्क मान का उपयोग खोज तर्क के रूप में करें और उपयोगकर्ता को खोज पर ले जाएं पेज पर जा सकते हैं. वे उसमें साफ़ तौर पर अंतर कर सकते हैं और सही आइटम चुन सकते हैं.

उदाहरण के लिए, अगर उपयोगकर्ता की क्वेरी “Example Restaurant से ऑर्डर करें” है बीआईआई ORDER_MENU_ITEM, आपके पास उपयोगकर्ता को रेस्टोरेंट जिनके नाम "Example Restaurant" शब्द से मेल खाते हैं.

भाषा और स्थान-भाषा की सुविधा

हर ऐप्लिकेशन ऐक्शन बीआईआई की मदद से डेवलप और टेस्ट करने के लिए इस्तेमाल होने वाली स्थान-भाषाएं बिल्ट-इन इंटेंट रेफ़रंस में दी गई सूची है. कुछ बीआईआई अलग होते हैं डेवलपर टेस्टिंग के लिए और Assistant से उपयोगकर्ता ट्रिगर करने के लिए स्थानीय सहायता.