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

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. לוחצים על הלחצן Authorize כדי לאשר את קישור החשבון.

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

כניסה

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

הפעלת Playground

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

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

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

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

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

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

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

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

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

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

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

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

שינוי מאפיינים במכשיר

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

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

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

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

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

הגדרת רכב פנאי-שטח במכשיר

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

זיהוי מכשירים שמאפשרים רכב פנאי-שטח (SUV)

בחלונית List device, מוצג מפתח מפתחות מפתח לצד כל מכשיר שמותאם ל-SUV.

רשימת המאפיינים הבאה מחייבת רכב פנאי-שטח (SUV):

• רמת זרוע
• נעילת נעילה
• פתיחה וסגירה
• הפעלה מחדש
• SoftwareUpdate

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

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

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

1. בחלונית רשימת המכשירים, בוחרים את המכשיר שרוצים להסיר. לאחר מכן, בחלונית פרטי המכשיר, בוחרים בכרטיסייה Basic Information, ואז בחלונית Device Information, לוחצים על הכרטיסייה Basic Information ואז על Remove device בתחתית המסך.
2. מאשרים את הסרת המכשיר בהתראה הקופצת.
3. לאחר אישור הסרת המכשיר, הוא יוסר מ-Home Graph.

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

אפשר לאמת או לעדכן את תגובת הסנכרון בGoogle Home Playground. לוחצים על Sync Editor Editor כדי לפתוח מזהה 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, שבה אפשר להרחיב כל רשומה כדי לבדוק את בקשות ה-API ואת עומסי התגובה של Home Graph.

כל רשומה ביומן היא מערך 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.

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

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