智慧型住宅測試套件

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

測試套件執行的測試包括但不限於下列項目:

  • 檢查裝置狀態要求同步,確認您的裝置和特性已經實作。

  • 驗證裝置是否已執行 QUERY 意圖,且其結果與回報狀態結果相符。

如要啟動測試套件工具,請點選下列按鈕:

啟動測試套件

自行測試動作

以下章節說明如何在裝置和智慧型住宅動作專案中執行測試套件。測試套件會要求您登入帳戶,以便檢查您 Home Graph 中的裝置,並直接將指令傳送至 Google 助理。

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

  1. 在網路瀏覽器中開啟智慧型住宅測試套件
  2. 使用右上角的按鈕登入 Google。

  3. 設定「Project Details」(專案詳細資料)

    1. 在「Project ID」(專案 ID) 欄位中,為智慧住宅動作輸入專案 ID。
    2. 點選「下一步」。
  4. 調整「Test Settings」(測試設定)

    1. 如要認證智慧住宅動作,請不要變更預設的「Report State/Request Sync Timeout」值。不過,當您進行測試時,如果代理程式花費較多時間將狀態回報至住家圖表,則可以變更逾時值。
    2. 如果要驗證您的智慧住宅動作,請務必啟用「Test Request Sync」選項;測試期間,系統會提示您新增、更新或移除裝置,並檢查 Home Graph 中的裝置清單是否有所變更。變更動作是透過所測試的整合作業執行。在測試狀態下的整合作業中,至少必須連接一個代理程式代理程式。

    3. 如果您使用的是場景特性,請選取 [測試場景特性]

  5. 執行測試執行作業並查看結果:

    1. 點選 [下一步] 即可開始測試。介面會顯示正在測試的裝置和特性
  6. 查看「Results & Submission」頁面:

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

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

帳戶連結驗證測試

帳戶連結在 Google 智慧型住宅生態系統中扮演重要角色。測試套件中的帳戶連結驗證測試會檢查您的 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 不正確的要求錯誤,以傳回無效的更新憑證要求。如果回應與「錯誤代碼或訊息」不符,這個測試案例就會失敗。詳情請參閱存取憑證的存取憑證重新整理頁面
測試更新憑證後,存取憑證是否已更新。 應傳回新的存取憑證以回應更新憑證要求。如果您的伺服器提供相同的存取憑證,測試案例就會失敗。
請檢查未過期的存取憑證是否仍然有效。 系統會顯示存取憑證到期時間。
檢查更新憑證是否已在重新整理時進行輪替。 我們會檢查更新憑證要求是否在更新憑證要求後變更。如果重新整理憑證有異動,您的伺服器只有在使用新的重新整理憑證後,才將無效的舊憑證失效,以避免競爭狀況造成使用者的帳戶連結中斷。如果您在使用新憑證之前,就先撤銷舊的更新憑證,測試將會失敗。

錯誤訊息

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

錯誤訊息 如何解決
「{0/}」專案未使用或停用 HomeGraph API; 確認您已啟用 HomeGraph API
找不到您要求的項目 請確認你的 agentUserId 有效且已連結至服務。

提交測試結果

您必須提交 100% 的測試套件結果,才能提交認證表單。如果您有任何需要手動測試的特性,即使尚未達到 100%,也應該執行測試套件工具並附加結果。

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

  1. 收到測試結果後,即可接受智慧型住宅動作認證,請在測試套件工具中按一下 [提交]
  2. 點擊 [下載測試結果] 按鈕即可擷取測試結果。
  3. 按一下 [前往提交表單],將測試結果提交給 Google。
  4. 填妥所有必填欄位,然後按一下 [Submit] (提交)