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

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

הודעת אבטחה

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

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

תכונות

סימולטור של Assistant

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

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

הצגת Cloud Logging

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

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

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

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

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

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

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

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

Android Debug Bridge (adb) Log Viewer

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.

הגדרה

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

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

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

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

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

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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

אפשר לשלוח מחדש שאילתה על ידי לחיצה על סמל השליחה מחדש של cached בסוף את השאילתה שלך.

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

לוחצים על 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, לוחצים על קובץ ביטויים כדי לפתוח אותו. את קובצי ה-JSON השמורים בכרטיסייה חדשה. בקטע Select Path (בחירת נתיב), בוחרים קובץ או תיקייה. אם בוחרים תיקייה, האפשרויות איסוף ובדיקה: על כל ההשמעות .json בקבצים שבתיקייה הזו.

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

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

כשהפעולה Collect מסתיימת, Status Bar מתעדכן עם סימן וי ירוק מול הנתיב .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, לוחצים על Cloud Logs מהחלונית Google Home Plugin. אפשר לפתוח כרטיסיות נפרדות ב-Cloud Log לכל אחד מהפרויקטים שלכם.

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

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

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

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

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

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

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

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

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

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

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

Android Debug Bridge (adb) Log Viewer

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

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

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

אפשר גם:

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

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

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

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

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