אוטומציה של ממשק המשתמש של Google Home

Matter    Device SDK

Google Home UI Automator יכול לעזור לכם להגדיר אוטומציה של Google Home app (GHA) להפעלת עמלות, להוצאה משימוש של Matter או להרצת בדיקת רגרסיה על העמלה.

איור שמראה איך להתאים מכשיר Matter ל-Google Home

דרישות מוקדמות

כדי להשתמש ב-Google Home UI Automator, צריך להכין את הפריטים הבאים:

Python 3

מומלץ להשתמש בסביבת Python 3 כדי להריץ את הסקריפט. כדי להשתמש ב-Google Home UI Automator, נדרשת גרסה 3.11 ואילך של Python.

טלפון Android

  1. מפעילים את המצב ניפוי באגים של משתמשים בטלפון Android. במאמר הפעלת אפשרויות למפתחים מוסבר איך להפעיל את הגדרת ניפוי הבאגים.
  2. מחברים את הטלפון מדגם Android למחשב.

אפליקציית Google Home

  1. מתקינים את GHA בטלפון Android. מוודאים שגרסת GHA היא 3.1.1.14 ו-3.24.1.4.
  2. נכנסים לחשבון Google ב-GHA.

התקנה של Google Home UI Automator

יש שתי דרכים להתקין את Google Home UI Automator: PyPI או מקוד המקור. מומלץ להתקין באמצעות PyPI.

pip install google-home-ui-automator

פיתוח מקוד מקור

כדי ליצור גרסה מבוססת-מקור, מבצעים את השלבים הבאים במסוף:

  1. משכפלים את המאגר הזה:

    git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
    
  2. עוברים למאגר המשובך:

    cd ui-automator
    
  3. מריצים את הפקודה הבאה:

    pip install .
    

איך מגדירים מכשיר בתקן Matter

כדי להפעיל מכשיר Matter, מזינים את הפקודה הבאה:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
ערך קלט תיאור דוגמה
DEVICE_NAME מכשיר Matter שנבחר. m5stack
PAIRING_CODE קוד ההתאמה של מכשיר Matter. 34970112332
ROOM_NAME החדר שהוקצה. Office

איור שמראה איך להתאים מכשיר Matter ל-Google Home

הוצאה משימוש של מכשיר בתקן Matter

כדי להוציא משימוש מכשיר Matter, מזינים את הפקודה הבאה:

ui-automator --decommission DEVICE_NAME
ערך קלט תיאור דוגמה
DEVICE_NAME השם של מכשיר Matter שהוקצה ב-GHA. m5stack
בתרשים הזה מוצגים הסמלים לשליחת משוב ולדיווח על בעיות ב-Google Home Playground.

הרצת בדיקת רגרסיה

כדי להריץ בדיקת רגרסיה, מזינים את הקוד הבא. כדי להריץ את בדיקת הרגרסיה, צריך לכלול את הדגלים --regtest ו---commission.

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE]

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

כדי לקבל תוצאות בדיקה מפורטות יותר, אפשר להוסיף את האפשרויות הבאות:

ערך ערך קלט תיאור דוגמה
--repeat REPEAT_TIMES הפעלת בדיקת רגרסיה במספר מוגבל של פעמים ובתדירות קבועה. 5
--hub HUB_VERSION גרסת Hub לשליטה במכשירים ב-GHA. 15.20221210.3.1
--dut המכשיר שנבדק.
MODEL דגם המכשיר. X123123
TYPE סוג המכשיר. LIGHT
PROTOCOL פרוטוקול המכשיר. MATTER
--fw DEVICE_FIRMWARE הקושחה של המכשיר. 2.2.0

באיור הזה מוצג סיכום של בדיקת הרגרסיה

משוב

כדי לשלוח לנו משוב על דרכים לשיפור חוויית השימוש ב-Google Home UI Automator, אפשר למלא את טופס המשוב.

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

מדווחים על בעיות באמצעות מערכת המעקב אחר בעיות.