UI Automator Google Home

Kasus    SDK Perangkat

Google Home UI Automator dapat membantu mengotomatiskan Google Home app (GHA) Anda melakukan commissioning, menghentikan Matter, atau menjalankan regresi menguji komisi Anda.

Gambar ini menunjukkan cara menyambungkan perangkat Matter ke Google Home

Prasyarat

Untuk menggunakan Google Home UI Automator, siapkan hal berikut:

Python 3

Sebaiknya gunakan lingkungan Python 3 untuk menjalankan skrip. Google Home UI Automator memerlukan python 3.11 atau yang lebih baru.

Ponsel Android

  1. Aktifkan mode Proses Debug Pengguna di Android ponsel. Lihat Mengaktifkan Opsi developer untuk mengaktifkan setelan proses debug.
  2. Hubungkan ponsel Android ke komputer.

Aplikasi Google Home

  1. Instal GHA di ponsel Android Anda. Pastikan versi GHA adalah 3.10.1.6 atau yang lebih tinggi.
  2. Login ke Akun Google Anda di GHA.

Menginstal UI Automator Google Home

Ada dua cara untuk menginstal Google Home UI Automator, PyPI, atau dari sumber pada kode sumber. Sebaiknya instal dengan PyPI.

pip install google-home-ui-automator

Membangun dari kode sumber

Untuk membangun dari kode sumber, ikuti langkah-langkah berikut di terminal Anda:

  1. Clone repositori ini:

    git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
    
  2. Buka repositori yang di-clone:

    cd ui-automator
    
  3. Jalankan perintah berikut:

    pip install .
    

Melakukan Commissione untuk perangkat Matter

Untuk melakukan commissioning pada perangkat Matter, masukkan perintah berikut:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
Nilai input Deskripsi Contoh
DEVICE_NAME Perangkat Matter dipilih. m5stack
PAIRING_CODE Kode penyambungan perangkat Matter Anda. 34970112332
ROOM_NAME Ruang yang ditetapkan. Office

Gambar ini menunjukkan cara menyambungkan perangkat Matter ke Google Home

Menonaktifkan perangkat Matter

Untuk menonaktifkan perangkat Matter, masukkan perintah berikut:

ui-automator --decommission DEVICE_NAME
Nilai input Deskripsi Contoh
DEVICE_NAME Menampilkan nama perangkat Matter yang ditugaskan di GHA. m5stack
Gambar ini menunjukkan ikon untuk memberikan masukan dan melaporkan
       masalah di Google Home Playground.

Jalankan Uji Regresi

Untuk menjalankan pengujian regresi, masukkan kode berikut. Anda harus menyertakan tanda --regtest dan --commission untuk menjalankan pengujian regresi.

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

Pengujian regresi hanya mendukung siklus commissioning dan penghentian. Secara default, pengujian regresi akan berjalan hingga pengguna menggunakan keyboard untuk berhenti proses tersebut.

Anda dapat menambahkan kode berikut untuk hasil pengujian yang lebih mendalam:

Nilai Nilai input Deskripsi Contoh
--repeat REPEAT_TIMES Jalankan pengujian regresi dalam waktu terbatas dan berulang kali. 5
--hub HUB_VERSION Versi hub untuk mengontrol perangkat di GHA. 15.20221210.3.1
--dut Perangkat sedang diuji.
MODEL Model perangkat. X123123
TYPE Jenis perangkat. LIGHT
PROTOCOL Protokol perangkat. MATTER
--fw DEVICE_FIRMWARE Firmware perangkat. 2.2.0

Gambar ini menunjukkan ringkasan pengujian regresi

Masukan

Untuk mengirimkan pendapat atau masukan tentang cara meningkatkan pengalaman Anda dengan Google Home UI Automator, selesaikan Formulir Masukan.

Laporkan masalah

Laporkan mengalami masalah saat menggunakan Issue Tracker.