يمكن أن تساعدك Google Home UI Automator في تنفيذ Google Home app (GHA) عمليات التشغيل الآلي الخاصة بتفعيل Matter أو إيقافها أو إجراء اختبار تراجع على عمولتك.
المتطلبات الأساسية
لاستخدام Google Home UI Automator، يجب تحضير ما يلي:
Python 3
يُنصح باستخدام بيئة Python 3 لتشغيل النص البرمجي.
يتطلّب Google Home UI Automator الإصدار 3.11 أو الإصدارات الأحدث من Python.
هاتف Android
- فعِّل وضع تصحيح أخطاء المستخدم على هاتف Android. راجِع مقالة تفعيل خيارات المطوّرين لتفعيل إعداد تصحيح الأخطاء.
- وصِّل هاتف Android بجهاز الكمبيوتر.
تطبيق Google Home
- قم بتثبيت GHA على هاتفك Android.
تأكد من أن إصدار GHA هو
3.1.1.14و3.32.126.2. - قم بتسجيل الدخول إلى حسابك على Google في GHA.
تثبيت Google Home UI Automator
هناك طريقتان لتثبيت 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 |
تشغيل اختبار الانحدار
لتشغيل اختبار الانحدار، أدخل الكود التالي. يجب عليك تضمين العلمين --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" | 15.20221210.3.1 |
--dut |
الجهاز قيد الاختبار | ||
MODEL |
طراز الجهاز | X123123 |
|
TYPE |
نوع الجهاز | LIGHT |
|
PROTOCOL |
بروتوكول الجهاز | MATTER |
|
--fw |
DEVICE_FIRMWARE |
البرامج الثابتة للجهاز | 2.2.0 |
الملاحظات
لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربتك مع Google Home UI Automator، يُرجى ملء نموذج الملاحظات.
الإبلاغ عن المشاكل
يمكنك الإبلاغ عن المشاكل التي تواجهك باستخدام أداة تتبُّع المشاكل.