UI Automator Google Home

Matter    Device SDK

Google Home UI Automator dapat membantu Anda mengotomatiskan Google Home app (GHA) untuk melakukan komisi, menonaktifkan Matter, atau menjalankan pengujian regresi pada komisi Anda.

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 ponsel Android. Lihat Mengaktifkan Opsi developer untuk mengaktifkan setelan proses debug.
2. Hubungkan ponsel Android ke komputer Anda.

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 kode sumber. Sebaiknya instal dengan PyPI.

PyPI (direkomendasikan)

pip install google-home-ui-automator

Membuat dari kode sumber

Untuk membangun dari kode sumber, ikuti langkah-langkah ini 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 komisi 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	Matter perangkat dipilih.	m5stack
PAIRING_CODE	Kode penyambungan perangkat Matter.	34970112332
ROOM_NAME	Ruang yang ditetapkan.	Office

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 dipesan pada GHA.	m5stack

Jalankan Uji 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]

Uji regresi hanya mendukung siklus commissioning dan penonaktifan. Secara default, pengujian regresi akan berjalan hingga pengguna menggunakan keyboard untuk menghentikan prosesnya.

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

Nilai	Nilai input	Deskripsi	Contoh
--repeat	REPEAT_TIMES	Jalankan uji regresi dalam waktu terbatas dan berulang.	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

Masukan

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

Laporkan masalah

Laporan mengalami masalah saat menggunakan issue tracker.