Google Home Kullanıcı Arayüzü Otomatikleştirici

Matter    Cihaz SDK'sı

Google Home UI Automator, Google Home app (GHA)'unuzu otomatik olarak etkinleştirmenize, Matter'yi devre dışı bırakmanıza veya komisyonunuzda regresyon testi çalıştırmanıza yardımcı olabilir.

Bu resimde, bir Matter cihazının Google Home ile nasıl eşleneceği gösterilmektedir

Ön koşullar

Google Home UI Automator'ü kullanmak için aşağıdakileri hazır bulundurun:

Python 3

Komut dosyasını çalıştırmak için Python 3 ortamının kullanılması önerilir. Google Home UI Automator, python 3.11 veya daha yeni bir sürümünü gerektirir.

Android telefon

  1. Androidtelefonunuzda Kullanıcı Hata Ayıklama modunu açın. Hata ayıklama ayarını açmak için Geliştirici seçeneklerini etkinleştirme başlıklı makaleyi inceleyin.
  2. Android telefonunuzu bilgisayarınıza bağlayın.

Google Home uygulaması

  1. Android telefonunuza GHA'ü yükleyin. GHA sürümünün 3.1.1.14 ve 3.25.1.4 olduğundan emin olun.
  2. GHA'te Google Hesabınıza giriş yapın.

Google Home UI Otomasyon'u yükleme

Google Home UI Automator'yi PyPI'den veya kaynak kodundan yüklemenin iki yolu vardır. PyPI ile yüklemenizi öneririz.

pip install google-home-ui-automator

Kaynak kodundan derleme

Kaynak kodundan derlemek için terminalinizde aşağıdaki adımları uygulayın:

  1. Bu depoyu klonlayın:

    git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator

  2. Klonlanan depoya gidin:

    cd ui-automator

  3. Aşağıdaki komutu çalıştırın:

    pip install .

Matter cihazı kurma

Matter cihazını devreye almak için aşağıdaki komutu girin:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
Giriş değeri Açıklama Örnek
DEVICE_NAME Matter cihazı seçildi. m5stack
PAIRING_CODE Matter cihazınızın eşleme kodu. 34970112332
ROOM_NAME Atanan oda. Office

Bu resimde, bir Matter cihazının Google Home ile nasıl eşleneceği gösterilmektedir

Matter cihazı kullanımdan kaldırma

Bir Matter cihazını devre dışı bırakmak için aşağıdaki komutu girin:

ui-automator --decommission DEVICE_NAME
Giriş değeri Açıklama Örnek
DEVICE_NAME GHA'da görevlendirilmiş Matter cihazın adını gösterir. m5stack
Bu resimde, Google Home Playground'ta geri bildirim verme ve sorun bildirme simgelerini görebilirsiniz.

Gerileme testi çalıştırma

Geriye dönük test çalıştırmak için aşağıdaki kodu girin. Gerileme testini çalıştırmak için --regtest ve --commission işaretini eklemeniz gerekir.

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE]

Gerileme testi yalnızca devreye alma ve devre dışı bırakma döngüsünü destekler. Varsayılan olarak, kullanıcılar süreci durdurmak için klavyeyi kullanana kadar geriye dönük test çalıştırılır.

Daha ayrıntılı test sonuçları için aşağıdakileri ekleyebilirsiniz:

Değer Giriş değeri Açıklama Örnek
--repeat REPEAT_TIMES Gerileme testini sınırlı sayıda ve tekrarlı olarak çalıştırın. 5
--hub HUB_VERSION GHA'da cihazları kontrol etmek için kullanılan Hub sürümü. 15.20221210.3.1
--dut Test edilen cihaz.
MODEL Cihaz modeli. X123123
TYPE Cihaz türü LIGHT
PROTOCOL Cihaz protokolü. MATTER
--fw DEVICE_FIRMWARE Cihazın donanım yazılımı. 2.2.0

Bu resimde, regresyon testi özeti gösterilmektedir

Geri bildirim

Google Home UI Automator ile ilgili deneyiminizin nasıl iyileştirilebileceğiyle ilgili düşüncelerinizi veya geri bildirimlerinizi göndermek için Geri Bildirim Formumuzu doldurun.

Sorun bildirme

Karşılaştığınız sorunları sorun izleyici'yi kullanarak bildirin.