Google Home प्लेग्राउंड

डिवाइस का SDK टूल

Google Home Playground एक वेब ऐप्लिकेशन है, जो कॉन्फ़िगर किए जा सकने वाले डिवाइस टाइप और विशेषताओं वाले स्मार्ट होम प्रोजेक्ट की नकल करता है. वर्चुअल डिवाइस बनाए जा सकते हैं, डिवाइस के एट्रिब्यूट और स्थितियों में बदलाव किया जा सकता है, इन डिवाइसों को Google Home Graph में देखा जा सकता है, और डिवाइस कॉन्फ़िगरेशन को इंपोर्ट या एक्सपोर्ट किया जा सकता है.

खाता जोड़ने की प्रोसेस पूरी करें

Google Home Playground का इस्तेमाल करने के लिए, हमारा सुझाव है कि आप पहले टूल को अपने खाते से जोड़ें. अपने फ़ोन पर Google Home app (GHA) खोलें और खाता लिंक करने की प्रोसेस को देखें:

  1. सबसे ऊपर बाएं कोने में मौजूद, प्लस (+) आइकॉन पर क्लिक करें.
  2. डिवाइस सेट अप करें > Google के साथ काम करता है चुनें.
  3. Google Home Playground टाइटल वाला ऐक्शन खोजें.
  4. कार्रवाई चुनें और GHA आपको साइन-इन पेज पर भेज देगा. Google से साइन इन करें पर क्लिक करें और साइन इन करने के लिए अपना खाता चुनें.
  5. खाता जोड़ने की अनुमति देने के लिए, अनुमति दें बटन पर क्लिक करें.
इस डायग्राम में दिखाया गया है कि Google Home Playground को कनेक्ट करने के लिए,
            Google Home ऐप्लिकेशन का खाता कैसे लिंक किया जाता है.

खाता लिंक करने के बाद, GHA पर डिफ़ॉल्ट वर्चुअल डिवाइसों का एक सेट दिखेगा, ताकि आप उनसे इंटरैक्ट कर सकें.

इस डायग्राम में डिवाइस की डिफ़ॉल्ट सूची दिखाई गई है. यह सूची तब भर जाती है, जब कोई उपयोगकर्ता Google Home Playground को अपने खाते से लिंक करता है.

साइन इन करना

नीचे दिया गया बटन क्लिक करके Google Home Playground लॉन्च करें:

प्लेग्राउंड लॉन्च करना

Sign in with Google पर क्लिक करें. खाता जोड़ने की प्रोसेस को पूरा करने के लिए, उसी खाते से साइन इन करें जिसका इस्तेमाल आपने GHA में किया था.

इस डायग्राम में Google Home Playground की शुरुआती स्थिति दिखाई गई है. साथ ही, ऊपर दाएं कोने में मौजूद 'साइन इन करें' बटन को हाइलाइट किया गया है.

साइन इन करने के बाद, Google Home Playground Home Graph में सेव किए गए वर्चुअल डिवाइस दिखाएगा.

इस इमेज में डिवाइस की सूची, डिवाइस की जानकारी, और Google Home Playground के डिफ़ॉल्ट व्यू के लॉग एरिया
            को दिखाया गया है.

वेब यूआई में तीन पैनल होते हैं:

  • डिवाइस की सूची में, आपके सभी वर्चुअल डिवाइस दिखते हैं. इस पैनल की मदद से, किसी वर्चुअल डिवाइस की जानकारी देखने और वर्चुअल डिवाइस बनाने के लिए, उसे चुनें.
  • डिवाइस की जानकारी, चुने गए वर्चुअल डिवाइस की जानकारी दिखाती है. इस जानकारी में बदलाव भी किया जा सकता है और पैनल के ज़रिए चुने गए वर्चुअल डिवाइस को हटाया भी जा सकता है.
  • लॉग एरिया, Google Home Playground और Home Graph के बीच के इंटरैक्शन लॉग दिखाता है. अनुरोध की जांच करने के लिए लॉग को बड़ा किया जा सकता है और समस्या हल करने के लिए, पेलोड का जवाब दिया जा सकता है.

आभासी उपकरण

वर्चुअल डिवाइस की जानकारी देखना

