פלאגין של Google Home ל-Android Studio

Google Home Plugin for Android Studio מיועד ונוצר עבור מפתחים של פלטפורמת Google Home. הפלאגין הזה נותן גישה ל-Google Assistant Simulator, ל-Cloud Logging ולכלים נוספים, כדי לפשט את תהליך הפיתוח של הבית החכם.

הודעת אבטחה

כדי למנוע מ-Android Studio לאחסן סודות וסיסמאות, מבצעים את השלבים הבאים:

1. לוחצים על קובץ, ואז על הגדרות....
2. בקטע Appearance & Behavior (מראה והתנהגות), מרחיבים את System Settings (הגדרות המערכת) ולוחצים על Passwords (סיסמאות).
3. בוחרים באפשרות לא לשמור, שוכחים סיסמאות אחרי הפעלה מחדש.

תכונות

סימולטור של Assistant

כדי לבדוק אם המכשירים לבית החכם פועלים כמו שצריך בסביבה העסקית של Google Home, תוכלו להשתמש ב-Assistant Simulator בכל שלב, בלי לצאת מ-Android Studio.

בדומה ל-Simulator הקיים של Assistant שזמין במסוף Actions on Google Console, אפשר להשתמש ב-Assistant Simulator כדי לשלוט בקלות במכשירים על ידי הקלדת השאילתות, למשל "Turn on the light" בתוך Android Studio, Assistant Simulator יענה בהודעות טקסט שמבוססות על הפקודות שלכם, לדוגמה: "Ok, turn on the light".

הצגת Cloud Logging

Google Cloud Logging מספק מידע על ניפוי באגים ומדדים חשובים שיעזרו לכם לקבל תובנות לגבי השימוש בפעולה. כדי לפשט את הפיתוח, במהלך פתרון הבעיות, Google Home Plugin מציג הודעות Cloud Logging בזמן אמת ליד הקוד.

אפשר להציג יומנים בזמן אמת או לבחור טווח תאריכים.

ביטויים באצווה

התשובות של Assistant Simulator להבעה יחידה אינן חד-משמעיות. לדוגמה, תשובה יכולה להיות כל אחד מהביטויים הבאים:

• הבנתי, מדליקים את שני האורות.
• בטח, מדליק את שני האורות.
• הבנתי, מדליקים 2 נורות.
• בסדר, מדליקים שתי נורות.

כדי להריץ בדיקות אוטומטיות ולוודא איך השילובים של Google פועלים עם התשובות השונות האלה, אפשר לשלוח ביטויים באצווה אל Assistant Simulator על ידי הרצת סקריפטים של דיבור. אחרי ששומרים סקריפט, אפשר לאסוף תשובות ולהריץ מספר בדיקות על השאילתות.

בעל הרשאת צפייה בגרף הבית

Home Graph Viewer מאפשר להציג את מצב המכשירים ולהפעיל את חבילת הבדיקה של Google Home בדפדפן.

מציג היומן של ניפוי הבאגים ב-Android (adb)

Adb Log Viewer הוא כלי שמאפשר להציג ולנתח קובצי יומן, לדוגמה Matter קובצי יומן של מכשיר, יומנים של Google Home ויומנים ב-Android.

התקנה

כדי להתקין את Google Home Plugin ב-Android Studio, צריך לבצע את השלבים הבאים:

1. מורידים או מעדכנים את Android Studio. להורדת Android Studio
2. נכנסים אל File > Settings (הגדרות) (Android Studio > Preferences (העדפות) ב-MacOS).
3. בקטע Plugins (יישומי פלאגין), עוברים אל Marketplace ומחפשים את google home.
4. מתקינים את הכלי ומפעילים מחדש את Android Studio.

אפשר גם להוריד את הפלאגין ישירות מ-JetBrains Marketplace.

הגדרה

לאחר התקנת הפלאגין, עליכם לבצע את השלבים הבאים כדי שתוכלו להשתמש ב-Assistant Simulator ולצפות ב-Cloud Logging:

• כניסה באמצעות חשבון Google
• בחירת פרויקט בענן

כניסה באמצעות חשבון Google

אפשר להיכנס לחשבון הפיתוח מחלונית Google Home, כדי לתת הרשאה ל-Android Studio ליצור קשר עם שירותי Google בשמך.

1. לוחצים על הכרטיסייה Google Home בעמודת הכרטיסייה האנכית בצד שמאל של החלון Android Studio.

2. בשדה כניסה באמצעות, לוחצים על Google כדי להפעיל את הדפדפן.

   

3. בוחרים את החשבון שמקושר למכשירים לבית החכם.

