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

Matter    SDK thiết bị

Google Home UI Automator có thể giúp bạn tự động hoá Google Home app (GHA) để uỷ quyền, ngừng uỷ quyền Matter hoặc chạy kiểm thử hồi quy trên phí hoa hồng.

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 nội dung 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

  1. Bật chế độ Gỡ lỗi người dùng trên điện thoại Android. Hãy 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.
  2. Kết nối điện thoại Android với máy tính.

Ứng dụng Google Home

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

Cài đặt Trình tự động hoá giao diện người dùng Google Home

Có hai 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.

pip install google-home-ui-automator

Tạo bản 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:

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

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

  2. Chuyển đến kho lưu trữ được nhân bản:

    cd ui-automator

  3. Chạy lệnh sau:

    pip install .

Uỷ quyền thiết bị Matter

Để uỷ quyền cho thiết bị Matter, hãy nhập lệnh sau:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
Giá trị nhập Mô tả Ví dụ:
DEVICE_NAME Đã chọn thiết bị Matter. m5stack
PAIRING_CODE Mã ghép nối của thiết bị Matter. 34970112332
ROOM_NAME Đã chỉ định phòng. Office

Hình này cho thấy 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 một thiết bị Matter, hãy nhập lệnh sau:

ui-automator --decommission DEVICE_NAME
Giá trị nhập Mô tả Ví dụ:
DEVICE_NAME Hiển thị tên của thiết bị Matter được uỷ quyền trên GHA. m5stack
Hình này cho thấy các biểu tượng để đưa ra ý 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]

Kiểm thử hồi quy chỉ hỗ trợ chu kỳ vận hành và ngừng hoạt động. 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 các thông tin sau để có kết quả kiểm thử chuyên sâu 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 Hub để đ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.