請注意!我們即將推出新的開發人員預覽版計畫。歡迎在此申請,率先體驗新工具並提供意見回饋。

測試 Matter 整合

Google Home Developer Console 提供測試頁面,方便您使用 Google Home Test Suite 設定並執行 Matter 整合的測試。Test SuiteDeveloper Console 內的獨立應用程式,可處理所有整合測試。

整合供應商 ID 和產品 ID 的裝置必須在 Google Home app (GHA) 中進行評估並提供,以供用於 Developer Console 的帳戶測試。詳情請參閱「配對 Matter 裝置」。

Test Suite 可在屬於特定 Matter 專案設定的一組裝置上執行。請務必在整合作業中執行 Test Suite,確保一切運作正常。

在「Test」(測試) 頁面中,「Ready to test」(可以測試) 會列出 Matter 已完成且可供測試的整合。

經過測試的 Matter 整合項目會列在「Tested」(測試) 部分。

測試計畫類型

測試計畫分為兩種類型:

  • 開發測試計畫會使用 Matter 測試控制裝置。這類憑證可以編輯,但無法提交 Matter 憑證。

  • 認證測試計畫僅適用於 Matter 認證,且無法編輯。選取這個選項後,系統會建立新的 Matter 整合版本。

整合版本

您針對測試建立測試計畫時,系統會建立整合的新版本。此版本編號會列在「測試」分頁中 Developer Console 的所有整合清單中。

系統一律不會透過其他編號版本建立新版本。舉例來說,您為整合建立的第一個測試計畫會建立整合版本 v.1。建立另一個測試計畫後,系統會為這項整合建立版本 v.2,但不會依據 v.1 版本提供該版本。反之,這個版本是以整合未建立版本的執行個體為基礎,與 v.1 相同。

整合作業的「N/A」版本代表在「Develop」(開發) 分頁中管理的未整合整合執行個體。

換句話說,請在 Developer Console 的「Matter >「Test」(測試)

  • 如果在整合作業的版本 N/A 中點選「測試」,系統會建立新的版本。版本號碼會高於任何現有編號版本。
    • 如果沒有編號的版本,系統會建立 v.1 版本。
    • 如果已有 v.1 版,系統會建立 v.2 版。如果已有 v.2 版,系統會建立版本 v.3,以此類推。
  • 如果按一下整合版本編號 (例如「v.1」) 的「Test」(測試) ,系統「不會」建立新的版本。系統會再次測試 v.1 版本。

詳情請參閱「整合版本管理」。

建立測試計畫

整合版本是未整合整合功能的數據匯報。這表示當您建立測試用的測試計畫,以及整合版本時,與該整合作業相關的所有中繼資料都必須是您要用於整合整合的資訊

建立測試用的測試計畫之前,請確認您已完成下列事項:

  1. 已建立公司資料
  2. 輸入整合作業的供應商供應商 ID (VID)
  3. 已完成設定和品牌宣傳

如果您未完成這些整合作業的所有整合作業,您為認證測試建立的整合版本將無法獲得認證您必須建立一個新的版本,這代表您必須重做「測試」、「現場試用」和「認證」步驟。

此外,您也必須建立新版本,並重新開始如要在整合版本認證前更新品牌宣傳內容

建立測試計畫的方法如下:

前往 Play 管理中心

  1. 在專案清單中,找到要使用的專案,然後按一下旁邊的「Open」

  2. 在頁面左側的導覽選單中,依序前往 Matter >「Test」(測試)

  3. 針對要測試的整合版本 N/A,按一下 [測試]。這個動作會建立新的整合版本

  4. 選取「開發測試」或「認證測試」測試類型。 建立新的測試計畫

    • 如要在 Google 生態系統中取得認證,請選取「認證測試」
    • 開發測試無法用於認證。
  5. 按一下 [測試]。如果出現「找不到裝置」錯誤畫面,此整合作業尚未編譯到生態系統。詳情請參閱排解配對問題一文。

  6. 在「Configure your test」畫面中,輸入測試名稱,然後從裝置清單中選取要測試的裝置。

  7. 點選「下一步:測試方案」按鈕。

  8. 在「建立測試計畫」頁面的「測試套件」部分中,選取要執行的測試套件。

