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

المسألة القانونية

يمكن أن تساعدك Google Home UI Automator في تنفيذ Google Home app (GHA) عمليات التشغيل الآلي الخاصة بتفعيل Matter أو إيقافها أو إجراء اختبار تراجع على عمولتك.

يوضّح هذا الشكل كيفية إقران جهاز متوافق مع Matter بخدمة Google Home

المتطلبات الأساسية

لاستخدام Google Home UI Automator، يجب أن يكون لديك ما يلي جاهزًا:

بايثون 3

يُنصح باستخدام بيئة Python 3 لتشغيل النص البرمجي. يتطلب Google Home UI Automator Python 3.11 أو أحدث.

هاتف 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.

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]
قيمة الإدخال الوصف مثال
DEVICE_NAME تم اختيار جهاز واحد (Matter). m5stack
PAIRING_CODE رمز الإقران لجهاز Matter 34970112332
ROOM_NAME الغرفة المعيّنة Office
GOOGLE_ACCOUNT الحساب الذي سيتم استخدامه في GHA test@gmail.com

يوضّح هذا الشكل كيفية إقران جهاز متوافق مع Matter بخدمة Google Home

إيقاف تشغيل جهاز Matter

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

ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
قيمة الإدخال الوصف مثال
DEVICE_NAME يعرض اسم الجهاز Matter المُفعّل على GHA. m5stack
GOOGLE_ACCOUNT الحساب الذي سيتم استخدامه في GHA. test@gmail.com
تعرض هذه الصورة رموزًا لإرسال الملاحظات والإبلاغ عن المشاكل في 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] [--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 إصدار المحور للتحكم في الأجهزة على GHA. 15.20221210.3.1
--dut الجهاز قيد الاختبار.
MODEL طراز الجهاز X123123
TYPE نوع الجهاز LIGHT
PROTOCOL بروتوكول الجهاز. MATTER
--fw DEVICE_FIRMWARE البرامج الثابتة للجهاز 2.2.0

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

الملاحظات

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

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

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