מענן לענן Local Home SDK Device SDK
Google Home Playground היא אפליקציית אינטרנט שמסימולטת פרויקט של בית חכם עם מאפיינים וסוגים של מכשירים שניתן להגדיר. אפשר ליצור מכשירי וירטואליים, לשנות את המאפיינים והמצבים של המכשירים, להציג את המכשירים האלה ב-Google Home Graph ולייבא או לייצא הגדרות של מכשירים.
השלמת קישור החשבונות
כדי להשתמש ב-Google Home Playground, מומלץ קודם לקשר את הכלי לחשבון. פותחים את Google Home app (GHA) בטלפון ומבצעים את תהליך קישור החשבון:
- לוחצים על סמל הפלוס (+) בפינה הימנית העליונה.
- בוחרים באפשרות הגדרת המכשיר > פועל עם Google.
- מחפשים את הפעולה Google Home Playground.
- בוחרים את הפעולה, והסמל GHA יעביר אתכם לדף הכניסה. לוחצים על כניסה באמצעות חשבון Google ובוחרים את החשבון שאליו רוצים להיכנס.
- לוחצים על הלחצן אישור כדי לאשר את קישור החשבונות.
אחרי שתשלימו את קישור החשבון, יוצגו ב-GHA קבוצה של מכשירים וירטואליים שמוגדרים כברירת מחדל, שתוכלו לבצע איתם פעולות.
כניסה לחשבון
כדי להפעיל את Google Home Playground, לוחצים על הלחצן שלמטה:
לוחצים על Sign in with Google (כניסה באמצעות חשבון Google). חשוב להיכנס לאותו חשבון שבו השתמשתם ב-GHA כדי להשלים את קישור החשבון.
אחרי הכניסה, יוצגו ב-Google Home Playground המכשירים הווירטואליים ששמורים ב-Home Graph.
ממשק המשתמש באינטרנט מורכב משלושה חלוניות:
- ברשימת המכשירים מוצגים כל המכשירים הווירטואליים. אפשר לבחור מכשיר וירטואלי מסוים כדי להציג את המידע שלו וליצור מכשירי וירטואליים באמצעות הלוח הזה.
- בקטע פרטי המכשיר מוצג המידע על המכשיר הווירטואלי שנבחר. אפשר גם לערוך את המידע הזה ולהסיר את המכשיר הווירטואלי שנבחר דרך החלונית.
- באזור היומנים מוצגים יומני האינטראקציה בין Google Home Playground לבין Home Graph. אפשר להרחיב את היומנים כדי לבדוק את עומסי העבודה של הבקשה והתגובה לצורך פתרון בעיות.
מכשיר וירטואלי
הצגת פרטי המכשיר הווירטואלי
בחלונית Device list (רשימת מכשירים), בוחרים את המכשיר הווירטואלי שרוצים להציג. בחלונית Device list (רשימת מכשירים), בוחרים את המכשיר הווירטואלי שרוצים להציג. בחלונית מידע על המכשיר יוצגו הפרטים של המכשיר, שמחולקים לחמש כרטיסיות:
- מידע בסיסי: מאפיינים ברמה העליונה של המכשיר, כולל סוג המכשיר, המזהה והשם שלו.
- Traits: מאפייני המכשיר הנתמכים.
- מאפיינים: מאפיינים ספציפיים למאפיין של המכשיר.
- States: כל מצבי המכשיר.
- SUV: הגדרת אימות משתמש משני במכשיר.
עריכת פרטי המכשיר הווירטואלי
בנוסף להצגת המידע של מכשיר וירטואלי, אפשר גם לערוך ישירות את המידע שלו ששמור ב-Home Graph דרך החלונית פרטי המכשיר.
שינוי מאפייני traits נתמכים
- בוחרים בכרטיסייה מאפיינים ולוחצים על הלחצן עריכה.
- בחלונית הקופצת תוכלו לראות את המאפיינים הנתמכים כרגע במכשיר ואת המאפיינים הזמינים להוספה. משתמשים בלחצני החץ
(arrow_forward/arrow_back) כדי להוסיף או להסיר מאפיינים נתמכים של המכשיר. - כשמסיימים לעדכן את המאפיינים הנתמכים, לוחצים על Save והמאפיינים המעודכנים יחולו על Home Graph.
- אפשר לראות את העדכונים האלה למאפיינים באזור היומן.
שינוי מאפייני המכשיר
- בוחרים בכרטיסייה Attributes (מאפיינים) ועורכים את המאפיין של המאפיינים הנתמכים במכשיר.
- בסיום העריכה, מקישים על Enter והשינויים במאפיינים יחולו על Home Graph.
- אפשר לראות את המאפיינים המעודכנים האלה באזור היומן.
שינוי מצבי המכשיר
- בוחרים בכרטיסייה States ועורכים את המדינה ישירות. השינויים במצב ייכנסו לתוקף ב-Home Graph.
- אפשר לראות את השינויים האלה במצב באזור היומן.
הוספת אימות משתמש משני למכשיר וירטואלי
אפשר להוסיף SUV למכשירים וירטואליים ולהגדיר את סוג האתגר ואת ההתנהגות התואמת בכל מכשיר. אפשר להוסיף SUV למכשירים וירטואליים ולהגדיר את סוג האתגר ואת ההתנהגות התואמת בכל מכשיר.
הגדרת אימות משתמש משני (SUV) במכשיר
- בחלונית Device list, בוחרים את המכשיר הווירטואלי שרוצים להגדיר.
- בחלונית Device info, בוחרים בכרטיסייה SUV ומגדירים את הפרטים הבאים:
- מופעל: האם אימות משתמש משני (SUV) מופעל או מושבת (no challenge) במכשיר.
- Challenge type: האם ה-SUV מחייב אישור מפורש (ackNeeded) או מספר זיהוי אישי (pinNeeded).
- PIN: הקוד האישי התקף.
- טיפול בקוד אימות שגוי: אם קוד האימות שגוי, האם לבקש מהמשתמש להזין אותו שוב, ואם לא, את השגיאה שתוצג.
זיהוי מכשירים שמופעלת בהם התכונה SUV
בחלונית רשימת מכשירים, סמל המפתח מפתח מופיע לצד כל מכשיר שתומך ב-SUV.
כדי להשתמש ברשימה הבאה של מאפיינים, צריך לציין את סוג הרכב 'SUV':
יצירת מכשיר וירטואלי חדש
- בחלונית רשימת המכשירים, לוחצים על הוספת מכשיר.
- בחלונית הקופצת, בוחרים את סוג המכשיר ומזינים את שם המכשיר החדש. לחלופין, אפשר לבחור קבוצה מוגדרת מראש של מכשירים להוספה.
- אחרי שמשלימים את כל השלבים, המכשיר החדש מתווסף ל-Home Graph.
הסרת מכשיר וירטואלי
- בחלונית רשימת מכשירים, בוחרים את המכשיר שרוצים להסיר. לאחר מכן, בחלונית מידע על המכשיר, בוחרים בכרטיסייה מידע בסיסי ולוחצים על הסרת המכשיר בתחתית המסך.
- מאשרים את הסרת המכשיר בהתראה הקופצת.
- אחרי שתאשרו את הסרת המכשיר, הוא יוסר מ-Home Graph.
כלי העריכה של תגובת הסנכרון
אפשר לאמת או לעדכן את תגובת הסנכרון ב-Google Home Playground. לוחצים על כלי העריכה של תגובת הסנכרון כדי לפתוח סביבת פיתוח משולבת (IDE) מוטמעת.
עורכים את תגובת הסנכרון או מעתיקים ומדביקים אותה, ולוחצים על שמירה כדי להחיל את השינויים ולראות איך היא פועלת בסביבה של Google Home.
ייבוא וייצוא של מכשירים וירטואליים
כדי לפתור בעיות או לשחזר אותן, אפשר לייצא את המכשירים הווירטואליים עם המצבים שלהם לקובץ ולשתף את הקובץ עם אחרים כדי לייבא ולשכפל את המכשירים הווירטואליים.
ייצוא מכשירים וירטואליים לקובץ
- לוחצים על כדי לייצא מכשירי וירטואליים לקובץ.
- מזינים את שם הקובץ שרוצים לייצא ולוחצים על אישור.
- אחרי שמזינים את שם הקובץ, הדפדפן מוריד את הקובץ של המכשירים הווירטואליים המיוצאים.
ייבוא מכשירים וירטואליים מקובץ
- לוחצים על כדי לייבא מכשירים וירטואליים מקובץ.
- בוחרים את הקובץ שרוצים לייבא ולוחצים על אישור.
- אחרי שתאשרו את הקובץ לייבוא, 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.
דיווח על בעיות
נשמח לשמוע ממך. מדווחים על בעיות שנתקלת בהן באמצעות סמל סימן הקריאה משוב בפינה השמאלית העליונה.