Cuộc thi dành cho nhà phát triển về API Home đã bắt đầu! Hãy thể hiện kỹ năng của bạn để có cơ hội giành những phần thưởng hấp dẫn.

Trang này được dịch bởi Cloud Translation API.

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) để uỷ quyền, huỷ uỷ quyền Matter hoặc chạy thử nghiệm hồi quy trên uỷ quyền của bạn.

Hình này cho thấy 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ị những thứ sau:

Python 3

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 hoặc phiên bản mới hơn.

Điện thoại Android

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

Ứng dụng Google Home

Cài đặt GHA trên điện thoại Android của bạn. Đảm bảo phiên bản của 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ó hai cách để cài đặt Google Home UI Automator, PyPI hoặc từ mã nguồn. Chúng tôi khuyên bạn nên cài đặt bằng PyPI.

PyPI (khuyến nghị)

pip install google-home-ui-automator

Xây dựng từ mã nguồn

Để tạo từ mã nguồn, hãy làm theo các bước sau trong thiết bị đầu cuối:

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

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

Điều hướng đến kho lưu trữ đã sao chép:
```
cd ui-automator
```
Chạy lệnh sau:
```
pip install .
```

Uỷ quyền cho thiết bị theo chuẩn Matter

Để đưa thiết bị Matter vào hoạt độ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`	Đã chọn Matter thiết bị.	`m5stack`
`PAIRING_CODE`	Mã ghép nối của thiết bị Matter của bạn.	`34970112332`
`ROOM_NAME`	Phòng được chỉ định.	`Office`
`GOOGLE_ACCOUNT`	Tài khoản để sử dụng trong GHA.	`test@gmail.com`

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

Tháo dỡ thiết bị Matter

Để ngừng hoạt độ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 bị Matter đã được thiết lập trên GHA.	`m5stack`
`GOOGLE_ACCOUNT`	Tài khoản để sử 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 bao gồm cờ --regtest và --commission để chạy thử nghiệm 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`	Đã chọn Matter thiết bị.	`m5stack`
`PAIRING_CODE`	Mã ghép nối của thiết bị Matter của bạn.	`34970112332`
`ROOM_NAME`	Phòng được chỉ định.	`Office`
`GOOGLE_ACCOUNT`	Tài khoản để sử dụng trong GHA.	`test@gmail.com`

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

Bạn có thể thêm những thông tin sau để có kết quả kiểm tra 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 một số lần giới hạn và lặp lại.	`5`
`--hub`	`HUB_VERSION`	Phiên bản trung tâm để điều khiển các thiết bị trên GHA.	`15.20221210.3.1`
`--dut`		Thiết bị đang được kiểm thử.
	`MODEL`	Mẫ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 tất Biểu mẫu phản hồi của chúng tôi.

Báo cáo sự cố

Báo cáo các vấn đề gặp phải bằng công cụ theo dõi lỗi.