ה-Google Home Plugin for Android Studio מיועד למפתחים של פלטפורמת Google Home. הפלאגין הזה מעניק לכם גישה ל-Google Assistant Simulator, ל-Cloud Logging ולכלים אחרים שמפשטים את תהליך הפיתוח של הבית החכם.
התראת אבטחה
כדי למנוע מ-Android Studio לאחסן סודות ומפתחות גישה:
- לוחצים על קובץ ואז על הגדרות.
- בקטע מראה והתנהגות, מרחיבים את האפשרות הגדרות מערכת ולוחצים על סיסמאות.
- בוחרים באפשרות לא לשמור, לשכוח את הסיסמאות אחרי ההפעלה מחדש.
תכונות
סימולטור Assistant
כדי לבדוק אם מכשירי הבית החכם שלכם פועלים כראוי עם הסביבה העסקית של Google Home, אתם יכולים לקיים אינטראקציה עם Assistant Simulator בכל שלב בלי לצאת מ-Android Studio.
באמצעות Assistant Simulator תוכלו לשלוט בקלות במכשירים שלכם על ידי הקלדה של שאילתות, למשל "Turn on the light". בתוך Android Studio, Assistant Simulator משיב בהודעות טקסט על סמך הפקודות שלכם, לדוגמה: "בסדר, מדליק את האור".
הצגת Cloud Logging
Google Cloud Logging מספק מידע על ניפוי באגים ומדדים מרכזיים כדי לספק תובנות לגבי השימוש ב-Action. כדי לפשט את הפיתוח, ב-Google Home Plugin מוצגות הודעות Cloud Logging בזמן אמת לצד הקוד במהלך פתרון הבעיות.
אפשר להציג יומנים בזמן אמת או לבחור טווח תאריכים.
Batch Utterances
התשובות של Assistant Simulator למשפט יחיד הן לא גורמיות. לדוגמה, התגובה יכולה להיות כל אחד מהביטויים הבאים:
- הבנתי, אדליק 2 נורות.
- בטח, מדליק 2 נורות.
- הבנתי, אדליק 2 נורות.
- בסדר, אדליק 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, פועלים לפי השלבים הבאים:
- מורידים או מעדכנים את Android Studio. הורדת Android Studio
- עוברים אל קובץ > הגדרות (Android Studio > העדפות ב-MacOS).
- בקטע Plugins, עוברים אל Marketplace ומחפשים את
google home. - מתקינים את הכלי ומפעילים מחדש את Android Studio.
אפשר גם להוריד את הפלאגין ישירות מ-JetBrains Marketplace.
הגדרה
אחרי שתתקינו את הפלאגין, תצטרכו לבצע את השלבים הבאים כדי להשתמש ב-Assistant Simulator ולצפות ב-Cloud Logging:
כניסה באמצעות חשבון Google
אתם יכולים להיכנס לחשבון הפיתוח שלכם מהחלונית של Google Home, כדי לתת ל-Android Studio הרשאה לתקשר עם שירותי Google בשמכם.
לוחצים על הכרטיסייה Google Home בעמודת הכרטיסיות האנכית בצד ימין של החלון Android Studio.
בקטע כניסה באמצעות, לוחצים על Google כדי להפעיל את הדפדפן.
בוחרים את החשבון שמקושר למכשירים לבית החכם.
בדף ההרשאה כניסה באמצעות חשבון Google, לוחצים על אישור.
סוגרים את חלון הדפדפן וחוזרים אל Android Studio.
עכשיו אתם אמורים להיות מחוברים לחשבון, עם אפשרות יציאה.
בוחרים פרויקט ב-Cloud
אחרי הכניסה לחשבון, בוחרים Project (פרויקט) מהתפריט הנפתח. כדי לסנן את רשימת הפרויקטים, מקלידים ביטוי Filter, למשל matter, ואז לוחצים על Enter.
בתפריט הנפתח Project נטענים 100 הפרויקטים הראשונים על סמך Filter. הבחירות שלכם יישמרו כשאתם יוצאים מ-Android Studio.
לקבלת עזרה בנושא מסנני פרויקטים, אפשר לעיין במאמר פרמטרים של שאילתות במסמך העזרה של Google Cloud.
שימוש בסימולטור Assistant
כדי לפתוח את Assistant Simulator ב-Android Studio, לוחצים על חלונית ההצהרות בחלונית Google Home Plugin.
יש כמה דרכים לשלוח שאילתות ל-Assistant Simulator. בהמשך נעבור על כל אחת מהאפשרויות.
הקלדה של שאילתות ואיסוף תשובות
כדי לקיים אינטראקציה עם Assistant Simulator, מקלידים את השאילתה ולוחצים על Enter.
כדי לשלוח מחדש שאילתה, לוחצים על סמל השליחה מחדש בסוף השאילתה.
אחרי שליחת שאילתה אחת או יותר, לוחצים על הפעלה חוזרת כדי להריץ מחדש את השאילתות ולבדוק את התשובות. בחלונית Utterances מתבצע מעקב אחר השאילתות והתשובות שלכם במטמון שנשמר. האפשרות הפעלה מחדש מוסיפה רק תשובות חדשות למטמון הפנימי הזה, ולא מכפילה את השאילתות בכל פעם שלוחצים על הלחצן.
לוחצים על Save כדי לשמור את השאילתות והתשובות שהזנתם בחלונית Utterances. האינטראקציות שלכם מומרות ל-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 של ההבעה. אחרי שלוחצים על Collect, ה-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 לא יסומן כנתיב שנאסף.
בדיקת משפטים באצווה
אחרי שאוספים את התשובות, לוחצים על Test כדי להפעיל מחדש את השאילתות ולבדוק את התשובות והיומנים. כשבודקים משפטים בכמות גדולה, הפונקציה Assistant Simulator מצפה לתשובות שנשמרות בקובץ ה-JSON. אם הבדיקה מחזירה תשובה שלא נאספה, תקבלו התראה שדומה לתגובה הבאה:
Expected one of: "Got it, turning on
2 lights."
התרחיש הזה מציין שהבדיקה נכשלה. אחרת, הפונקציה Assistant Simulator מריצה כל שאילתה ומחזירה תשובה. אם הבדיקה תתבצע בהצלחה, יופיע סימן וי בשורת הסטטוס.
הצגת Cloud Logging
כדי לפתוח כרטיסיית פרויקט בחלון הכלי של Cloud Logs, לוחצים על Cloud Logs בחלונית Google Home Plugin. אפשר לפתוח כרטיסיות נפרדות של יומן Cloud לכל אחד מהפרויקטים.
מונחי השאילתה
בפרויקט שנבחר, אפשר גם לסנן יומנים באמצעות השדה שאילתה.
לדוגמה, כדי לסנן יומנים לפי מילת המפתח light:
בוחרים באפשרות Use 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, או להשתמש בבוררי התאריכים כדי לבחור את התאריך ואז להזין את השעה בשדה הטקסט.
- כדי לבחור תאריך אחרי
5/1/22, בוחרים באפשרות אחרי ולוחצים על סמל התאריך . - כדי לבחור תאריך לפני
5/1/22, בוחרים באפשרות לפני ולוחצים על סמל התאריך . - כדי לבחור תאריך בין
5/1/22ל-6/30/22, בוחרים באפשרויות לפני ואחרי ובוחרים את התאריכים מסמל התאריך .
בוחרים באפשרות זמן אמת כדי לאחזר יומני פרויקטים פעילים. לוחצים על Stop כדי לסיים את הפיד בזמן אמת.
רמת החומרה
אפשר גם לבחור מידת חומרה מינימלית מהתפריט הנפתח.
תוצאות השאילתה
לוחצים על אחזור כדי לשלוח את פרמטרים של השאילתה.
אחרי שהיומן נטען, לוחצים על רשומה כלשהי כדי להרחיב את עומס העבודה המלא של ה-JSON. לוחצים שוב על כדי להציג את ההודעה המלאה.
אפשר גם להקליד מילת מפתח בתיבה Filter כדי לצמצם את תוצאות היומן. לוחצים על x כדי להסיר את המסנן ולחזור לתוצאות האחזור המקוריות.
הצגת Home Graph והרצת בדיקות
כדי להציג את רשימת המכשירים, בוחרים באפשרות תרשים הבית בחלונית Google Home Plugin.
לוחצים על Refresh כדי להציג את שם המכשיר, מזהה המכשיר וסוג המכשיר של המכשירים שמשויכים לפרויקט שנבחר. אפשר לפתוח כמה חלוניות Google Home Graph לפרויקטים נפרדים.
אחרי שהמכשירים נטענים, לוחצים על רשומה כלשהי כדי להרחיב את עומס העבודה המלא של ה-JSON.
אפשר גם להשתמש באפשרויות הרחבה וכיווץ כדי להציג ולהסתיר את עומסי העבודה של ה-JSON במכשירים.
כדי להפעיל את חבילת הבדיקות למכשיר ספציפי, לוחצים על בדיקה. הפעולה הזו תפעיל את חבילת הבדיקות בדפדפן, והמכשיר שבחרתם יהיה מוכן לבדיקה. לוחצים על Start וממתינים לתוצאות הבדיקה.
אפשר לבדוק את פרטי הבדיקה ולהציג את היומנים אחרי שהבדיקות מסתיימות.
Android Debug Bridge (adb) Log Viewer
כדי לפתוח כרטיסיית פרויקט בחלון הכלי של Adb Log, לוחצים על הפקודה Adb Log בסרגל הכלים של הפלאגין של Google Home (בצד ימין). אפשר לפתוח כרטיסיות נפרדות של יומני Adb לכל אחד מקובצי היומנים. כדי למחוק כרטיסייה, לוחצים על הסמל .
משתמשים בשדה Select כדי לבחור רכיב ספציפי של רישום ביומן שרוצים להציג, ובתפריט הנפתח Severity כדי להציג רק רשומות עם רמת החומרה התואמת ביומן.
ביומן adb שנבחר, אפשר לסנן את רשומות היומן באמצעות השדה Filter עם משתני Case-sensitive או Regex אופציונליים.
בנוסף, תוכלו:
- מחפשים רשומות ספציפיות באמצעות השדה Find (חיפוש) והפקודות Find Next (חיפוש הבא, הסמל ) ו-Find Previous (חיפוש הקודם, הסמל ).
- משתמשים במודיפיקרים אופציונליים של תלוי אותיות רישיות או ביטוי רגולרי.
- Jump to line (מעבר לשורה) כדי לעבור לשורה ספציפית ביומן (לפי מספר).
בוחרים באפשרות ממוספר כדי להציג את שורות היומן עם מספרי שורות. בוחרים באפשרות Raw כדי להציג רשומות יומן גולמיות.
מקורות מידע ומשוב
לוחצים על משאבים כדי לראות רשימה של כלים ומשאבים למפתחים.
כדי לשלוח לנו משוב על הדרכים שבהן נוכל לשפר את חוויית הפיתוח באמצעות Google Home Plugin, לוחצים על משוב.
