תוסף Google Home לקוד VS

ה-SDK של המכשיר

האפליקציה Google Home Extension for Visual Studio Code עוצבה ונוצרה עבור פלטפורמת Google Home למפתחים. התוסף הזה נותן לך גישה אל Google Assistant Simulator, Google Cloud Logging, 'צפייה ב-Home Graph' וכלים נוספים שיעזרו לך לפשט את תהליך הפיתוח של תקן Matter ובית חכם.

תוסף של Google Home ל-VS Code

תכונות התוספים של Google Home

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

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

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

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

כדי לבדוק את השילוב של Google Home כמו אוטומציה, אפשר לשלוח מקבץ תמונות של דיבור לסימולטור של Google Assistant על ידי הרצת סקריפט של דיבור. צפייה לפרטים נוספים, ראו Run Batch Utterances.

כלים לרישום עניינים

כלים לרישום עניינים יכולים לאסוף את כל היומנים שקשורים לניפוי באגים של עניינים, כולל יומני Google Home app (GHA) והיומנים של Google Play Services (GMS Core). ניתן להציג רישומים ב-VS Code עם חיפושים של מסננים ומילות מפתח. היומנים יכולים להיות היא כוללת מידע נוסף על תוצאות ניפוי הבאגים, כמו Android וגרסת האפליקציה, והם יישלחו ל-Google לצורכי דיווח בעיות נפוצות.

רישום עניינים בתוסף Google Home

Cloud Logging

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

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

צפייה ב-Home Graph זמינה עכשיו ישירות Google Home Extension כדי שתהיה לך אפשרות לאמת את מצב המכשיר תרשים הבית בתוך VS Code. צפייה הצגה של גרף הבית והרצת בדיקות לקבלת מידע נוסף פרטים.

התקנת התוסף של Google Home ל-VS Code

כדי להתקין את Google Home Extension, יש לפעול לפי השלבים הבאים מתוך קוד VS:

  1. לוחצים על סמל התוספים בסרגל הפעילות.
  2. מחפשים את google home ולוחצים על התקנה.

    זירת המסחר של התוספים של Google Home

אפשר גם להוריד את Google Home Extension ישירות מ- VS Code Marketplace.

להורדה של Google Home Extension

הגדרת תוסף של Google Home ל-VS Code

לאחר ההתקנה של Google Home Extension וטעינה מחדש של VS Code, צריך להיכנס ולבחור פרויקט לפני שאפשר להשתמש Assistant Simulator ו-Cloud Logging.

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

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

  1. לוחצים על הסמל של דף הבית של Google בסרגל הפעילות כדי לפתוח אותו. Google Home Extension.

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

    כניסה באמצעות חשבון Google ל-VS Code
  3. בוחרים את החשבון שמקושר למכשירים לבית החכם.

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

  5. תיפתח כרטיסייה בדפדפן ותיבת הדו-שיח Open Visual Studio Code תופיע מוצגת. לוחצים על Open Visual Studio Code כדי להמשיך.

    פתיחת תיבת הדו-שיח VS Code
  6. המערכת תפנה אותך ל-VS Code, שבו נדרשת ההרשאה שלך כדי מתן הרשאה לתוסף Google Home לפתוח URI. לוחצים על Open כדי לסיים את התהליך תהליך ההתחברות.

    מתן הרשאה לתוסף של Google Home לפתוח URI
  7. לאחר הכניסה, Google Home Extension יטען את הפרויקטים שלך. פעם אחת לוחצים על Select a project.

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

התקנה של הכלי ל-Android Debug Bridge (ADB)

כדי להציג את היומנים של Matter במכשיר Android צריך להתקין את ADB:

  1. התקנת ADB במחשב.
  2. הפעלת האפשרויות למפתחים ו-USB ניפוי באגים בטלפון Android.

התקנת כלי SoC של מכשיר Matter

