Автоматизатор пользовательского интерфейса Google Home

SDK устройства Matter

Google Home UI Automator может помочь вам автоматизировать ваше Google Home app (GHA) для ввода в эксплуатацию, вывода из эксплуатации Matter или проведения регрессионного теста вашей комиссии.

На этом рисунке показано, как подключить устройство Matter к Google Home.

Предварительные условия

Чтобы использовать Google Home UI Automator , подготовьте следующее:

Питон 3

Для запуска скрипта рекомендуется использовать среду Python 3. Google Home UI Automator требуется Python 3.11 или новее.

телефон Андроид

  1. Включите режим пользовательской отладки на телефоне Android . См. раздел «Включение параметров разработчика», чтобы включить настройку отладки.
  2. Подключите телефон Android к компьютеру.

Приложение Google Home

  1. Установите GHA на свой телефон Android . Убедитесь, что версия GHA — 3.1.1.14 и 3.24.1.4 .
  2. Войдите в свою учетную запись Google в GHA .

Установите 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 , введите следующую команду:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
Входное значение Описание Пример
DEVICE_NAME Выбранное устройство Matter . m5stack
PAIRING_CODE Код сопряжения вашего устройства Matter . 34970112332
ROOM_NAME Назначенная комната. Office

На этом рисунке показано, как подключить устройство Matter к Google Home.

Вывод из эксплуатации устройства Материи

Чтобы вывести из эксплуатации устройство Материи, введите следующую команду:

ui-automator --decommission DEVICE_NAME
Входное значение Описание Пример
DEVICE_NAME Отображает имя введенного в эксплуатацию устройства Matter на GHA . m5stack
На этом рисунке показаны значки для предоставления отзывов и отчетов. проблемы в Google Home Playground.

Запустите регрессионный тест

Чтобы запустить регрессионный тест, введите следующий код. Вы должны включить флаги --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 Хаб-версия для управления устройствами на ГСГ. 15.20221210.3.1
--dut Тестируемое устройство.
MODEL Модель устройства. X123123
TYPE Тип устройства. LIGHT
PROTOCOL Протокол устройства. MATTER
--fw DEVICE_FIRMWARE Прошивка устройства. 2.2.0

На этом рисунке показана сводка регрессионного теста.

Обратная связь

Чтобы поделиться своими мыслями или отзывами о том, как улучшить работу с Google Home UI Automator , заполните нашу форму обратной связи .

Сообщить о проблемах

Report encountered issues using the issue tracker .