Android Studio के लिए Google Home प्लग इन

Google Home Plugin for Android Studio को Google Home Platform के डेवलपर के लिए डिज़ाइन और बनाया गया है. इस प्लग इन की मदद से, आपको Google Assistant Simulator, Cloud Logging, और अन्य टूल का ऐक्सेस मिलता है. इनकी मदद से, स्मार्ट होम डेवलप करने की प्रोसेस को आसान बनाया जा सकता है.

सुरक्षा से जुड़ी सूचना

Android Studio को गुप्त जानकारी और पासवर्ड सेव करने से रोकने के लिए, यह तरीका अपनाएं:

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

सुविधाएं

Assistant सिम्युलेटर

यह जांचने के लिए कि आपके स्मार्ट होम डिवाइस, Google Home के पारिस्थितिक तंत्र के साथ ठीक से काम करते हैं या नहीं, Android Studio से बाहर निकले बिना किसी भी समय Assistant Simulator के साथ इंटरैक्ट किया जा सकता है.

Assistant Simulator की मदद से, अपनी क्वेरी टाइप करके अपने डिवाइसों को आसानी से कंट्रोल किया जा सकता है. उदाहरण के लिए, "लाइट चालू करो." Android Studio में, Assistant Simulator आपके निर्देशों के आधार पर टेक्स्ट मैसेज के ज़रिए जवाब देता है. उदाहरण के लिए, "ठीक है, लाइट चालू की जा रही है."

Cloud Logging देखना

Google Cloud Logging, डीबग करने से जुड़ी जानकारी और मुख्य मेट्रिक उपलब्ध कराता है. इससे आपको अपनी कार्रवाई के इस्तेमाल के बारे में अहम जानकारी मिलती है. डेवलपमेंट को आसान बनाने के लिए, Google Home Plugin, समस्या हल करने के दौरान आपके कोड के बगल में रीयल-टाइम Cloud Logging मैसेज दिखाता है.

रीयल-टाइम लॉग दिखाए जा सकते हैं या तारीख की सीमा चुनी जा सकती है.

एक साथ कई वाक्यांश बोलना

Assistant Simulator किसी एक वाक्य के लिए, जवाब तय नहीं होते. उदाहरण के लिए, जवाब में इनमें से कोई भी वाक्यांश हो सकता है:

• ठीक है, दो लाइटें चालू की जा रही हैं.
• हां, दो लाइटें चालू की जा रही हैं.
• ठीक है, दो लाइटें चालू कर रही हूँ.
• ठीक है, दो लाइटें चालू कर रही हूँ.

अपने-आप चलने वाले टेस्ट चलाने और यह पुष्टि करने के लिए कि आपके Google इंटिग्रेशन, इन अलग-अलग जवाबों के साथ कैसे काम करते हैं, बोली की स्क्रिप्ट चलाकर Assistant Simulator को एक साथ कई वाक्यांश भेजे जा सकते हैं. स्क्रिप्ट सेव होने के बाद, जवाब इकट्ठा किए जा सकते हैं और अपनी क्वेरी के लिए कई टेस्ट चलाए जा सकते हैं.

Home Graph Viewer

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

Android Debug Bridge (adb) लॉग व्यूअर

Adb Log Viewer, लॉग फ़ाइलों को देखने और उनका विश्लेषण करने वाला टूल है. उदाहरण के लिए, Matter डिवाइस की लॉग फ़ाइलें, Google Home लॉग, और Android लॉग.

इंस्टॉल करें

Android Studio में Google Home Plugin इंस्टॉल करने के लिए, यह तरीका अपनाएं:

1. Android Studio डाउनलोड या अपडेट करें. Android Studio डाउनलोड करें लेख पढ़ें
2. फ़ाइल > सेटिंग पर जाएं. MacOS पर, Android Studio > प्राथमिकताएं पर जाएं.
3. प्लग इन सेक्शन में, Marketplace पर जाएं और google home खोजें.
4. टूल इंस्टॉल करें और Android Studio को रीस्टार्ट करें.

प्लग इन को सीधे JetBrains Marketplace से भी डाउनलोड किया जा सकता है.

सेटअप