4. בדף ההרשאה Sign in with Google (כניסה באמצעות חשבון Google), לוחצים על Allow (אישור).

5. סוגרים את חלון הדפדפן וחוזרים אל Android Studio.

עכשיו אתם אמורים להיות מחוברים לחשבון, עם האפשרות יציאה.

בחירת פרויקט ב-Cloud

אחרי הכניסה לחשבון, בוחרים באפשרות Project (פרויקט) מהתפריט הנפתח. כדי לסנן את רשימת הפרויקטים, מקלידים ביטוי Filter, לדוגמה matter, ומקישים על Enter.

התפריט הנפתח Project טוען את 100 הפרויקטים הראשונים בהתאם ל-Filter. הבחירות שלכם יישמרו כשתצאו מ-Android Studio.

לקבלת עזרה עם מסנני פרויקטים, קראו את המאמר פרמטרים של שאילתות ב-Google Cloud Reference.

שימוש בסימולטור של Assistant

כדי לפתוח את Assistant Simulator ב-Android Studio, לוחצים על חלונית דיבור בחלונית Google Home Plugin.

יש כמה דרכים לשלוח שאילתות אל Assistant Simulator. לאחר מכן נעבור על כל אחת מהאפשרויות.

הקלדת שאילתות ואיסוף תשובות

כדי לבצע אינטראקציה עם Assistant Simulator, מקלידים את השאילתה ומקישים על Enter.

כדי לשלוח מחדש שאילתה, לוחצים על סמל השליחה cached מחדש בסוף השאילתה.

אחרי ששולחים שאילתה אחת או יותר, לוחצים על cached Replay כדי להריץ מחדש את השאילתות ולבדוק את התשובות. החלונית Utterances עוקבת אחרי השאילתות והתשובות במטמון שנשמר. הפעלה מחדש רק מוסיפה תשובות חדשות למטמון הפנימי הזה ולא מעתיקה את השאילתות בכל פעם שלוחצים על הלחצן.

לוחצים על save 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."
      ]
    }
  ]
}

איסוף תשובות באצווה

בחלונית Google Home Plugin לוחצים על Utterances File (קובץ הערות) כדי לפתוח את קובצי ה-JSON השמורים בכרטיסייה חדשה. בשביל Select Path אפשר לבחור קובץ או תיקייה. אם בוחרים תיקייה, האפשרויות Collect ו-Test יפעלו בכל קובצי .json של ההשמעות שבתיקייה הזו.

אפשר לפתוח מספר כרטיסיות לאותו הקובץ או לקבצים שונים, לדוגמה lights, lights(1) ו-plug.

בשורת הסטטוס מוצגת התוצאה של הבדיקה האחרונה (אם רלוונטי), נקודה צהובה או ירוקה שמציינת אם הקובץ נאסף, ונתיב הקובץ .json של ההגייה. אחרי שלוחצים על tocCollect, השדה Assistant Simulator יריץ את השאילתות. תקבלו הודעה כשנקבל תשובה חדשה, ובשורת הסטטוס יוצג מונה בזמן עיבוד השאילתות.

כשהערך של Collect מסתיים, שורת הסטטוס מתעדכנת עם סימן וי ירוק לפני הנתיב .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 Test כדי להפעיל מחדש את השאילתות ולבדוק את התשובות והיומנים. כשבודקים ביטויים באצווה, ה-Assistant Simulator מצפה לתגובות שנשמרות בקובץ ה-JSON. אם הבדיקה מחזירה תגובה שלא נאספו, מקבלים התראה שדומה לתגובה הבאה:

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

התרחיש הזה מצביע על כך שהבדיקה נכשלה. אחרת, ה-Assistant Simulator יריץ כל אחת מהשאילתות ויחזיר תשובה. אם הבדיקה בוצעה בהצלחה, תופיע בדיקה check בשורת הסטטוס.

הצגת Cloud Logging

כדי לפתוח כרטיסיית פרויקט בחלון של הכלי Cloud Logs, לוחצים על Cloud Logs בחלונית Google Home Plugin. אתם יכולים לפתוח כרטיסיות נפרדות ב-Cloud Log לכל אחד מהפרויקטים שלכם.

מונחי השאילתה

בפרויקט שנבחר, אפשר גם לסנן יומנים באמצעות השדה שאילתה. לדוגמה, כדי לסנן יומנים עבור מילת מפתח של light:

בוחרים באפשרות Use QL כדי להשתמש ב-Logging query language.

ריכזנו כאן כמה דוגמאות לשאילתות 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"

שאילתות לגבי תאריך ושעה