डिवाइस सूची पैनल में जाकर, वह वर्चुअल डिवाइस चुनें जिसे आपको देखना है. डिवाइस सूची पैनल में जाकर, वह वर्चुअल डिवाइस चुनें जिसे आपको देखना है. डिवाइस की जानकारी पैनल में, उसकी जानकारी को पांच अलग-अलग टैब में दिखाया जाएगा:

  • बुनियादी जानकारी: डिवाइस की टॉप-लेवल की प्रॉपर्टी, जिसमें डिवाइस का टाइप, आईडी, और नाम शामिल हैं.
  • Trait: डिवाइस के साथ काम करने वाले traits.
  • एट्रिब्यूट: डिवाइस के, एट्रिब्यूट से जुड़े एट्रिब्यूट.
  • स्थिति: डिवाइस की सभी स्थितियां.
  • SUV: डिवाइस का उपयोगकर्ता की पुष्टि दूसरे तरीके से करने का कॉन्फ़िगरेशन.

वर्चुअल डिवाइस की जानकारी में बदलाव करना

किसी वर्चुअल डिवाइस की जानकारी देखने के अलावा, डिवाइस की जानकारी पैनल की मदद से, Home Graph में सेव की गई उसकी जानकारी में सीधे बदलाव भी किया जा सकता है.

इस्तेमाल किए जा सकने वाले Trait में बदलाव करें

  1. विशेषताएं चुनें; बदलाव करें बटन पर क्लिक करें.
  2. पॉप-अप पैनल में, आपको डिवाइस पर काम करने वाले traits और जोड़ने के लिए उपलब्ध trait दिखेंगे. डिवाइस में इस्तेमाल किए जा सकने वाले Trait जोड़ने या हटाने के लिए, ऐरो (arrow_forward/arrow_back) बटन का इस्तेमाल करें.
  3. इस्तेमाल किए जा सकने वाले Trait को अपडेट करने के बाद, सेव करें पर क्लिक करें. इसके बाद, अपडेट किए गए Trait Home Graph पर लागू हो जाएंगे.
  4. इन Trait अपडेट को लॉग एरिया में देखा जा सकता है.
यह इमेज UX टूल को दिखाती है. इस टूल की मदद से, Google Home Playground में किसी चुने गए डिवाइस पर
            काम करने वाले Trait को जोड़ा या मिटाया जा सकता है.

डिवाइस की विशेषताओं में बदलाव करें

  1. एट्रिब्यूट टैब चुनें और डिवाइस पर काम करने वाले एट्रिब्यूट के लिए एट्रिब्यूट में बदलाव करें.
  2. बदलाव करने के बाद, Enter दबाएं. एट्रिब्यूट में किए गए बदलाव Home Graph पर लागू हो जाएंगे.
  3. अपडेट किए गए इन एट्रिब्यूट को लॉग एरिया में देखा जा सकता है.

डिवाइस के स्टेट का डेटा बदलें

  1. राज्य टैब चुनें और सीधे राज्य में बदलाव करें. राज्य में किए गए बदलाव, Home Graph पर लागू होंगे.
  2. स्टेटस में किए गए इन बदलावों को लॉग एरिया में देखा जा सकता है.

वर्चुअल डिवाइस में, उपयोगकर्ता की जानकारी की पुष्टि दूसरे तरीके से जोड़ना

आपके पास वर्चुअल डिवाइसों में एसयूवी जोड़ने और इसके चैलेंज टाइप को कॉन्फ़िगर करने का विकल्प है. साथ ही, हर डिवाइस पर उसके हिसाब से व्यवहार भी कॉन्फ़िगर किया जा सकता है. वर्चुअल डिवाइसों में एसयूवी को जोड़ा जा सकता है. साथ ही, हर डिवाइस पर इसके चैलेंज टाइप और उसके व्यवहार को कॉन्फ़िगर किया जा सकता है.

