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

Konu    Cihaz SDK'sı

Google Home UI Automator, Google Home app (GHA) öğenizi Matter için komisyon almak, kullanımdan kaldırmak veya komisyonunuzda regresyon testi yürütmek üzere otomatikleştirmenize yardımcı olabilir.

Bu görselde, Matter cihazının Google Home ile nasıl eşlendiği gösterilmektedir.

Ön koşullar

Google Home UI Automator uygulamasını 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ü gerektirir.

Android telefon

  1. Android telefonunuzda Kullanıcı Hata Ayıklama modunu açın. Hata ayıklama ayarını açmak için Geliştirici seçeneklerini etkinleştirme bölümüne bakın.
  2. Android telefonunuzu bilgisayarınıza bağlayın.

Google Home uygulaması

  1. GHA uygulamasını Android telefonunuza yükleyin. GHA sürümünün 3.10.1.6 veya sonraki bir sürüm olduğundan emin olun.
  2. GHA uygulamasında Google Hesabınıza giriş yapın.

Google Home Kullanıcı Arayüzü Automator'ı yükleyin

Google Home UI Automator, PyPI 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 derleme yapmak için terminalinizde şu adımları izleyin:

  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ını devreye alın

Bir Matter cihazı yaptırmak 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 görselde, Matter cihazının Google Home ile nasıl eşlendiği gösterilmektedir.

Matter cihazını 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 için devreye alınan Matter cihazın adını gösterir. m5stack
Bu şekilde, Google Home Playground'da geri bildirim sağlama ve sorunları bildirme simgeleri gösterilmektedir.

Regresyon Testi Çalıştırma

Regresyon testi çalıştırmak için aşağıdaki kodu girin. Regresyon 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]

Regresyon testi yalnızca devreye alma ve geçersiz kılma döngüsünü destekler. Varsayılan olarak, kullanıcılar işlemi durdurmak için klavyeyi kullanana kadar regresyon testi ç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 Regresyon testini sınırlı ve tekrarlı zamanlarda çalıştırın. 5
--hub HUB_VERSION GHA'daki cihazları kontrol etmek için kullanılan Hub sürümü. 15.20221210.3.1
--dut Cihaz test ediliyor.
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 şekil, regresyon testi özetini gösterir

Geri bildirim

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

Sorun bildirme

Sorun izleyiciyi kullanarak karşılaştığınız sorunları bildirin.