Google Home UI Automator می‌تواند به شما کمک کند Google Home app (GHA) خود را برای راه‌اندازی، ازکار انداختن Matter، یا اجرای آزمون پسرفت روی کارمزدتان خودکارسازی کنید.
پیش‌نیازها
برای استفاده از Google Home UI Automator، موارد زیر را آماده کنید:
Python 3
توصیه می‌شود از محیط Python 3 برای اجرای دستورگان استفاده کنید.
Google Home UI Automator به python 3.11 یا جدیدتر نیاز دارد.
تلفن Android
- حالت عیب‌یابی کاربر را در تلفن Android روشن کنید. برای روشن کردن تنظیم اشکال‌زدایی، فعال کردن گزینه‌های توسعه‌دهندگان را ببینید.
- تلفن Android خود را به رایانه متصل کنید.
برنامه Google Home
- GHA را در تلفن Android نصب کنید.
مطمئن شوید نسخه GHA
3.1.1.14و3.32.126.2باشد. - در GHA به سیستم «حساب Google» خود وارد شوید.
نصب کردن «خودکارساز واسط کاربر Google Home»
دو روش برای نصب Google Home UI Automator وجود دارد: PyPI یا از کد منبع. توصیه می‌کنیم با PyPI نصب کنید.
PyPI (توصیه‌شده)
pip install google-home-ui-automator
ساختن از کد منبع
برای ساختن از کد منبع، این مراحل را در پایانه دنبال کنید:
همسانه‌سازی کردن این مخزن:
git clone https://testsuite-smarthome-matter.googlesource.com/ui-automatorبه مخزن همسانه‌سازی‌شده پیمایش کنید:
cd ui-automatorفرمان زیر را اجرا کنید:
pip install .
راه‌اندازی دستگاه Matter
برای مأمور کردن دستگاه Matter، فرمان زیر را وارد کنید:
ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
| مقدار ورودی | شرح | مثال |
|---|---|---|
DEVICE_NAME |
Matter دستگاه انتخاب شد. | m5stack |
PAIRING_CODE |
کد جفت‌سازی دستگاه Matter. | 34970112332 |
ROOM_NAME |
اتاق اختصاص داده شد. | Office |
GOOGLE_ACCOUNT |
حسابی که در GHA استفاده می‌شود. | test@gmail.com |
ازکار انداختن دستگاه Matter
برای ازکار انداختن دستگاه Matter، فرمان زیر را وارد کنید:
ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
| مقدار ورودی | شرح | مثال |
|---|---|---|
DEVICE_NAME |
نام دستگاه Matter را که در GHA راه‌اندازی شده است نمایش می‌دهد. | m5stack |
GOOGLE_ACCOUNT |
حسابی که در GHA استفاده می‌شود. | test@gmail.com |
اجرای آزمون پسرفت
برای اجرای آزمون پسرفت، کد زیر را وارد کنید. برای اجرای آزمون پسرفت، باید 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] [--google_account GOOGLE_ACCOUNT]
| مقدار ورودی | شرح | مثال |
|---|---|---|
DEVICE_NAME |
Matter دستگاه انتخاب شد. | m5stack |
PAIRING_CODE |
کد جفت‌سازی دستگاه Matter. | 34970112332 |
ROOM_NAME |
اتاق اختصاص داده شد. | Office |
GOOGLE_ACCOUNT |
حسابی که در GHA استفاده می‌شود. | test@gmail.com |
آزمایش پسرفت فقط از چرخه راه‌اندازی و ازکار انداختن پشتیبانی می‌کند. به‌طور پیش‌فرض، آزمون پسرفت تا زمانی اجرا می‌شود که کاربران از صفحه‌کلید برای متوقف کردن فرایند استفاده کنند.
برای نتایج آزمایش دقیق‌تر می‌توانید موارد زیر را اضافه کنید:
| مقدار | مقدار ورودی | شرح | مثال |
|---|---|---|---|
--repeat |
REPEAT_TIMES |
اجرای آزمون پسرفت در زمان‌های محدود و زمان‌های تکراری. | 5 |
--hub |
HUB_VERSION |
نسخه مرکز کنترل برای کنترل دستگاه‌ها در «برنامه Google Home». | 15.20221210.3.1 |
--dut |
دستگاه تحت آزمایش. | ||
MODEL |
مدل دستگاه. | X123123 |
|
TYPE |
نوع دستگاه. | LIGHT |
|
PROTOCOL |
پروتکل دستگاه. | MATTER |
|
--fw |
DEVICE_FIRMWARE |
سفت‌افزار دستگاه. | 2.2.0 |
بازخورد
برای ارسال نظرات یا بازخورد خود درباره نحوه بهبود تجربه‌تان با Google Home UI Automator، فرم بازخورد ما را تکمیل کنید.
گزارش کردن مشکلات
مشکلات مواجه‌شده را بااستفاده از پیگیری‌کننده مشکل گزارش کنید.