建立測試計畫

如要退出 Test Suite,請按一下「返回開發人員中心」

執行測試計畫

Test Suite 的「Create a test plan」(建立測試計畫) 頁面中,按一下「Run Test」(執行測試)。系統隨即顯示「測試環境」頁面,其中包含所有測試的狀態和記錄檔。

測試結果完成後,就會顯示測試結果。每個測試套件執行作業的狀態旁邊會顯示「通過」、「失敗」。

「Logs」(記錄檔) 窗格會顯示個別測試執行作業的狀態。

測試結果

如要在「測試環境」頁面中重新測試測試計畫,請在測試執行完畢後按一下頂端的「測試。

完成後:

查看及解讀測試結果

Test Suite 的「Test history」(測試記錄) 頁面中,您可以在「Test plan」(測試計畫) 部分中,按一下所需測試計畫的「Retest」(測試),即可查看開發計畫或未提交認證測試計畫的先前的測試結果。系統會將您帶往「Test Environment」頁面,當中會顯示測試結果。

測試記錄

如為已提交的認證計畫,請在「已儲存認證項目」部分中按一下「結果」,即可查看測試結果報表。

也可以從 Developer Console 的「Test」(測試) 分頁標籤中取得整合版本的測試結果。針對該網頁中列出的任何整合版本,按一下「檢視記錄」,即可前往 Test Suite 中的「測試記錄」頁面。

控制台狀態

測試階段提供下列主控台狀態:

章節 狀態 Description 規定 後續步驟
已可進行測試 已就緒 這個版本的整合版本已經準備就緒,可供測試。 N/A 測試這個版本的整合作業。
認證已準備就緒 已就緒 這個版本的整合項目已通過測試,可提交現場測試或認證。

已測試並儲存版本。

所有失敗的測試案例都包括 Google 審查的理由。

視需要重新測試

疑難排解

測試裝置未顯示在測試套件中

如果您已使用測試供應商 ID (VID) 和產品 ID (PID) 配對裝置,但嘗試在 Developer Console使用測試套件測試裝置時找不到該裝置,這可能就是在多項整合中使用相同的測試 VID 和 PID 組合。

如要排解問題,請從 Developer Console 中移除所有測試裝置,然後配對您要測試的裝置。

如要驗證配對的裝置是否正確,您可以在測試韌體中將裝置的製造商和型號資訊 (CHIP_DEVICE_CONFIG_DEVICE_* 值) 設為不重複的值。

詳情請參閱「裝置資訊」。

驗證裝置的 VID/PID

如要開始開發與 Google 的整合作業,必須在 Google Home 控制台中建立專案和整合項目。

排解藍牙 Sniffer 問題

裝置信標的 VID/PID 值應與您在 Developer Console 專案中輸入的 VID/PID 相符。

  • VID 0xFFF10xFFF4 僅供測試使用。基本用途可能用於基本佣金和對照測試,但無法在下列開發階段使用:

使用藍牙工程應用程式 (例如 nRF Connect for Mobile),您可以在「Service Data」欄位中看到信標裝置的 VID/PID。

在 nRF Connect 版的 Android 螢幕截圖中,您會看到「Service Data」(服務資料) 欄位的第四個位元組,因此 VID/PID 會列為 5A23FFFE。這表示 5A23 的 VID 和 FFFE 的 PID,兩者均使用結尾的結尾格式

BLE 應用程式會顯示些微結束的值,但您在 Developer Console 專案中輸入的 VID/PID 值有很大的結尾。

確認藍牙 Sniffer 所顯示的內容,已輸入相應的值和格式。

針對範例螢幕截圖中的值,Developer Console 中的 VID 和 PID 分別為 235AFEFF