כדי להציג את יומני ניפוי הבאגים מ-Matter מכשירים:

  1. רוב היציאות הטוריות מיוצאות באמצעות ה-SoC של המכשירים, כמו /dev/ttyUSBx ב-Linux או ב-/dev/tty.SLAB_USBtoUART או /dev/tty.usbserial ב-MacOS. ה-LogViewer יכול לקרוא את היומן ישירות מהמכשיר.
  2. סוגים מסוימים של SoC, כמו NXP או יכול להיות שיידרשו משתמשים חיצוניים ל-Silicon Labs (לדוגמה, JLink) כדי להתקין. צפייה מכשירים נתמכים לקבלת מידע נוסף מידע.

שימוש בתוסף של Google Home ל-VS Code

לצפייה במשאבים למפתחים

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

מקורות מידע לסביבה העסקית של Google Home

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

כדי לפתוח את Assistant Simulator ב-VS Code, לוחצים על GOOGLE ASSISTANT SIMULATOR בסרגל הצד. בתיבה הודעה, מקלידים את השאילתה ו מקישים על Enter.

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

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

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

מעבירים את העכבר מעל סרגל התפריטים GOOGLE ASSISTANT SIMULATOR ובוחרים מתוך האפשרויות הבאות להגדרת סקריפטים:

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

  • לוחצים על הסמל כדי לשמור את ההיסטוריה בסקריפט *.utterance.

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

כדי להתחיל לשלוח ביטויים באצווה, צריך לבחור אחת מהאפשרויות הבאות:

  • יש ללחוץ על כדי לבחור סקריפט של דיבור מהחלון הנפתח.
  • פותחים קובץ *.utterance ישירות ולוחצים על .

    סמל של הרצת ביטויים מרובים

הצגת Cloud Logging

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

שימוש ב-Cloud Logging

המשתמשים יכולים לסנן יומנים לפי מידת החומרה וטווח הזמן.

סינון יומנים לפי חומרה וזמן

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

הצגת יומנים נוספים

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

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

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

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

חבילת הבדיקה של Google Home

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

תוצאות הבדיקה

שימוש בתוסף של Google Home לניפוי באגים בתקן Matter

רישום ביומן Android

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

רישום ביומן Android

אחרי שהטלפון Android יחובר, תהיה לך אפשרות לראות היומנים, שורה אחרי שורה. חשוב לדעת שהיומנים מסוננים, כלומר רק יומנים שקשורים אל GHA ואל Google Play services Matter מודול מוצגות. אפשר גם להגדיר חומרה כדי לסנן יומנים או לחפש את את מילת המפתח ביומנים.

רישום ביומן Android מסונן

רישום של מכשירי תקן Matter ביומן

בקטע כלים לרישום עניינים, לוחצים על יומני מכשירים כדי לפתוח את הדף משאבים. קודם צריך לבחור את האפשרות SoC Type:

רישום ביומן של מכשירים בתקן Matter

בשלב הבא, בוחרים את המכשיר של החומר:

בחירת מכשיר לרישום של מכשירים בתקן Matter

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

רישום ביומן מסונן של מכשיר בתקן Matter

הורדת כל יומני העניין

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

הורדת יומני העניין

בוחרים את התיקייה שאליה רוצים להוריד יומנים ולוחצים על שמירה:

שמירה של יומן העניין

לאחר מכן היומנים יישמרו בתיקיית היעד:

תיקיית היעד של יומן העניין

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

קובץ ZIP של יומן עניינים

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

ניפוי באגים ביומן עניינים

שליחת משוב

כדי לשלוח לנו את דעתך או משוב לגבי הדרך שבה נוכל לשפר את הפיתוח עם Google Home Extension, בחר אחת מהאפשרויות הבאות:

  • בחלונית עזרה ומשוב, לוחצים על שליחת משוב כדי לתת לנו משוב הצעות.
  • בחלונית עזרה ומשוב, לוחצים על דיווח על בעיה כדי לדווח על הבעיה. כל בעיה שמצאת ב-Google Home Extension
הסמל של שליחת משוב
  • יש גם סמל משוב בדף משאבים.