Google Home UI 자동화기

법적 사안    기기 SDK

Google Home UI Automator를 사용하면 Google Home app (GHA)을(를) 자동화할 수 있습니다. Matter 커미셔닝, 사용 중단, 회귀 실행 테스트하세요.

이 그림은 Matter 기기를 Google Home에 페어링하는 방법을 보여줍니다.

기본 요건

Google Home UI Automator를 사용하려면 다음을 준비하세요.

Python 3

Python 3 환경을 사용하여 스크립트를 실행하는 것이 좋습니다. Google Home UI Automator을 사용하려면 Python 3.11 이상이 필요합니다.

Android 휴대전화

  1. Android에서 사용자 디버깅 모드를 사용 설정합니다. 있습니다. 디버깅 설정을 사용 설정하려면 개발자 옵션 사용 설정을 참고하세요.
  2. Android 휴대전화를 컴퓨터에 연결합니다.

Google Home 앱

  1. Android 휴대전화에 GHA 앱을 설치하세요. GHA 버전이 3.10.1.6 이상인지 확인합니다.
  2. GHA에서 Google 계정에 로그인합니다.

Google Home UI Automator 설치

Google Home UI Automator, PyPI 또는 소스에서 설치하는 방법에는 두 가지가 있습니다. 생성합니다. PyPI를 사용하여 설치하는 것이 좋습니다.

pip install google-home-ui-automator

소스 코드에서 빌드

소스 코드에서 빌드하려면 터미널에서 다음 단계를 따르세요.

  1. 이 저장소를 클론합니다.

    git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
    
  2. 클론된 저장소로 이동합니다.

    cd ui-automator
    
  3. 다음 명령어를 실행합니다.

    pip install .
    

Matter 기기 커미셔닝

Matter 기기를 커미셔닝하려면 다음 명령어를 입력합니다.

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
입력 값 설명
DEVICE_NAME 기기 Matter대가 선택되었습니다. m5stack
PAIRING_CODE Matter 기기의 페어링 코드입니다. 34970112332
ROOM_NAME 할당된 회의실 Office

이 그림은 Matter 기기를 Google Home에 페어링하는 방법을 보여줍니다.

Matter 기기 사용 중지하기

Matter 기기를 사용 중지하려면 다음 명령어를 입력합니다.

ui-automator --decommission DEVICE_NAME
입력 값 설명
DEVICE_NAME GHA에 커미셔닝된 Matter 기기의 이름이 표시됩니다. m5stack
이 그림은 Google Home 플레이그라운드에서 의견을 제공하고 문제를 신고하기 위한 아이콘을 보여줍니다.

회귀 테스트 실행

회귀 테스트를 실행하려면 다음 코드를 입력합니다. 플래그를 포함해야 합니다. 회귀 테스트를 실행하기 위한 --regtest--commission

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE]

회귀 테스트는 커미셔닝 및 사용 중단 주기만 지원합니다. 기본적으로 회귀 테스트는 사용자가 키보드를 사용하여 중지할 때까지 실행됩니다. 있습니다.

다음을 추가하여 더 심층적인 테스트 결과를 확인할 수 있습니다.

입력 값 설명
--repeat REPEAT_TIMES 제한된 시간과 반복 시간으로 회귀 테스트를 실행합니다. 5
--hub HUB_VERSION GHA에서 기기를 제어하기 위한 허브 버전입니다. 15.20221210.3.1
--dut 테스트 대상 기기입니다.
MODEL 기기 모델 X123123
TYPE 기기 유형 LIGHT
PROTOCOL 기기 프로토콜 MATTER
--fw DEVICE_FIRMWARE 기기 펌웨어로 이동합니다. 2.2.0

이 그림은 회귀 테스트 요약을 보여줍니다.

의견

사용 환경을 개선하기 위한 생각이나 의견을 제출하려면 Google Home UI Automator님, 의견 양식.

문제 신고

다음을 사용하여 문제 신고: Issue Tracker를 참조하세요.