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

Matter ; Home APIs

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

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

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

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

सुविधाएं

Assistant सिम्युलेटर

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

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

Cloud Logging देखना

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

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

एक साथ कई निर्देश देना

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

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

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

Home Graph Viewer

Home Graph Viewer की मदद से, अपने डिवाइसों की स्थिति दिखाई जा सकती है. साथ ही, अपने ब्राउज़र में Google Home Test Suite लॉन्च किया जा सकता है.

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

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

इंस्टॉल करें

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

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

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

सेटअप

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

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

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

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

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

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

   

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

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

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

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

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

साइन इन करने के बाद, ड्रॉपडाउन से कोई प्रोजेक्ट चुनें. प्रोजेक्ट की सूची को फ़िल्टर करने के लिए, फ़िल्टर एक्सप्रेशन टाइप करें. उदाहरण के लिए, 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

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

{
  "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 टेस्ट करें पर क्लिक करें. एक साथ कई निर्देशों की जांच करते समय, the Assistant Simulator को उन जवाबों की उम्मीद होती है जो आपकी JSON फ़ाइल में सेव हैं. अगर आपके टेस्ट में ऐसा जवाब मिलता है जो इकट्ठा नहीं किया गया है, तो आपको एक सूचना मिलेगी. यह सूचना, इस जवाब की तरह होगी:

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

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

Cloud Logging देखना

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

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

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

Logging क्वेरी लैंग्वेज का इस्तेमाल करने के लिए, 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 पर क्लिक करें.

Home Graph देखना और टेस्ट चलाना

अपने डिवाइसों की सूची देखने के लिए, Home Graph को Google Home Plugin पैनल से चुनें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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