歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。

Google Home 測試套件

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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. 按一下「繼續」
  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. 選取 [Local Fulfillment] 或 [Smamless Setup]
      2. 如果裝置可以在本機處理 QUERY 意圖,請按一下 Supports Local Query
  5. 執行測試執行並查看結果:

    1. 點選 [下一步] 即可開始執行測試。介面會列出目前正在測試的裝置和特性。
  6. 查看「Results & amp; Submission」(結果與提交) 頁面:

    1. 測試完成後,按一下 [下一步] 即可查看結果。

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

帳戶連結驗證測試

帳戶連結在 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 錯誤要求錯誤傳回無效的重新整理權杖要求。如果回應與「錯誤代碼或訊息」不符,這個測試案例就會失敗。詳情請參閱交換更新憑證以更新存取憑證
測試更新憑證後是否有存取憑證。 應傳回新的存取權杖以回應更新憑證要求。如果您的伺服器提供相同的存取權杖,測試案例就會失敗。
檢查未過期的存取權杖是否仍有效。 系統會顯示存取憑證的到期時間。
檢查重新整理權杖是否已在重新整理期間旋轉。 我們會檢查更新憑證要求後是否有更新憑證。如果重新整理權杖已變更,您的伺服器只能在使用新的重新整理權杖後才讓舊重新整理權杖失效,以避免競爭狀況中斷使用者的帳戶連結。如果在使用新的重新整理權杖之前失效,測試將會失敗。

錯誤訊息

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

錯誤訊息 解決方式
專案 <_id_> 先前未曾使用或已停用 HomeGraph API 確認已啟用 HomeGraph API
找不到要求的實體 請檢查您的 agentUserId 是否有效,並連結至您的服務。
請確認您有 ${your project id} 專案的 resourcemanager.projects.get 權限,並在同意畫面中授予所有權限。
  1. 按照排解身分與存取權管理權限問題中的操作說明,確認您的帳戶具備專案的 resourcemanager.projects.get 權限。
  2. 前往具有您帳戶存取權的應用程式頁面,查看下列「智慧型住宅測試套件」的權限:
    • 基本帳戶資訊
      1. 查看您的主要 Google 帳戶電子郵件地址
      2. 查看您的個人資訊,包括您已公開的任何個人資訊
    • 其他存取權
      1. 使用 Assistant:從你的 Google 帳戶中存取各種資料
      2. 檢查及控制 Home Graph 中的智慧住宅裝置
    如果缺少任何使用者,請先移除存取權,並在重新登入時,於同意畫面中授予所有權限。

提交檢測結果

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

如要提交檢測結果並證明智慧型住宅動作,請按照下列指示操作:

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