मूड

स्मार्ट होम इंटेंट, मैसेजिंग के ऐसे ऑब्जेक्ट होते हैं जिनसे यह पता चलता है कि क्या 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 के जवाब को अपडेट करना लेख पढ़ें.

QUERY

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 इंटेंट मिलता है. इससे, कार्रवाई और उन डिवाइसों के बारे में पता चलता है जिन पर कार्रवाई करनी है. कोई उपयोगकर्ता, 'Hey Google, मेरे लिविंग रूम की लाइटें चालू करो' जैसे कमांड से किसी डिवाइस पर कोई कार्रवाई कर सकता है.

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

DISCONNECT

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