डिवाइस पर SUV कॉन्फ़िगर करें

  1. डिवाइस सूची पैनल में, वह वर्चुअल डिवाइस चुनें जिसे आपको कॉन्फ़िगर करना है.
  2. डिवाइस की जानकारी पैनल में, SUV टैब चुनें और ये चीज़ें कॉन्फ़िगर करें:
    • चालू है: इससे पता चलता है कि डिवाइस पर एसयूवी चालू है या बंद है (कोई चैलेंज नहीं).
    • चुनौती का टाइप: क्या एसयूवी के लिए साफ़ तौर पर पहचान की पुष्टि करना ज़रूरी है (ackNeeded) या व्यक्तिगत पहचान संख्या (pinNeeded) है.
    • पिन: मान्य पिन.
    • गलत पिन इस्तेमाल करना: पिन गलत होने पर, क्या उपयोगकर्ता से फिर से पूछना है या नहीं, अगर नहीं, तो जवाब देने में गड़बड़ी होना.
यह इमेज UX टूल को दिखाती है, जिससे Google Home Playground में चुने गए डिवाइस पर, उपयोगकर्ता की पुष्टि करने के दूसरे तरीकों को चालू किया जा सकता है.

उपयोगकर्ता की जानकारी की पुष्टि दूसरे तरीके से करने (SUV) की सुविधा चालू करने वाले डिवाइसों की पहचान करना

डिवाइस सूची पैनल में, हर एसयूवी की सुविधा वाले डिवाइस के बगल में एक कुंजी आइकॉन कुंजी दिखती है.

इस इमेज में ऐसे डिवाइसों के बारे में बताया गया है जिनका सुझाव, उपयोगकर्ता की जानकारी की पुष्टि दूसरे तरीके से
            चालू करने के लिए किया जाता है.

इन विशेषताओं की सूची के लिए, एसयूवी की ज़रूरत होती है:

नया वर्चुअल डिवाइस बनाएं

  1. डिवाइस सूची पैनल में, डिवाइस जोड़ें पर क्लिक करें.
  2. पॉप-अप पैनल में, डिवाइस का टाइप चुनें और अपने नए डिवाइस के लिए डिवाइस का नाम डालें. इसके अलावा, जोड़ने के लिए डिवाइसों का पहले से तय किया गया सेट भी चुना जा सकता है.
  3. सभी चरणों को पूरा करने के बाद, नए डिवाइस को Home Graph में जोड़ दिया जाएगा.
इस इमेज में दिखाया गया है कि UX टूल किस तरह का है और Google Home Playground में नया डिवाइस टाइप जोड़ा जा सकता है.

वर्चुअल डिवाइस हटाना

  1. डिवाइस सूची पैनल में, वह डिवाइस चुनें जिसे आपको हटाना है. इसके बाद, डिवाइस की जानकारी पैनल में, सामान्य जानकारी टैब को चुनें. इसके बाद, डिवाइस की जानकारी पैनल में जाकर, सामान्य जानकारी टैब चुनें और सबसे नीचे मौजूद ट्रैश का आइकॉनडिवाइस हटाएं पर क्लिक करें.
  2. पॉप-अप सूचना में, डिवाइस हटाए जाने की पुष्टि करें.
  3. आपकी ओर से डिवाइस हटाने की पुष्टि करने के बाद, डिवाइस को Home Graph से हटा दिया जाएगा.
इस डायग्राम में दिखाया गया है कि Google Home Playground से वर्चुअल डिवाइस का टाइप हटाने के लिए UX टूल को कैसे इस्तेमाल किया जाता है.

सिंक के जवाब में बदलाव करने वाला टूल

Google Home Playground में जाकर, सिंक के अपने जवाब की पुष्टि या उसे अपडेट किया जा सकता है. एम्बेड किया गया IDE खोलने के लिए, रिस्पॉन्स एडिटर सिंक करें पर क्लिक करें.

इस डायग्राम में, सिंक के जवाब में बदलाव करने वाला एडिटर खोलने का बटन दिखाया गया है.

सिंक किए गए अपने जवाब में बदलाव करें या उसे कॉपी करके चिपकाएं. बदलाव लागू करने के लिए, सेव करें पर क्लिक करें, ताकि यह देखा जा सके कि वह Google Home नेटवर्क में कैसे काम करता है.

यह इमेज, सिंक के जवाब में बदलाव करने के लिए विंडो दिखाती है.

वर्चुअल डिवाइस को इंपोर्ट और एक्सपोर्ट करना

