מגרש משחקים של Google Home

מענן לענן    Local Home SDK    Device SDK

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

השלמת קישור החשבונות

כדי להשתמש ב-Google Home Playground, מומלץ קודם לקשר את הכלי לחשבון. פותחים את Google Home app (GHA) בטלפון ומבצעים את תהליך קישור החשבון:

  1. לוחצים על סמל הפלוס (+) בפינה הימנית העליונה.
  2. בוחרים באפשרות הגדרת המכשיר > פועל עם Google.
  3. מחפשים את הפעולה Google Home Playground.
  4. בוחרים את הפעולה, והסמל GHA יעביר אתכם לדף הכניסה. לוחצים על כניסה באמצעות חשבון Google ובוחרים את החשבון שאליו רוצים להיכנס.
  5. לוחצים על הלחצן אישור כדי לאשר את קישור החשבונות.
באיור הזה מוצג תהליך הקישור של חשבון באפליקציית Google Home כדי לקשר את Google Home Playground.

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

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

כניסה לחשבון

כדי להפעיל את Google Home Playground, לוחצים על הלחצן שלמטה:

הפעלת Playground

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

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

אחרי הכניסה, יוצגו ב-Google Home Playground המכשירים הווירטואליים ששמורים ב-Home Graph.

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

ממשק המשתמש באינטרנט מורכב משלושה חלוניות:

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

מכשיר וירטואלי

הצגת פרטי המכשיר הווירטואלי

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

  • מידע בסיסי: מאפיינים ברמה העליונה של המכשיר, כולל סוג המכשיר, המזהה והשם שלו.
  • Traits: מאפייני המכשיר הנתמכים.
  • מאפיינים: מאפיינים ספציפיים למאפיין של המכשיר.
  • States: כל מצבי המכשיר.
  • SUV: הגדרת אימות משתמש משני במכשיר.

עריכת פרטי המכשיר הווירטואלי

בנוסף להצגת המידע של מכשיר וירטואלי, אפשר גם לערוך ישירות את המידע שלו ששמור ב-Home Graph דרך החלונית פרטי המכשיר.

שינוי מאפייני traits נתמכים

  1. בוחרים בכרטיסייה מאפיינים ולוחצים על הלחצן עריכה.
  2. בחלונית הקופצת תוכלו לראות את המאפיינים הנתמכים כרגע במכשיר ואת המאפיינים הזמינים להוספה. משתמשים בלחצני החץ (arrow_forward/arrow_back) כדי להוסיף או להסיר מאפיינים נתמכים של המכשיר.
  3. כשמסיימים לעדכן את המאפיינים הנתמכים, לוחצים על Save והמאפיינים המעודכנים יחולו על Home Graph.
  4. אפשר לראות את העדכונים האלה למאפיינים באזור היומן.
באיור הזה מוצג כלי ממשק המשתמש להוספה או למחיקה של מאפיינים נתמכים במכשיר שנבחר ב-Google Home Playground.

שינוי מאפייני המכשיר

  1. בוחרים בכרטיסייה Attributes (מאפיינים) ועורכים את המאפיין של המאפיינים הנתמכים במכשיר.
  2. בסיום העריכה, מקישים על Enter והשינויים במאפיינים יחולו על Home Graph.
  3. אפשר לראות את המאפיינים המעודכנים האלה באזור היומן.

שינוי מצבי המכשיר

  1. בוחרים בכרטיסייה States ועורכים את המדינה ישירות. השינויים במצב ייכנסו לתוקף ב-Home Graph.
  2. אפשר לראות את השינויים האלה במצב באזור היומן.

הוספת אימות משתמש משני למכשיר וירטואלי

אפשר להוסיף SUV למכשירים וירטואליים ולהגדיר את סוג האתגר ואת ההתנהגות התואמת בכל מכשיר. אפשר להוסיף SUV למכשירים וירטואליים ולהגדיר את סוג האתגר ואת ההתנהגות התואמת בכל מכשיר.

הגדרת אימות משתמש משני (SUV) במכשיר

  1. בחלונית Device list, בוחרים את המכשיר הווירטואלי שרוצים להגדיר.
  2. בחלונית Device info, בוחרים בכרטיסייה SUV ומגדירים את הפרטים הבאים:
    • מופעל: האם אימות משתמש משני (SUV) מופעל או מושבת (no challenge) במכשיר.
    • Challenge type: האם ה-SUV מחייב אישור מפורש (ackNeeded) או מספר זיהוי אישי (pinNeeded).
    • PIN: הקוד האישי התקף.
    • טיפול בקוד אימות שגוי: אם קוד האימות שגוי, האם לבקש מהמשתמש להזין אותו שוב, ואם לא, את השגיאה שתוצג.
באיור הזה מוצג כלי UX להפעלת מאפייני אימות משתמש משני במכשיר שנבחר ב-Google Home Playground.

זיהוי מכשירים שמופעלת בהם התכונה SUV

בחלונית רשימת מכשירים, סמל המפתח מפתח מופיע לצד כל מכשיר שתומך ב-SUV.

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

כדי להשתמש ברשימה הבאה של מאפיינים, צריך לציין את סוג הרכב 'SUV':

יצירת מכשיר וירטואלי חדש

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

הסרת מכשיר וירטואלי

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

כלי העריכה של תגובת הסנכרון

אפשר לאמת או לעדכן את תגובת הסנכרון ב-Google Home Playground. לוחצים על כלי העריכה של תגובת הסנכרון כדי לפתוח סביבת פיתוח משולבת (IDE) מוטמעת.

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

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

בתרשים הזה מוצג החלון לעריכת תגובת הסנכרון.

ייבוא וייצוא של מכשירים וירטואליים

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

באיור הזה מוצג כלי ממשק המשתמש לייבוא וליצוא של מכשירי וירטואליים ב-Google Home Playground.

ייצוא מכשירים וירטואליים לקובץ

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

ייבוא מכשירים וירטואליים מקובץ

  1. לוחצים על כדי לייבא מכשירים וירטואליים מקובץ.
  2. בוחרים את הקובץ שרוצים לייבא ולוחצים על אישור.
  3. אחרי שתאשרו את הקובץ לייבוא, Google Home Playground ייבא ממנו מכשירים וירטואליים עם מצבים, ויעדכן את המידע והמצבים של המכשירים המיובאים ב-Home Graph.

בדיקת יומני האינטראקציות

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

כל רשומה ביומן היא מערך JSON שמכיל רכיבים במבנה הבא:

{
  "uri": string,
  "request": object,
  "response": object
}
שדות סוג תיאור
uri string כתובת ה-URL של קריאת ה-API Home Graph.
request object גוף הבקשה של קריאת ה-API Home Graph. הפורמט של כל שיטה מפורט במסמכי העזרה ובמסמכי העזרה.
response object גוף התגובה של קריאת ה-API Home Graph. הפורמט של כל שיטה מפורט במסמכי העזרה ובמסמכי העזרה.

הצגת סוגי המכשירים והמאפיינים הנתמכים

סמל העזרה עם סימן השאלה בפינה השמאלית העליונה יציג את סוג המכשיר הנוכחי ואת רשימת המאפיינים הנתמכים ב-Google Home Playground.

באיור הזה מוצג כלי ממשק המשתמש להוספת סוג מכשיר חדש ב-Google Home Playground.

דיווח על בעיות

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

בתרשים הזה מוצגים הסמלים לשליחת משוב ולדיווח על בעיות ב-Google Home Playground.