प्लग इन इंस्टॉल करने के बाद, Assistant Simulator का इस्तेमाल करने और Cloud लॉगिंग देखने से पहले, आपको ये चरण पूरे करने होंगे:

• Google से साइन इन करना
• कोई क्लाउड प्रोजेक्ट चुनना

Google से साइन इन करें

Google Home पैनल से अपने डेवलपर खाते में साइन इन करके, Android Studio को अपनी ओर से Google की सेवाओं के साथ इंटरैक्ट करने की अनुमति दी जा सकती है.

1. Android Studio विंडो की बाईं ओर मौजूद वर्टिकल टैब कॉलम में, Google Home टैब पर क्लिक करें.

2. इससे साइन इन करें के लिए, ब्राउज़र लॉन्च करने के लिए Google पर क्लिक करें.

   

3. वह खाता चुनें जो आपके स्मार्ट होम डिवाइसों से लिंक है.

4. Google से साइन इन करें अनुमति वाले पेज पर, अनुमति दें पर क्लिक करें.

5. ब्राउज़र विंडो बंद करें और Android Studio पर वापस जाएं.

अब आपके पास साइन आउट करें विकल्प के साथ लॉग इन किया गया होगा.

कोई Cloud प्रोजेक्ट चुनना

साइन इन करने के बाद, ड्रॉपडाउन से कोई प्रोजेक्ट चुनें. प्रोजेक्ट की सूची को फ़िल्टर करने के लिए, फ़िल्टर एक्सप्रेशन टाइप करें. उदाहरण के लिए, matter. इसके बाद, Enter दबाएं.

प्रोजेक्ट ड्रॉपडाउन, आपके फ़िल्टर के आधार पर, पहले 100 प्रोजेक्ट लोड करता है. Android Studio से बाहर निकलने पर, आपके चुने गए विकल्प बरकरार रहते हैं.

प्रोजेक्ट फ़िल्टर से जुड़ी मदद पाने के लिए, Google Cloud के रेफ़रंस में क्वेरी पैरामीटर देखें.

Assistant सिम्युलेटर का इस्तेमाल करना

Android Studio में Assistant Simulator खोलने के लिए, Google Home Plugin पैनल में जाकर बोले गए वाक्यांश पैनल पर क्लिक करें.

Assistant Simulator को क्वेरी भेजने के कई तरीके हैं. इसके बाद, हम हर विकल्प के बारे में बताएंगे.

क्वेरी टाइप करना और जवाब इकट्ठा करना

Assistant Simulator के साथ इंटरैक्ट करने के लिए, अपनी क्वेरी टाइप करें और Enter दबाएं.

क्वेरी को फिर से भेजने के लिए, क्वेरी के आखिर में मौजूद cached फिर से भेजें आइकॉन पर क्लिक करें.

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

बोले गए वाक्यांश पैनल में डाली गई क्वेरी और जवाबों को सेव करने के लिए, save सेव करें पर क्लिक करें. आपके इंटरैक्शन को JSON फ़ॉर्मैट में बदला जाता है. यह फ़ॉर्मैट इस तरह का होता है:

• ask: आपकी क्वेरी.
• answers: Assistant Simulator के संभावित जवाबों का कलेक्शन.

Android Studio में जाकर, इस JSON फ़ाइल में बदलाव किया जा सकता है.

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

एक साथ कई जवाब इकट्ठा करना

सेव की गई JSON फ़ाइलों को नए टैब में खोलने के लिए, Google Home Plugin पैनल में बोले गए वाक्यांशों की फ़ाइल पर क्लिक करें. पाथ चुनें के लिए, कोई फ़ाइल या फ़ोल्डर चुना जा सकता है. अगर कोई फ़ोल्डर चुना जाता है, तो इकट्ठा करें और जांच करें विकल्प, उस फ़ोल्डर में मौजूद सभी बोली .json फ़ाइलों पर काम करेंगे.

एक ही फ़ाइल या अलग-अलग फ़ाइलों के लिए कई टैब खोले जा सकते हैं. उदाहरण के लिए, lights, lights(1), और plug.

