मूड

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

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

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

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

QUERY

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

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

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

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

रिपोर्ट स्थिति का इस्तेमाल करके डिवाइस की स्थिति की रिपोर्ट करना
इमेज 4: डिवाइस की स्थिति रिपोर्ट करें

खत्म करें

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

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

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

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

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