מגרש משחקים של 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 יפנה אותך אל דף הכניסה לחשבון. לוחצים על Sign in with Google (כניסה באמצעות חשבון Google) ובוחרים את החשבון שאליו רוצים להיכנס.
  5. לוחצים על הלחצן אישור כדי לאשר את קישור החשבונות.
האיור הזה מציג את תהליך קישור החשבון באפליקציית Google Home
            שמחבר את Google Home Playground.

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

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

כניסה לחשבון

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

להפעלת Playground

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הגדרת רכב שטח מסוג SUV במכשיר

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

זיהוי מכשירים שמאפשרים 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 מתועדות באזור היומן. שבה ניתן להרחיב כל רשומה כדי לבדוק את מטענים ייעודיים (payloads) של בקשות 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.

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

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

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

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