समस्याओं को हल करने या उन्हें फिर से जनरेट करने के लिए, अपने वर्चुअल डिवाइसों की स्थितियों वाली फ़ाइल को एक्सपोर्ट किया जा सकता है. साथ ही, फ़ाइल को दूसरे लोगों के साथ शेयर किया जा सकता है, ताकि उसे इंपोर्ट किया जा सके और वर्चुअल डिवाइसों को कॉपी किया जा सके.

इस डायग्राम में दिखाया गया है कि Google Home Playground में वर्चुअल डिवाइसों को इंपोर्ट और एक्सपोर्ट करने के लिए UX टूल को कैसे दिखाया जाता है.

वर्चुअल डिवाइसों को किसी फ़ाइल में एक्सपोर्ट करना

  1. वर्चुअल डिवाइस को फ़ाइल में एक्सपोर्ट करने के लिए, पर क्लिक करें.
  2. उस फ़ाइल का नाम डालें जिसे आपको एक्सपोर्ट करना है और ठीक है पर क्लिक करें.
  3. फ़ाइल का नाम डालने के बाद, ब्राउज़र एक्सपोर्ट किए गए वर्चुअल डिवाइसों की फ़ाइल डाउनलोड कर लेगा.

किसी फ़ाइल से वर्चुअल डिवाइस इंपोर्ट करना

  1. किसी फ़ाइल से वर्चुअल डिवाइस इंपोर्ट करने के लिए, पर क्लिक करें.
  2. वह फ़ाइल चुनें जिसे इंपोर्ट करना है और ठीक है पर क्लिक करें.
  3. इंपोर्ट की जाने वाली फ़ाइल की पुष्टि करने के बाद, Google Home Playground वर्चुअल डिवाइसों को फ़ाइल से इंपोर्ट करेगा. साथ ही, इंपोर्ट किए गए डिवाइसों की जानकारी और उनकी स्थितियों को Home Graph में अपडेट करेगा.

इंटरैक्शन लॉग की जांच करें

वर्चुअल डिवाइसों से इंटरैक्ट करने पर, Google Home Playground आपके बदलाव Home Graph पर अपने-आप लागू कर देता है. Home Graph के साथ होने वाले इंटरैक्शन को लॉग एरिया पैनल में रिकॉर्ड किया जाता है. यहां हर एंट्री को बड़ा करके, Home Graph एपीआई अनुरोध और रिस्पॉन्स पेलोड की जांच की जा सकती है.

हर लॉग एंट्री एक JSON कलेक्शन होती है, जिसमें नीचे दिए गए स्ट्रक्चर के एलिमेंट शामिल होते हैं:

{
  "uri": string,
  "request": object,
  "response": object
}
फ़ील्ड टाइप ब्यौरा
uri string Home Graph एपीआई कॉल का यूआरएल.
request object Home Graph एपीआई कॉल के लिए अनुरोध का मुख्य हिस्सा. हर तरीके के फ़ॉर्मैट के बारे में जानने के लिए, रेफ़रंस दस्तावेज़ रेफ़रंस दस्तावेज़ देखें.
response object Home Graph एपीआई कॉल के जवाब का मुख्य हिस्सा. हर तरीके के फ़ॉर्मैट के बारे में जानने के लिए, रेफ़रंस दस्तावेज़ रेफ़रंस दस्तावेज़ देखें.

साथ काम करने वाले डिवाइस के टाइप और traits देखें

सबसे ऊपर दाईं ओर मौजूद, सवाल के निशान सहायता आइकॉन पर, आपको Google Home Playground के साथ काम करने वाले मौजूदा डिवाइस का टाइप और Trait की सूची दिखेगी.

इस इमेज में दिखाया गया है कि UX टूल किस तरह का है और Google Home Playground में नया डिवाइस टाइप जोड़ा जा सकता है.

समस्याओं की शिकायत करना

हम आपकी राय जानना चाहेंगे! समस्याओं की शिकायत करने के लिए, सबसे ऊपर दाईं ओर मौजूद विस्मयादिबोधक चिह्न सुझाव का इस्तेमाल करें.

यह इमेज Google Home Playground में सुझाव/शिकायत/राय देने और समस्याओं की शिकायत करने के लिए आइकॉन दिखाती है.