גם שליחת שאילתות על יומנים לפי תאריך היא אופציונלית, ואפשר להפעיל אותה בלחיצה על After ו-Before. אפשר להקליד את הפורמט של התאריך והשעה בשדה הטקסט שמוצג, לדוגמה 5/11/22, 12:37 PM, או להשתמש בבוחרי התאריכים calendar_month כדי לבחור את התאריך ולאחר מכן להזין את השעה בשדה הטקסט.

• כדי לבחור תאריך אחרי 5/1/22, בוחרים באפשרות After (אחרי) ולוחצים על סמל התאריך calendar_month.
• כדי לבחור תאריך לפני 5/1/22, בוחרים באפשרות Before ולוחצים על סמל התאריך calendar_month.
• כדי לבחור תאריך בין 5/1/22 ל-6/30/22, לוחצים על Before ו-After ובוחרים את התאריכים בלחיצה על סמל התאריך calendar_month.

בוחרים באפשרות זמן אמת כדי לאחזר יומני פרויקטים חיים. לוחצים על Stop כדי לסיים פיד בזמן אמת.

רמת החומרה

אפשר גם לבחור רמת חומרה מינימלית מהתפריט הנפתח.

תוצאות השאילתה

לוחצים על cached Fetch כדי לשלוח את הפרמטרים של השאילתה.

אחרי שטוענים את היומנים, לוחצים על רשומה כלשהי chevron_right כדי להרחיב את המטען הייעודי (payload) המלא של JSON. כדי להציג את ההודעה המלאה, לוחצים שוב chevron_left.

אם רוצים, אפשר להקליד מילת מפתח בתיבה Filter כדי לצמצם את תוצאות היומן. לוחצים על x כדי להסיר את המסנן ולחזור לתוצאות השליפה המקוריות.

הצגה של גרף הבית וביצוע בדיקות

כדי להציג את רשימת המכשירים, צריך לבחור את Home Graph בחלונית Google Home Plugin.

לוחצים על cached רענן כדי להציג את שם המכשיר, מזהה המכשיר וסוג המכשיר של המכשירים שמשויכים לפרויקט שנבחר. אפשר לפתוח מספר חלוניות של Google Home Graph לפרויקטים נפרדים.

אחרי שהמכשירים נטענים, לוחצים על רשומה כלשהי chevron_right כדי להרחיב את המטען הייעודי (payload) המלא של JSON.

אפשר גם להשתמש בפונקציות Expand וכיווץ כדי להציג ולהסתיר את מטענים ייעודיים (payloads) של JSON של המכשירים.

כדי להפעיל את Test Suite למכשיר ספציפי, לוחצים על Test. הפעולה הזו מפעילה את חבילת הבדיקה בדפדפן, כשהמכשיר נבחר ומוכן לבדיקה. לוחצים על Start וממתינים לתוצאות הבדיקה.

אחרי שהבדיקות יסתיימו, תוכלו לבדוק את פרטי הבדיקות ולצפות ביומנים.

מציג היומן של ניפוי הבאגים ב-Android (adb)

כדי לפתוח כרטיסיית פרויקט בחלון של הכלי Adb Log, לוחצים על הפקודה Adb Log בסרגל הכלים של הפלאגין של Google Home (בצד ימין). אתם יכולים לפתוח כרטיסיות נפרדות של יומן Adb לכל אחד מקובצי היומן. כדי למחוק כרטיסייה, לוחצים על הסמל clear.

משתמשים בשדה Select כדי לבחור רכיב ספציפי לרישום ביומן להצגה, ובתפריט הנפתח Severity יוצגו רק רשומות עם מידת ההתאמה המדויקת של היומן.

תוכלו לסנן את הרשומות ביומן באמצעות השדה Filter עם הערכים האופציונליים תלוי אותיות רישיות או Regex.

אפשר גם:

• כדי למצוא רשומות ספציפיות, משתמשים בשדה חיפוש באמצעות הפקודות חיפוש הבא (סמל arrow_downward) וחיפוש הקודם (סמל arrow_upward).
• אם רוצים, אפשר להשתמש במקשי צירוף תלוי אותיות רישיות או regex.
• דילוג לשורה כדי לדלג לשורה שצוינה (לפי מספר) ביומן.

בוחרים באפשרות ממוספר כדי להציג שורות ביומן עם מספרי שורות שנוספו. בוחרים באפשרות Raw כדי להציג את הרשומות הגולמיות ביומן.

מקורות מידע ומשוב

לוחצים על משאבים כדי להציג את רשימת הכלים והמשאבים למפתחים.

כדי לספר לנו מה דעתכם או משוב לגבי שיפור חוויית הפיתוח באמצעות Google Home Plugin, לוחצים על Feedback.