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

Google Home 測試套件

Cloud-to-cloud    Home Home SDK

Google Home Test Suite 是一款網頁應用程式,可讓你自行測試智慧型住宅動作。Test Suite 會根據與您帳戶相關聯的裝置和特性,自動產生並執行測試案例。完成測驗後,您可以查看測試結果或提交表單,並將測試結果提交給 Google。

Test Suite 執行的測試包括但不限於以下項目:

請點選下方按鈕啟動 Test Suite 工具:

啟用「Test Suite

自我測試動作

以下章節將說明如何在裝置和智慧型住宅動作專案中執行 Test SuiteTest Suite 會要求您登入,以便其檢查 Google Home Graph 中的裝置,並直接將指令傳送至 Google Assistant

如要自行測試動作,請按照下列步驟操作:

  1. 在網路瀏覽器中開啟 Test Suite
  2. 使用右上角的 Google 登入按鈕。

  3. 設定「專案詳細資料」

    1. 在「Project ID」(專案 ID) 欄位中,輸入智慧住宅動作的專案 ID。
    2. 按一下「Next」
  4. 調整「Test Settings」

    1. 如要認證智慧型住宅動作,請保留預設的「Report State/Request Sync Timeout」值。然而,為了進行測試,當代理程式需要更多時間向狀態圖回報狀態時,您可以變更逾時值。
    2. 如要驗證智慧型住宅動作,請確認已啟用「Test Request Sync」選項;在測試期間,系統會提示您新增、更新或移除裝置,並檢查裝置清單是否在 Home Graph 中變更。系統會透過您測試的整合作業執行變更動作。要測試的整合作業必須至少連接一部代理程式裝置。

    3. 如果您使用的是「Scene」特徵,請選取「Test Scene trait」

    4. 如果您要執行本機主畫面裝置測試套件,請選取「Supports Local Home SDK」

      1. 選取「本機履行」或「流暢設定」
      2. 如果裝置可以在本機處理 QUERY 意圖,請按一下「Supports Local Query」(支援本機查詢)
  5. 執行測試執行作業並查看結果:

    1. 如要開始測試,請按「Next」(下一步)。介面會顯示正在測試的裝置和特性。
  6. 查看「Results & Submission」頁面:

    1. 測試完成後,按一下「Next」即可查看結果。

測試結果包含通過和未通過的測試數量,以及表示通過測試的最終分數。

帳戶連結驗證測試

帳戶連結在 Google 智慧居家生態系統中扮演著重要的角色。Test Suite 中的帳戶連結驗證測試會檢查您的 OAuth 服務是否有潛在問題。

帳戶連結驗證測試包含測試存取權杖重新整理權杖的測試:

存取權杖驗證測試

系統會測試從權杖交換端點傳回的存取權杖,確保其格式有效且傳回有效的更新權杖。

測試項目數量 說明
檢查存取權杖是否為 JWT 格式 Google 帳戶連結不建議使用 JWT 格式存取權杖。如果找到 JWT 格式,系統就會顯示以下警告: The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
檢查過期的存取權杖有更新權杖。 存取權杖過期時,必須提供更新權杖。如果找不到更新權杖,這項測試就會失敗。

重新整理權杖驗證測試

系統會測試更新權杖,確保權杖交換端點正確交換這些新的存取權杖。

測試項目數量 說明
請重新整理權杖並更新權杖,檢查合作夥伴回應。 您的伺服器應傳回含有 {"error": "invalid_grant"} 的「HTTP 400 Bad Request」錯誤,並傳回無效的更新權杖要求。如果回應與「錯誤代碼或訊息」不符,測試案例就會失敗。詳情請參閱「 交換更新權杖的存取權杖」。
測試權杖更新後,是否已更新存取權杖。 系統應傳回新的存取權杖,以回應更新權杖要求。如果您的伺服器提供相同的存取權杖,測試案例就會失敗。
檢查未過期的存取權杖是否仍然有效。 系統會顯示存取權杖到期時間。
重新整理時,確認更新權杖是否已輪替。 我們會檢查更新權杖在更新權杖要求後是否有所變更。如果重新整理權杖有所變更,伺服器應該只在使用新的重新整理權杖後失效,以免出現會破壞使用者帳戶連結的競爭狀況。如果您在使用新的重新整理權杖前失效,測試將會失敗。

錯誤訊息

下表列出您可能遇到的一些常見錯誤訊息,以及建議的解決方法。

錯誤訊息 解決方式
專案 <_id_> 先前未曾使用或已停用 HomeGraph API 確認已啟用 HomeGraph API
找不到要求的實體 請確認 agentUserId 有效,且已連結至服務。

請確認您具備專案 ${your project id}resourcemanager.projects.get 權限,並已授予同意畫面上的所有權限。

取得模組資料時發生錯誤:getModuleData 錯誤:https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 的 Http 失敗回應

  1. 按照排解 IAM 權限問題操作說明,確認您的帳戶具備專案的 resourcemanager.projects.get 權限。
  2. 前往「具有您帳戶存取權的應用程式」頁面,檢查「智慧型住宅測試套件」的下列權限:
    • 基本帳戶資訊
      1. 查看您的主要 Google 帳戶電子郵件地址
      2. 查看您的個人資訊,包括您已公開的任何個人資訊
    • 其他存取權
      1. 使用你的 Assistant:在你的 Google 帳戶中存取各種資料
      2. 檢查及控制 Home Graph 中的智慧住宅裝置
    如果顯示權限錯誤,請先移除存取權,並在再次登入帳戶時,在同意畫面中授予所有權限。

提交測試結果

您的 Test Suite 結果必須通過所有測試,才能提交認證表單。如有任何特性需要手動測試,您仍應執行 Test Suite 工具並附加結果,即使 100% 沒有通過也一樣。

如要提交測試結果及驗證智慧型住宅動作,請按照下列步驟操作:

  1. 收到測試結果且準備好驗證智慧型住宅動作後,請在 Test Suite 工具中按一下「提交」
  2. 按一下「下載測試結果」按鈕,即可擷取測試結果。
  3. 按一下「前往提交表單」,將測試結果提交給 Google。
  4. 填妥所有必填欄位,然後按一下「Submit」