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

SDK של המכשיר

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

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

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

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

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

כניסה

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

הפעלת Playground

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

לפניכם רשימה של תכונות שנדרש בהן רכב SUV:

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

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

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

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

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

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

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

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

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