חבילת הבדיקה של Google Home

Google Home Test Suite הוא אפליקציית אינטרנט שמאפשרת לך לבדוק את הפעולה בבית החכם בעצמכם. Test Suite יוצר ומריץ מקרי בדיקה באופן אוטומטי על סמך המכשירים והתכונות המשויך לחשבון שלך. בסיום הבדיקות אפשר לראות את הבדיקות תוצאות הבדיקה או למלא את טופס השליחה כדי לשלוח את תוצאות הבדיקה אל Google.

הבדיקות שבוצעו על ידי Test Suite כוללות, אבל לא מוגבלת לדברים הבאים:

  • בודק שמצב הדיווח וגם בקשת סנכרון מוטמעת בחשבון של מכשירים ותכונות.

  • מאמת שהכוונה היא QUERY מוטמע במכשיר שלך והתוצאות שלו תואמות לתוצאות שבמצב הדיווח.

אפשר להפעיל את הכלי Test Suite על ידי לחיצה על הלחצן למטה:

הפעלה של Test Suite

בדיקה עצמית של הפעולה

בקטע הבא מוסבר איך להריץ את Test Suite ב- במכשיר ובפרויקט הפעולה של הבית החכם. Test Suite נדרשת כניסה לחשבון כדי שיוכל לבדוק מכשירים Google Home Graph ולשלוח פקודות ישירות אל Google Assistant.

כדי לבדוק את הפעולה בעצמכם, פועלים לפי השלבים הבאים:

  1. בדפדפן האינטרנט, פותחים את Test Suite

  2. נכנסים ל-Google באמצעות הלחצן שבפינה השמאלית העליונה.

  3. מגדירים את פרטי הפרויקט:

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

  4. קובעים את הגדרות הבדיקה:

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

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

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

    4. אם הפעלת את חבילת הבדיקה למכשירי בית מקומי, יש לבחור תמיכה ב-Local Home SDK.

      1. בוחרים באפשרות שירות מקומי או הגדרה חלקה.
      2. לוחצים על תמיכה בשאילתה מקומית אם המכשיר יכול לטפל ב-Intent מסוג QUERY מקומית.

  5. מבצעים הרצת בדיקה ומעיינים בתוצאות:

    1. לוחצים על הבא כדי להתחיל להריץ את הבדיקות. בממשק מוצגים המכשירים ואת התכונות שנבדקות.

  6. הצג את התוצאות דף השליחה:

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

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

בדיקת אימות של קישור חשבונות

קישור חשבונות בתפקיד חשוב בסביבה העסקית של הבית החכם של Google. קישור החשבונות בדיקת האימות ב-Test Suite בודקת את שירות OAuth עבור של בעיות פוטנציאליות.

בדיקת האימות של קישור החשבונות כוללת בדיקות לאימות אסימוני הגישה ורענון של אסימונים:

בדיקת אימות של אסימון גישה

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

פריטי בדיקה הסבר
איך בודקים אם אסימון הגישה הוא בפורמט JWT קישור של חשבון Google לא ממליץ על אסימוני גישה בפורמט JWT. אם פורמט JWT נמצא, מוצגת האזהרה הבאה: The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
לאסימון הגישה שהתוקף שלו פג יש אסימון רענון. כשהתוקף של אסימון הגישה פג, יש לספק אסימון רענון. הבדיקה תיכשל אם לא יימצא אסימון רענון.

בדיקת האימות של האסימון לרענון

אסימוני הרענון נבדקים כדי לוודא שנקודת הקצה (endpoint) של האסימון מוחלפת בצורה תקינה ממיר אותם באסימוני גישה חדשים.

פריטי בדיקה הסבר
אסימון רענון עם אסימון רענון לא חוקי, בודק את תגובת השותף. השרת שלך צריך להחזיר שגיאת HTTP 400 Bad Request עם {"error": "invalid_grant"} לבקשה לא חוקית לאסימון רענון. אם התגובה לא תואמת ל'קוד השגיאה או ההודעה', מקרה הבדיקה הזה ייכשל. כניסה אל להחליף אסימוני רענון באסימוני גישה לקבלת מידע נוסף.
בודקים אם אסימון הגישה עודכן אחרי רענון האסימון. צריך להחזיר אסימוני גישה חדשים בתגובה לאסימון רענון בקשות. אם השרת מספק את אותו אסימון גישה, תרחיש הבדיקה נכשל.
צריך לבדוק אם אסימון הגישה שעדיין בתוקף. מועד התפוגה של אסימון הגישה יוצג.
יש לבדוק אם אסימון הרענון הוחלף במהלך הרענון. אנחנו בודקים אם אסימוני הרענון משתנים אחרי בקשה לאסימון רענון. אם המיקום כשאסימון הרענון משתנה, השרת אמור לבטל את התוקף של רענון ישן בלבד אחרי שנעשה שימוש באסימון רענון חדש, כדי למנוע מרוץ תהליכים. שעלולים לבטל את קישור החשבונות של המשתמש. הבדיקה תיכשל אם לבטל את התוקף של אסימון הרענון הישן לפני שמשתמשים באסימון החדש.

הודעות שגיאה

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

הודעת שגיאה איך פותרים את הבעיה
לא נעשה שימוש ב-HomeGraph API בפרויקט <_id_> לפני או היא מושבתת חשוב לוודא שהפעלתם את HomeGraph API.
היישות המבוקשת לא נמצאה צריך לוודא שהשדה agentUserId תקין ומקושר אל לאחר השיפור.

חשוב לוודא שיש לך הרשאת resourcemanager.projects.get בפרויקט ${your project id} והעניקו את כל הרשאות במסך ההסכמה.

שגיאה בקבלת נתוני המודול: שגיאת getModuleData: תגובה של כשל Http עבור https://hometestSuiteproxy-pa.googleapis.com/v1/Module:get: 403 OK 403
  1. פועלים לפי ההוראות בקטע פתרון בעיות הרשאות IAM כדי לוודא שבחשבון יש את resourcemanager.projects.get הרשאות לפרויקט.
  2. עוברים לדף אפליקציות שיש להן גישה לחשבון כדי לבדוק אם עבור 'חבילת בדיקה לבית חכם':
    • פרטי חשבון בסיסיים
      1. הצגת כתובת האימייל הראשית של חשבון Google
      2. הצגת הפרטים האישיים שלך, כולל פרטים אישיים להיות גלויים לכולם
    • הרשאת גישה נוספת
      1. שימוש בAssistant: גישה רחבה ל חשבון Google שלך
      2. לבדוק את המכשירים לבית החכם ולשלוט בהם בבית החכם תרשים
    אם מופיעה שגיאת הרשאה, צריך קודם להסיר את הגישה ולתת את כל הרשאות שיוצגו במסך ההסכמה כשאתם מתחברים שוב.

שליחת תוצאות הבדיקה

התוצאות מTest Suite צריכות לעבור 100% מהבדיקות לפני לשלוח את טופס האישור. אם יש לכם תכונות שדורשות לבצע בדיקות ידניות, עדיין צריך להריץ את הכלי Test Suite לצרף את התוצאה גם אם היא לא עברה ב-100%.

כדי לשלוח את תוצאות הבדיקה ולאשר את הפעולה בבית החכם, יש לבצע את השלבים הבאים:

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

  4. ממלאים את כל שדות החובה ולוחצים על שליחה.