أداة برمجة واجهة مستخدم Google Home

معيار Matter

يمكن أن يساعدك 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

1. فعِّل وضع تصحيح أخطاء المستخدم على Android هاتف. راجِع مقالة تفعيل "خيارات المطوّرين" لتفعيل إعداد تصحيح الأخطاء.
2. وصِّل هاتف Android بالكمبيوتر.

تطبيق Google Home

1. ثبِّت GHA على هاتف Android. تأكَّد من أنّ إصدار GHA هو 3.1.1.14 و3.32.126.2.
2. سجِّل الدخول إلى حساب Google في GHA.

تثبيت Google Home UI Automator

هناك طريقتان لتثبيت Google Home UI Automator، إما من PyPI أو من رمز المصدر. ننصحك بالتثبيت باستخدام 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 [--google_account GOOGLE_ACCOUNT]

إيقاف جهاز Matter

لإيقاف جهاز Matter، أدخِل الأمر التالي:

ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]

إجراء اختبار تراجع

لإجراء اختبار تراجع، أدخِل الرمز التالي. يجب تضمين العلامتَين --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]

لا يتيح اختبار التراجع سوى دورة التشغيل والإيقاف. تلقائيًا، سيستمر اختبار التراجع إلى أن يستخدم المستخدمون لوحة المفاتيح لإيقاف العملية.

يمكنك إضافة ما يلي للحصول على نتائج اختبار أكثر تفصيلاً:

الملاحظات

لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربتك مع الـ Google Home UI Automator، يُرجى ملء نموذج الملاحظات.

الإبلاغ عن المشاكل

يُرجى الإبلاغ عن المشاكل التي تواجهك باستخدام أداة تتبُّع المشاكل.