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

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

सुरक्षा नोटिस

Android Studio को सीक्रेट और पासवर्ड सेव करने से रोकने के लिए, ये चरण पूरे करें:

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

सुविधाएं

Assistant सिम्युलेटर

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

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

क्लाउड लॉगिंग देखें

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

आपके पास रीयल-टाइम लॉग दिखाने या तारीख की सीमा चुनने का विकल्प है.

बैच स्टेटमेंट

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

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

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

होम ग्राफ़ व्यूअर

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

Android डीबग ब्रिज (adb) लॉग व्यूअर

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

इंस्टॉल करें

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

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

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

सेटअप

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

• 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 सिम्युलेटर का इस्तेमाल करना

Assistant Simulator को Android Studio में खोलने के लिए, 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 पैनल से Utterances फ़ाइल पर क्लिक करें. पाथ चुनें के लिए, कोई फ़ाइल या फ़ोल्डर चुना जा सकता है. अगर कोई फ़ोल्डर चुना जाता है, तो इकट्ठा करें और जांच करें पर क्लिक करने से, उस फ़ोल्डर में मौजूद .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 की जांच दिखेगी.

क्लाउड लॉगिंग देखें

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

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

चुने गए प्रोजेक्ट के लिए, क्वेरी फ़ील्ड का इस्तेमाल करके भी लॉग फ़िल्टर किए जा सकते हैं. उदाहरण के लिए, 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 पेलोड दिखाने और छिपाने के लिए, बड़ा करें और छोटा करें का भी इस्तेमाल किया जा सकता है.

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

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

Android डीबग ब्रिज (adb) लॉग व्यूअर

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

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

चुने गए adb लॉग के लिए, फ़िल्टर फ़ील्ड का इस्तेमाल करके लॉग एंट्री को फ़िल्टर किया जा सकता है. हालांकि, इसमें केस-सेंसिटिव या Regex मॉडिफ़ायर शामिल करना ज़रूरी होता है.

इसके अलावा, आपके पास ये विकल्प भी हैं:

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

जिन लॉग लाइनों को लाइन नंबर से जोड़ा गया है उन्हें देखने के लिए, नंबर वाले चुनें. रॉ लॉग एंट्री देखने के लिए, RAW चुनें.

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

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

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