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

Vấn đề    SDK thiết bị

Google Home UI Automator có thể giúp bạn tự động hoá Google Home app (GHA) để hoa hồng, gỡ bỏ phí hoa hồng Matter hoặc chạy quy trình kiểm thử hồi quy đối với phí hoa hồng.

Hình này minh hoạ cách ghép nối một thiết bị theo chuẩn 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 thông tin sau:

Python

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 phiên bản 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. Xem Bật Tuỳ chọn cho nhà phát triển để bật cài đặt gỡ lỗi.
  2. Kết nối điện thoại Android với máy tính của bạn.

Ứng dụng Google Home

  1. Cài đặt GHA trên điện thoại Android của bạn. Hãy đảm bảo phiên bản của GHA3.10.1.6 trở lên.
  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ó 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.

pip install google-home-ui-automator

Tạo từ mã nguồn

Để tạo từ một mã nguồn, hãy làm theo các bước sau trong cửa sổ dòng lệnh:

  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ữ đã sao chép:

    cd ui-automator
    
  3. Chạy lệnh sau:

    pip install .
    

Phí hoa hồng cho thiết bị theo chuẩn Matter

Để kích hoạt thiết bị Matter, hãy nhập lệnh sau:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
Giá trị nhập Nội dung 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. 34970112332
ROOM_NAME Đã chỉ định phòng. Office

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

Gỡ bỏ thiết bị theo chuẩn Matter

Để huỷ kích hoạt một thiết bị theo chuẩn Matter, hãy nhập lệnh sau:

ui-automator --decommission DEVICE_NAME
Giá trị nhập Nội dung mô tả Ví dụ:
DEVICE_NAME Hiện 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 sự cố 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--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]

Quy trình 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, phép 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 quá trình.

Bạn có thể thêm nội dung sau đây để có kết quả kiểm thử chuyên sâu hơn:

Giá trị Giá trị nhập Nội dung mô tả Ví dụ:
--repeat REPEAT_TIMES Chạy kiểm thử hồi quy trong khoảng thời gian giới hạn và lặp lại. 5
--hub HUB_VERSION Phiên bản trung tâm để kiểm soát các thiết bị trên GHA. 15.20221210.3.1
--dut Thiết bị đang được kiểm tra.
MODEL Kiểu thiết bị. X123123
TYPE Loại thiết bị. LIGHT
PROTOCOL Giao thức của 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 thể hiện thông tin tóm tắt về kiểm thử hồi quy

Ý kiến phản hồi

Để gửi ý kiến hoặc ý kiến 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ồi của chúng tôi.

Báo cáo vấn đề

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