Google Home UI Automator

Matter Device SDK

Google Home UI Automator می‌تواند به شما کمک کند Google Home app (GHA) خود را خودکار کنید تا Matter از کار بیندازید، یا آزمایش رگرسیون را در کمیسیون خود اجرا کنید.

این شکل نحوه جفت کردن یک دستگاه Matter را با Google Home نشان می دهد

پیش نیازها

برای استفاده از Google Home UI Automator ، موارد زیر را آماده کنید:

پایتون 3

توصیه می شود برای اجرای اسکریپت از محیط پایتون 3 استفاده کنید. Google Home UI Automator به پایتون 3.11 یا جدیدتر نیاز دارد.

تلفن اندرویدی

  1. حالت User Debugging را در گوشی Android خود روشن کنید. برای روشن کردن تنظیمات اشکال زدایی، به فعال کردن گزینه های برنامه نویس مراجعه کنید.
  2. گوشی Android خود را به کامپیوتر وصل کنید.

برنامه Google Home

  1. GHA روی گوشی Android خود نصب کنید. مطمئن شوید که نسخه GHA 3.10.1.6 یا بالاتر باشد.
  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 ، دستور زیر را وارد کنید:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
مقدار ورودی شرح مثال
DEVICE_NAME دستگاه Matter انتخاب شده. m5stack
PAIRING_CODE کد جفت شدن دستگاه Matter شما. 34970112332
ROOM_NAME اتاق اختصاص داده شده Office

این شکل نحوه جفت کردن یک دستگاه Matter را با Google Home نشان می دهد

دستگاه یک ماده را از کار انداخت

برای از کار انداختن یک دستگاه Matter، دستور زیر را وارد کنید:

ui-automator --decommission DEVICE_NAME
مقدار ورودی شرح مثال
DEVICE_NAME نام دستگاه Matter راه اندازی شده را در GHA نمایش می دهد. m5stack
این شکل نمادهای ارائه بازخورد و گزارش مشکلات در Google Home Playground را نشان می دهد.

تست رگرسیون را اجرا کنید

برای اجرای تست رگرسیون کد زیر را وارد کنید. برای اجرای تست رگرسیون باید flag --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 نسخه هاب برای کنترل دستگاه ها در GHA. 15.20221210.3.1
--dut دستگاه در حال آزمایش
MODEL مدل دستگاه. X123123
TYPE نوع وسیله. LIGHT
PROTOCOL پروتکل دستگاه MATTER
--fw DEVICE_FIRMWARE سیستم عامل دستگاه. 2.2.0

این شکل خلاصه آزمون رگرسیون را نشان می دهد

بازخورد

برای ارسال نظرات یا بازخورد خود در مورد نحوه بهبود تجربه خود با Google Home UI Automator ، فرم بازخورد ما را تکمیل کنید.

مشکلات را گزارش کنید

مشکلات مواجه شده را با استفاده از ردیاب مشکل گزارش کنید.