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

المسألة القانونية    حزمة تطوير البرامج (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 استخدام لغة python 3.11 أو إصدار أحدث.

هاتف يعمل بنظام التشغيل Android

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

تطبيق Google Home

  1. ثبِّت تطبيق "GHA" على هاتف Android. يُرجى التأكّد من أنّ إصدار GHA هو 3.10.1.6 أو إصدار أحدث.
  2. سجِّل الدخول إلى حسابك على Google في GHA.

تثبيت أداة التشغيل الآلي لواجهة المستخدم في Google Home

هناك طريقتان لتثبيت 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 إصدار مركز للتحكّم في الأجهزة على GHA 15.20221210.3.1
--dut الجهاز قيد الاختبار.
MODEL طراز الجهاز X123123
TYPE نوع الجهاز LIGHT
PROTOCOL بروتوكول الجهاز. MATTER
--fw DEVICE_FIRMWARE البرامج الثابتة على الجهاز 2.2.0

يوضّح هذا الرقم ملخّص اختبار الانحدار

إضافة ملاحظات

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

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

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