UI Automator Google Home

Matter

Google Home UI Automator dapat membantu Anda mengotomatiskan Google Home app (GHA) untuk menugaskan, menghentikan penugasan Matter, atau menjalankan regresi pengujian pada penugasan 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 User Debugging di Android ponsel Anda. Lihat Mengaktifkan opsi Developer untuk mengaktifkan setelan proses debug.
  2. Hubungkan ponsel Android Anda ke komputer.

Aplikasi Google Home

  1. Instal GHA di ponsel Android Anda. Pastikan versi GHA adalah 3.1.1.14 dan 3.32.126.2.
  2. Login ke Akun Google Anda di GHA.

Menginstal Google Home UI Automator

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

pip install google-home-ui-automator

Membuat dari kode sumber

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

  1. Buat 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 .

Menugaskan perangkat Matter

Untuk menugaskan perangkat Matter, masukkan perintah berikut:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
Nilai input Deskripsi Contoh
DEVICE_NAME Perangkat Matter yang dipilih. m5stack
PAIRING_CODE Kode pairing perangkat Matter Anda. 34970112332
ROOM_NAME Ruangan yang ditetapkan. Office
GOOGLE_ACCOUNT Akun yang akan digunakan di GHA. test@gmail.com

Gambar ini menunjukkan cara menyambungkan perangkat Matter ke Google Home

Menghentikan penugasan perangkat Matter

Untuk menghentikan penugasan perangkat Matter, masukkan perintah berikut:

ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
Nilai input Deskripsi Contoh
DEVICE_NAME Menampilkan nama perangkat yang ditugaskan Matter di GHA. m5stack
GOOGLE_ACCOUNT Akun yang akan digunakan di GHA. test@gmail.com
Gambar ini menunjukkan ikon untuk memberikan masukan dan melaporkan masalah di Google Home Playground.

Menjalankan Pengujian Regresi

Untuk menjalankan pengujian regresi, masukkan kode berikut. Anda harus menyertakan flag --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] [--google_account GOOGLE_ACCOUNT]
Nilai input Deskripsi Contoh
DEVICE_NAME Perangkat Matter yang dipilih. m5stack
PAIRING_CODE Kode pairing perangkat Matter Anda. 34970112332
ROOM_NAME Ruangan yang ditetapkan. Office
GOOGLE_ACCOUNT Akun yang akan digunakan di GHA. test@gmail.com

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

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

Nilai Nilai input Deskripsi Contoh
--repeat REPEAT_TIMES Menjalankan pengujian regresi dalam waktu terbatas dan berulang. 5
--hub HUB_VERSION Versi hub untuk mengontrol perangkat di GHA. 15.20221210.3.1
--dut Perangkat yang 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 Anda tentang cara meningkatkan pengalaman Anda dengan Google Home UI Automator, isi Formulir Masukan kami.

Melaporkan masalah

Laporkan masalah yang Anda temui menggunakan the issue tracker.