Google Home UI Automator

案件    デバイス SDK

Google Home UI AutomatorGoogle 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 委託した 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 GHA でデバイスを操作するためのハブのバージョン。 15.20221210.3.1
--dut テスト対象デバイス。
MODEL デバイスのモデル。 X123123
TYPE デバイスのタイプ。 LIGHT
PROTOCOL デバイス プロトコル。 MATTER
--fw DEVICE_FIRMWARE デバイスのファームウェア。 2.2.0

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

フィードバック

Google Home UI Automator の使い勝手を改善するためのご意見やフィードバックをお送りいただくには、フィードバック フォームにご記入ください。

問題を報告する

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