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

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

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

הודעת אבטחה

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

  1. לוחצים על קובץ ואז על הגדרות....
  2. בקטע מראה והתנהגות, מרחיבים את הקטע System Settings (הגדרות המערכת) ולוחצים על Passwords (סיסמאות).
  3. בוחרים באפשרות לא לשמור, לשכוח את הסיסמה אחרי ההפעלה מחדש.
פלאגין Google Home ל-Android Studio

תכונות

סימולטור של Assistant

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

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

בדיקה באמצעות סימולטור של Assistant

הצגת Cloud Logging

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

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

תצוגת Cloud Logging

הצהרות באצווה

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

  • הבנתי, מתבצעת הפעלה של 2 נורות.
  • בטח, מדליקים 2 נורות.
  • הבנתי, אני מדליק 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. נכנסים אל קובץ > הגדרות (Android Studio > העדפות ב-MacOS).
  3. בקטע יישומי פלאגין, עוברים אל Marketplace ומחפשים את google home.
  4. יש להתקין את הכלי ולהפעיל מחדש את Android Studio.

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

Setup (הגדרה)

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

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

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

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

  2. בקטע Sign in with (כניסה באמצעות), לוחצים על Google כדי להפעיל את הדפדפן.

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

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

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

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

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

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

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

בחירת פרויקט

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

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

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

פתיחת חלונית ההתבטאויות

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

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

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

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

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

הפעלה מחדש של אמירות בעזרת הסימולטור של Assistant

לוחצים על 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 אפשר לבחור קובץ או תיקייה. אם בוחרים תיקייה, האיסוף והבדיקה יפעלו על כל קובצי .json של ההגות שבתיקייה הזו.

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

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

איסוף אמירות באמצעות הסימולטור של Assistant

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

איסוף אמירות באמצעות הסימולטור של Assistant
{
  "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 לא יסומן כנאסף.

בדיקת ביטויים של אצווה

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

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

הרצת ההתבטאויות באמצעות הסימולטור של Assistant

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

הרצת ההתבטאויות באמצעות הסימולטור של Assistant

הצגת Cloud Logging

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

כרטיסיות Cloud Logging

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

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

שאילתה לגבי Cloud Logging

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

שפת השאילתות של Cloud Logging

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

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

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

רמת חוּמרה

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

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

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

אחרי שטוענים את היומנים, לוחצים על רשומה כדי להרחיב את המטען הייעודי המלא של ה-JSON. לחץ שוב על כדי להציג את ההודעה המלאה.

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

הצגת Cloud Logging

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

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

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

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

מטען ייעודי (payload) של JSON בתרשים הבית

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

הרחבה וכיווץ של תרשים דף הבית JSON

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

בדיקות הרצה של תרשים ביתי

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

בדיקות שהושלמו בתרשים הבית

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

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

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

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

אפשר גם:

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

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

צופה ביומן Adb

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

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

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

שליחת משוב