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.1.1.143.24.1.4
  2. 在「GHA」中登入 Google 帳戶。

安裝 Google Home UI 自動化工具

您可以透過兩種方式安裝 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
這張圖顯示提供意見回饋和檢舉的圖示
       發生任何問題。

執行迴歸測試

如要執行迴歸測試,請輸入下列程式碼。必須加上旗標 --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 用於控制 Google Home 應用程式中的裝置的 Hub 版本。 15.20221210.3.1
--dut 測試中的裝置。
MODEL 裝置型號。 X123123
TYPE 裝置類型。 LIGHT
PROTOCOL 裝置通訊協定。 MATTER
--fw DEVICE_FIRMWARE 裝置韌體。 2.2.0

這張圖顯示回歸測試摘要

意見回饋

如要提供寶貴意見或意見回饋,協助我們改善使用體驗, Google Home UI Automator,請完成我們的 意見回饋表單

回報問題

使用 Issue Tracker