मूड

स्मार्ट होम इंटेंट, आसान मैसेज सेवा ऑब्जेक्ट हैं. इनसे पता चलता है कि smart homeक्या कार्रवाई करनी है. जैसे, लाइट चालू करना या स्पीकर पर ऑडियो कास्ट करना.

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 सेवाओं को भेजती हैं.
    इसके बाद, ये सेवाएं होम ग्राफ़ में सेव हो जाती हैं.
पहली इमेज: Google और पार्टनर इन्फ़्रास्ट्रक्चर के बीच इंटरैक्शन

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

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

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

QUERY

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

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

QUERY इंटेंट का फ़्लो डायग्राम
इमेज 3: QUERY इंटेंट

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

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

प्लान करें

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

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

किसी इस्तेमाल किए जा सकने वाले इंटेंट का फ़्लो डायग्राम
इमेज 5: अनुमानित इंटेंट

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

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