मूड

स्मार्ट होम इंटेंट, मैसेजिंग ऑब्जेक्ट होते हैं. इनसे पता चलता है कि Cloud-to-cloud को कौनसा इंटिग्रेशन करना है. जैसे, लाइट चालू करना या स्पीकर पर ऑडियो कास्ट करना.

smart home के सभी इंटेंट, action.devices नेमस्पेस में शामिल होते हैं. आपको उनके लिए फ़ुलफ़िलमेंट उपलब्ध कराना होगा. जब भी Google Assistant, इंटेंट को पूरा करने के लिए भेजता है, तो उपयोगकर्ता का तीसरे पक्ष का OAuth 2 ऐक्सेस टोकन, अनुमति देने वाले हेडर में पास किया जाता है.

ये इस्तेमाल किए जा सकने वाले smart home इंटेंट हैं:

सिंक करें

action.devices.SYNC इंटेंट का इस्तेमाल, उपयोगकर्ता के कनेक्ट किए गए और इस्तेमाल के लिए उपलब्ध smart home डिवाइसों की सूची का अनुरोध करने के लिए किया जाता है.

जब कोई उपयोगकर्ता Google Home app (GHA) की मदद से अपने डिवाइस सेट अप करता है, तो आपके क्लाउड इन्फ़्रास्ट्रक्चर के लिए भी उसकी पुष्टि हो जाती है. इसके बाद, Assistant को OAuth2 टोकन मिलता है. इस समय, Assistant आपके क्लाउड इन्फ़्रास्ट्रक्चर से उपयोगकर्ता के डिवाइसों और उनकी सुविधाओं की शुरुआती सूची पाने के लिए, आपके फ़ुलफ़िलमेंट को action.devices.SYNC इंटेंट भेजता है.

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

किसी उपयोगकर्ता के खाते को अनलिंक और फिर से लिंक करने से बचने के लिए, Assistant पर सिंक करने का अनुरोध भेजा जा सकता है. इससे आपके फ़ुलफ़िलमेंट को action.devices.SYNC इंटेंट भेजा जाता है, ताकि डिवाइसों और उनकी सुविधाओं की सूची को सिंक किया जा सके. ज़्यादा जानकारी के लिए, सिंक करने का अनुरोध लागू करना देखें.

SYNC इंटेंट का फ़्लो डायग्राम
दूसरी इमेज: SYNC इंटेंट

लोकल फ़ुलफ़िलमेंट सेटअप के दौरान, Local Home प्लैटफ़ॉर्म, आपकी smart home कार्रवाई के क्लाउड फ़ुलफ़िलमेंट से मिले SYNC जवाब की जांच करता है. स्थानीय फ़ुलफ़िलमेंट की सुविधा के साथ काम करने के लिए, SYNC के जवाब में बदलाव करने के तरीके के बारे में ज़्यादा जानने के लिए, क्लाउड फ़ुलफ़िलमेंट में SYNC के जवाब को अपडेट करना लेख पढ़ें.

QUERY

action.devices.QUERY इंटेंट का इस्तेमाल, smart home डिवाइसों की मौजूदा स्थिति के बारे में क्वेरी करने के लिए किया जाता है.

जब उपयोगकर्ता डिवाइस के स्टेटस के बारे में सवाल पूछते हैं, तो उनके जवाब देने के लिए, जैसे कि Ok Google, रसोई में कौनसी लाइटें चालू हैं?, Assistant, आपके फ़ुलफ़िलमेंट को action.devices.QUERY इंटेंट भेजता है.

क्वेरी इंटेंट का फ़्लो डायग्राम
तीसरी इमेज: क्वेरी का इंटेंट

बेहतर उपयोगकर्ता अनुभव के लिए, आपको Report State को लागू करना चाहिए. इससे उपयोगकर्ता के डिवाइसों की मौजूदा स्थिति की जानकारी, सीधे Google Home Graph को दी जा सकती है. उदाहरण के लिए, इससे Assistant को यह पता चलता है कि उपयोगकर्ता ने स्मार्ट लाइट को चालू करने के लिए, लाइट के फ़िज़िकल स्विच का इस्तेमाल किया है या नहीं.

Report State का इस्तेमाल करके, डिवाइस की स्थिति की जानकारी देना
चौथी इमेज: डिवाइस की स्थिति की रिपोर्ट

EXECUTE

action.devices.EXECUTE इंटेंट का इस्तेमाल, smart home डिवाइसों पर निर्देश देने के लिए किया जाता है.

जब उपयोगकर्ता Assistant की मदद से डिवाइसों को निर्देश भेजते हैं, तो आपके फ़ुलफ़िलमेंट को action.devices.EXECUTE इंटेंट मिलता है. इसमें कार्रवाई और उन डिवाइसों के बारे में बताया जाता है जिन पर कार्रवाई करनी है. कोई उपयोगकर्ता किसी डिवाइस पर कोई कार्रवाई करने के लिए, Ok Google, मेरे लिविंग रूम की लाइटें चालू करो जैसा निर्देश दे सकता है.

EXECUTE इंटेंट का फ़्लो डायग्राम
पांचवीं इमेज: EXECUTE इंटेंट

डिसकनेक्ट करें

action.devices.DISCONNECT इंटेंट को ट्रिगर करके, आपको यह जानकारी दी जाती है कि किसी उपयोगकर्ता ने Assistant से ऐप्लिकेशन खाते को अनलिंक कर दिया है. action.devices.DISCONNECT इंटेंट मिलने के बाद, आपको इस उपयोगकर्ता के डिवाइसों की स्थिति की जानकारी नहीं देनी चाहिए.