Kể từ năm 2026, mọi hoạt động kiểm thử và tích hợp Matter đều sẽ yêu cầu Kiểm thử khả năng tương tác của Liên minh. Để biết thêm thông tin, hãy xem trang chuyển đổi Phòng thử nghiệm khả năng tương tác của Liên minh.

Trình tự động hoá giao diện người dùng của Google Home

Matter

Google Home UI Automator có thể giúp bạn tự động hoá Google Home app (GHA) để đưa vào sử dụng, ngừng sử dụng Matter, hoặc chạy kiểm thử hồi quy trên thiết bị đưa vào sử dụng.

Hình này minh hoạ cách ghép nối thiết bị Matter với Google Home

Điều kiện tiên quyết

Để sử dụng Google Home UI Automator, hãy chuẩn bị sẵn những điều sau:

Python 3

Bạn nên sử dụng môi trường Python 3 để chạy tập lệnh. Google Home UI Automator yêu cầu Python 3.11 trở lên.

Điện thoại Android

Bật chế độ Gỡ lỗi người dùng trên Android điện thoại. Xem bài viết Bật Tuỳ chọn cho nhà phát triển để bật chế độ cài đặt gỡ lỗi.
Kết nối điện thoại Android với máy tính.

Ứng dụng Google Home

Cài đặt GHA trên điện thoại Android. Đảm bảo phiên bản GHA là 3.1.1.14 và 3.32.126.2.
Đăng nhập vào Tài khoản Google của bạn trong GHA.

Cài đặt Google Home UI Automator

Có 2 cách để cài đặt Google Home UI Automator: PyPI hoặc từ mã nguồn. Bạn nên cài đặt bằng PyPI.

PyPI (khuyên dùng)

pip install google-home-ui-automator

Tạo từ mã nguồn

Để tạo từ mã nguồn, hãy làm theo các bước sau trong Terminal:

Sao chép kho lưu trữ này:

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

Chuyển đến kho lưu trữ đã sao chép:
```
cd ui-automator
```
Chạy lệnh sau:
```
pip install .
```

Đưa thiết bị Matter vào sử dụng

Để đưa thiết bị Matter vào sử dụng, hãy nhập lệnh sau:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]

Giá trị nhập	Mô tả	Ví dụ:
`DEVICE_NAME`	Thiết bị Matter đã chọn.	`m5stack`
`PAIRING_CODE`	Mã ghép nối của thiết bị Matter.	`34970112332`
`ROOM_NAME`	Phòng được chỉ định.	`Office`
`GOOGLE_ACCOUNT`	Tài khoản dùng trong GHA.	`test@gmail.com`

Hình này minh hoạ cách ghép nối thiết bị Matter với Google Home

Ngừng sử dụng thiết bị Matter

Để ngừng sử dụng thiết bị Matter, hãy nhập lệnh sau:

ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]

Giá trị nhập	Mô tả	Ví dụ:
`DEVICE_NAME`	Hiển thị tên của thiết định Matter đã đưa vào sử dụng trên GHA.	`m5stack`
`GOOGLE_ACCOUNT`	Tài khoản dùng trong GHA.	`test@gmail.com`

Hình ảnh này cho thấy các biểu tượng để gửi ý kiến phản hồi và báo cáo vấn đề trong Google Home Playground.

Chạy kiểm thử hồi quy

Để chạy kiểm thử hồi quy, hãy nhập mã sau. Bạn phải thêm cờ --regtest và --commission để chạy kiểm thử hồi quy.

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]

Giá trị nhập	Mô tả	Ví dụ:
`DEVICE_NAME`	Thiết bị Matter đã chọn.	`m5stack`
`PAIRING_CODE`	Mã ghép nối của thiết bị Matter.	`34970112332`
`ROOM_NAME`	Phòng được chỉ định.	`Office`
`GOOGLE_ACCOUNT`	Tài khoản dùng trong GHA.	`test@gmail.com`

Kiểm thử hồi quy chỉ hỗ trợ chu trình đưa vào sử dụng và ngừng sử dụng. Theo mặc định, kiểm thử hồi quy sẽ chạy cho đến khi người dùng dùng bàn phím để dừng quy trình.

Bạn có thể thêm thông tin sau để có kết quả kiểm thử chi tiết hơn:

Giá trị	Giá trị nhập	Mô tả	Ví dụ:
`--repeat`	`REPEAT_TIMES`	Chạy kiểm thử hồi quy trong số lần giới hạn và số lần lặp lại.	`5`
`--hub`	`HUB_VERSION`	Phiên bản trung tâm điều khiển để điều khiển thiết bị trên GHA.	`15.20221210.3.1`
`--dut`		Thiết bị đang được kiểm thử.
	`MODEL`	Kiểu thiết bị.	`X123123`
	`TYPE`	Loại thiết bị.	`LIGHT`
	`PROTOCOL`	Giao thức thiết bị.	`MATTER`
`--fw`	`DEVICE_FIRMWARE`	Chương trình cơ sở của thiết bị.	`2.2.0`

Hình này cho thấy bản tóm tắt kiểm thử hồi quy

Phản hồi

Để gửi ý kiến hoặc phản hồi về cách cải thiện trải nghiệm của bạn với Google Home UI Automator, hãy hoàn thành Biểu mẫu phản hồicủa chúng tôi.

Báo cáo sự cố

Báo cáo các sự cố gặp phải bằng công cụ theo dõi lỗi.