Google Home Test Suite 是一款網頁應用程式,可讓你自行測試智慧型住宅動作。Test Suite 會根據與您帳戶相關聯的裝置和特性,自動產生並執行測試案例。完成測驗後,您可以查看測試結果或提交表單,並將測試結果提交給 Google。
Test Suite 執行的測試包括但不限於以下項目:
請點選下方按鈕啟動 Test Suite 工具:
自我測試動作
以下章節將說明如何在裝置和智慧型住宅動作專案中執行 Test Suite。Test Suite 會要求您登入,以便其檢查 Google Home Graph 中的裝置,並直接將指令傳送至 Google Assistant。
如要自行測試動作,請按照下列步驟操作:
- 在網路瀏覽器中開啟 Test Suite。
使用右上角的 Google 登入按鈕。
設定「專案詳細資料」:
- 在「Project ID」(專案 ID) 欄位中,輸入智慧住宅動作的專案 ID。
- 按一下「Next」。
調整「Test Settings」:
- 如要認證智慧型住宅動作,請保留預設的「Report State/Request Sync Timeout」值。然而,為了進行測試,當代理程式需要更多時間向狀態圖回報狀態時,您可以變更逾時值。
如要驗證智慧型住宅動作,請確認已啟用「Test Request Sync」選項;在測試期間,系統會提示您新增、更新或移除裝置,並檢查裝置清單是否在 Home Graph 中變更。系統會透過您測試的整合作業執行變更動作。要測試的整合作業必須至少連接一部代理程式裝置。
如果您要執行本機主畫面裝置測試套件,請選取「Supports Local Home SDK」。
- 選取「本機履行」或「流暢設定」。
- 如果裝置可以在本機處理 QUERY 意圖,請按一下「Supports Local Query」(支援本機查詢)。
執行測試執行作業並查看結果:
- 如要開始測試,請按「Next」(下一步)。介面會顯示正在測試的裝置和特性。
查看「Results & Submission」頁面:
- 測試完成後,按一下「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 有效,且已連結至服務。 |
請確認您具備專案 取得模組資料時發生錯誤:getModuleData 錯誤:https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 的 Http 失敗回應 |
|
提交測試結果
您的 Test Suite 結果必須通過所有測試,才能提交認證表單。如有任何特性需要手動測試,您仍應執行 Test Suite 工具並附加結果,即使 100% 沒有通過也一樣。
如要提交測試結果及驗證智慧型住宅動作,請按照下列步驟操作:
- 收到測試結果且準備好驗證智慧型住宅動作後,請在 Test Suite 工具中按一下「提交」。
- 按一下「下載測試結果」按鈕,即可擷取測試結果。
- 按一下「前往提交表單」,將測試結果提交給 Google。
填妥所有必填欄位,然後按一下「Submit」。