Google Home UI Automator

Matter    Device 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 をインストールする方法とソースからインストールする方法の 2 つ 説明します。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 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 GHA でデバイスを操作するためのハブのバージョン。 15.20221210.3.1
--dut テスト対象デバイス。
MODEL デバイスのモデル。 X123123
TYPE デバイスのタイプ。 LIGHT
PROTOCOL デバイス プロトコル。 MATTER
--fw DEVICE_FIRMWARE デバイスのファームウェア。 2.2.0

この図は、回帰テストの概要を示しています。

フィードバック

Google Home UI Automator 様、 フィードバック フォーム。

問題を報告する

発生した問題は Issue Tracker を使用して報告してください。