بدء مسابقة المطوّرين لواجهات برمجة التطبيقات في Home استعرِض مهاراتك للحصول على فرصة الفوز بجوائز قيّمة.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

لاستخدام 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 بتطبيق 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، يُرجى إكمال نموذج استطلاع الآراء والتقييم.

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

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