स्टेटस बार में, आपके पिछले टेस्ट का नतीजा दिखता है. अगर आपने कोई टेस्ट किया है, तो यह नतीजा दिखेगा. साथ ही, इसमें पीला या हरा बिंदु दिखता है. इससे पता चलता है कि फ़ाइल इकट्ठा की गई है या नहीं. साथ ही, इसमें .json फ़ाइल का पाथ दिखता है. tocइकट्ठा करें पर क्लिक करने के बाद, Assistant Simulator आपकी क्वेरी चलाता है. नया जवाब मिलने पर, आपको इसकी सूचना दी जाएगी. साथ ही, क्वेरी प्रोसेस होने के दौरान स्टेटस बार में एक काउंटर दिखेगा.

इकट्ठा करें की प्रोसेस पूरी होने पर, स्टेटस बार आपके .json पाथ के सामने हरे रंग के सही का निशान दिखाता है. साथ ही, आपके बोले गए वाक्यांशों की फ़ाइलों में संभावित जवाब अपने-आप भर जाते हैं.

{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

अगर आपने कलेक्शन को जल्दी बंद कर दिया, तो आपके .json पाथ को 'इकट्ठा किया गया' के तौर पर मार्क नहीं किया जाएगा.

एक साथ बोले गए वाक्यों की जांच करना

जवाब इकट्ठा करने के बाद, अपनी क्वेरी फिर से चलाने और जवाबों और लॉग देखने के लिए, switch_left जांच करें पर क्लिक करें. एक साथ कई वाक्यों की जांच करते समय, Assistant Simulator को आपकी JSON फ़ाइल में सेव किए गए जवाब चाहिए. अगर आपका टेस्ट ऐसा जवाब दिखाता है जिसे इकट्ठा नहीं किया गया है, तो आपको इस जवाब जैसी सूचना मिलेगी:

error Expected one of: "Got it, turning on 2 lights."

इस स्थिति से पता चलता है कि टेस्ट पूरा नहीं हुआ. अगर ऐसा नहीं किया जाता है, तो Assistant Simulator आपकी हर क्वेरी को चलाकर जवाब देगा. अगर जांच पूरी हो जाती है, तो स्टेटस बार में check सही का निशान दिखता है.

Cloud Logging देखना

Cloud Logs टूल विंडो में कोई प्रोजेक्ट टैब खोलने के लिए, Google Home Plugin पैनल में जाकर Cloud Logs पर क्लिक करें. अपने हर प्रोजेक्ट के लिए, अलग-अलग Cloud लॉग टैब खोले जा सकते हैं.

क्वेरी के लिए इस्तेमाल हुए शब्द

चुने गए प्रोजेक्ट के लिए, क्वेरी फ़ील्ड का इस्तेमाल करके भी लॉग फ़िल्टर किए जा सकते हैं. उदाहरण के लिए, light वाले कीवर्ड के लिए लॉग फ़िल्टर करने के लिए:

क्वेरी को लॉग करने के लिए इस्तेमाल की जाने वाली भाषा का इस्तेमाल करने के लिए, QL का इस्तेमाल करें को चुनें.

यहां क्वेरी लैंग्वेज (QL) की कुछ क्वेरी के उदाहरण दिए गए हैं, ताकि आपको शुरुआत करने में मदद मिल सके:

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"

jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"

jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

तारीख और समय से जुड़ी क्वेरी

तारीख के हिसाब से लॉग क्वेरी करना भी ज़रूरी नहीं है. इसे चालू करने के लिए, इसके बाद और इससे पहले पर क्लिक करें. दिए गए टेक्स्ट फ़ील्ड में, तारीख और समय का फ़ॉर्मैट टाइप किया जा सकता है. उदाहरण के लिए, 5/11/22, 12:37 PM. इसके अलावा, तारीख चुनने के लिए तारीख चुनने वाले टूल calendar_month का इस्तेमाल किया जा सकता है. इसके बाद, टेक्स्ट फ़ील्ड में समय डाला जा सकता है.

• 5/1/22 के बाद की तारीख चुनने के लिए, इसके बाद को चुनें और तारीख के आइकॉन पर क्लिक करेंcalendar_month.
• 5/1/22 से पहले की तारीख चुनने के लिए, इससे पहले को चुनें और तारीख के आइकॉन calendar_month पर क्लिक करें.
• 5/1/22 और 6/30/22 के बीच की कोई तारीख चुनने के लिए, इससे पहले और इसके बाद को चुनें. इसके बाद, तारीख के आइकॉन calendar_month से अपनी तारीखें चुनें.

प्रोजेक्ट के लाइव लॉग फ़ेच करने के लिए, रीयल टाइम चुनें. रीयल-टाइम फ़ीड को बंद करने के लिए, बंद करें पर क्लिक करें.

गंभीरता का लेवल

ड्रॉपडाउन से कम गंभीर भी चुना जा सकता है.

क्वेरी के नतीजे

अपने क्वेरी पैरामीटर सबमिट करने के लिए, cached फ़ेच करें पर क्लिक करें.

लॉग लोड होने के बाद, पूरे JSON पेलोड को बड़ा करने के लिए, किसी भी रिकॉर्ड chevron_right पर क्लिक करें. पूरा मैसेज देखने के लिए, chevron_left पर फिर से क्लिक करें.

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

होम ग्राफ़ देखना और टेस्ट चलाना

अपने डिवाइसों की सूची देखने के लिए, Google Home Plugin पैनल से होम ग्राफ़ चुनें.

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

डिवाइस लोड होने के बाद, पूरे JSON पेलोड को बड़ा करने के लिए, किसी भी रिकॉर्ड chevron_right पर क्लिक करें.

अपने डिवाइसों के लिए JSON पेलोड दिखाने और छिपाने के लिए, बड़ा करें और छोटा करें का भी इस्तेमाल किया जा सकता है.

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

जांच पूरी होने के बाद, जांच की जानकारी देखी जा सकती है और लॉग देखे जा सकते हैं.

Android Debug Bridge (adb) लॉग व्यूअर

Adb Log टूल विंडो में कोई प्रोजेक्ट टैब खोलने के लिए, बाईं ओर मौजूद Google Home प्लग इन टूलबार में, Adb Log कमांड पर क्लिक करें. अपनी हर लॉग फ़ाइल के लिए, अलग-अलग Adb लॉग टैब खोले जा सकते हैं. किसी टैब को मिटाने के लिए, clear आइकॉन पर क्लिक करें.

देखने के लिए कोई लॉगिंग कॉम्पोनेंट चुनने के लिए, चुनें फ़ील्ड का इस्तेमाल करें. साथ ही, गंभीरता ड्रॉप-डाउन का इस्तेमाल करके, सिर्फ़ मैच होने वाली लॉग की गंभीरता वाली एंट्री दिखाएं.

चुने गए adb लॉग के लिए, फ़िल्टर फ़ील्ड का इस्तेमाल करके लॉग एंट्री को फ़िल्टर किया जा सकता है. इसके लिए, बड़े और छोटे अक्षरों में अंतर या रेगुलर एक्सप्रेशन मॉडिफ़ायर का इस्तेमाल किया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है.

इसके अलावा, ये काम भी किए जा सकते हैं:

• ढूंढें फ़ील्ड और आगे ढूंढें (arrow_downward आइकॉन) और पीछे ढूंढें (arrow_upward आइकॉन) कमांड का इस्तेमाल करके, खास एंट्री ढूंढें.
• केस-सेंसिटिव या रेगुलर एक्सप्रेशन मॉडिफ़ायर का इस्तेमाल करें. हालांकि, ऐसा करना ज़रूरी नहीं है.
• लॉग में किसी खास लाइन (नंबर के हिसाब से) पर जाने के लिए, लाइन पर जाएं.

लाइन नंबर जोड़ी गई लॉग लाइन देखने के लिए, नंबर वाली चुनें. रॉ लॉग एंट्री देखने के लिए, रॉ चुनें.

रिसॉर्स और सुझाव

डेवलपर टूल और संसाधनों की सूची देखने के लिए, संसाधन पर क्लिक करें.

Google Home Plugin के साथ डेवलपमेंट के अनुभव को बेहतर बनाने के बारे में अपने सुझाव, राय या शिकायत सबमिट करने के लिए, सुझाव/राय दें या शिकायत करें पर क्लिक करें.