मूड

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

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

ये इंटेंट काम करते हैं:smart home

SYNC

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 प्लैटफ़ॉर्म, आपके ऐक्शन के क्लाउड फ़ुलफ़िलमेंट से मिले जवाब की जांच करता है.SYNCsmart home स्थानीय फ़ुलफ़िलमेंट के लिए, SYNC के जवाब में बदलाव करने के तरीके के बारे में ज़्यादा जानने के लिए, क्लाउड फ़ुलफ़िलमेंट में SYNC के जवाब को अपडेट करना लेख पढ़ें.

क्वेरी

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

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

QUERY इंटेंट का फ़्लो डायग्राम
तीसरी इमेज: 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 इंटेंट मिलने के बाद, आपको इस उपयोगकर्ता के डिवाइसों की स्थिति के बारे में जानकारी नहीं देनी चाहिए.