Google Home Playground

Cloud-to-cloud    Local Home SDK    Home APIs

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

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

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

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

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

כניסה לחשבון

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

הפעלת Playground

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

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

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

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

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

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

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

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

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

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

שינוי התכונות הנתמכות

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

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

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

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

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

הוספת אימות משתמש נוסף (SUV) למכשיר וירטואלי

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

הגדרת SUV במכשיר

1. בחלונית Device list, בוחרים את המכשיר הווירטואלי שרוצים להגדיר.
2. בחלונית פרטי המכשיר, בוחרים בכרטיסייה SUV ומגדירים את האפשרויות הבאות:
   • מופעל: אם אימות המשתמש המשני מופעל או מושבת (ללא אימות) במכשיר.
   • סוג האימות: אם ה-SUV דורש אישור מפורש (ackNeeded) או קוד אימות (pinNeeded).
   • קוד אימות: קוד האימות התקין.
   • טיפול בקוד אימות שגוי: אם קוד האימות שגוי, האם לבקש מהמשתמש להזין אותו שוב, ואם לא, מהי השגיאה שתוצג.

זיהוי מכשירים שמאפשרים SUV

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

התכונות הבאות דורשות SUV:

• ArmDisarm
• LockUnlock
• OpenClose
• הפעלה מחדש
• SoftwareUpdate

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "uri": string,
  "request": object,
  "response": object
}

סוגי מכשירים ו-traits נתמכים

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

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

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