स्मार्ट होम ऐक्शन बनाने का तरीका जानने की नई जगह, Google Home डेवलपर सेंटर में आपका स्वागत है. ध्यान दें: Actions कंसोल में कार्रवाइयां बनाना जारी रहेगा.

मूड

स्मार्ट होम इंटेंट, मैसेज भेजने के लिए इस्तेमाल होने वाले आसान ऑब्जेक्ट हैं. इनसे पता चलता है कि 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 को भेजने का मकसद मिलता है. ज़्यादा जानकारी के लिए, अनुरोध सिंक करना लागू करना देखें.

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

स्थानीय वाहन बेचने का तरीका सेट अप करते समय, स्थानीय होम प्लैटफ़ॉर्म अपने smart home Action के Cloud fulfillment से मिले SYNC रिस्पॉन्स की जांच करता है. स्थानीय शिपिंग की सुविधा देने वाली सुविधा के लिए, SYNC के जवाब में बदलाव करने के तरीके के बारे में ज़्यादा जानने के लिए, क्लाउड में नतीजे भेजने से जुड़े सिंक के जवाब को अपडेट करना देखें.

QUERY

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

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

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

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

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

एक्ज़ीक्यूट करें

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

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

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

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

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