Google Home Test Suite 是網頁應用程式,可讓您自行測試智慧型住宅動作。Test Suite 會根據與帳戶相關聯的裝置和特徵,自動產生並執行測試案例。完成測試後,您可以查看測試結果或填寫提交表單,將測試結果提交給 Google。
Test Suite 執行的測試包括但不限於以下項目:
如要啟動 Test Suite 工具,請點選下方按鈕:
自行測試動作
以下章節說明如何在裝置和智慧型住宅動作專案上執行 Test Suite。您必須登入,Test Suite 才能檢查 Google Home Graph 中的裝置,並將指令直接傳送給 Google Assistant。
如要自行測試動作,請按照下列步驟操作:
- 在網路瀏覽器中開啟 Test Suite。
使用右上角的按鈕登入 Google。
設定「Project Details」:
- 在「Project ID」欄位中,輸入智慧型住宅動作的專案 ID。
- 點選「下一步」。
進行「測試設定」:
- 如果您認證智慧型住宅動作,請不要變更預設的「Report State/Request Sync Timeout」值。不過,如果代理程式需要較長的時間向 Home Graph 回報狀態,您就可以變更逾時值以進行測試。
如果您認證智慧型住宅動作,請確認已啟用「Test Request Sync」選項。在測試期間,系統會提示您新增、更新或移除裝置,並檢查 Home Graph 中的裝置清單是否已變更。系統會透過正在測試的整合執行變更動作。測試中的整合必須至少有一個裝置連接至代理程式使用者。
如果使用 Scene 特徵,請選取「Test Scene trait」。
如果您執行的是本機住宅裝置的測試套件,請選取「Supports Local Home SDK」。
- 選取「本機執行要求」或「流暢設定」。
- 如果裝置可以在本機處理 QUERY 意圖,請按一下「支援本機查詢」。
執行測試執行作業並查看結果:
- 點選「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. |
請檢查設有期限的存取權杖是否有更新權杖。 | 當存取權杖過期時,必須提供更新權杖。找不到更新權杖,這項測試就會失敗。 |
重新整理權杖驗證測試
系統會測試更新權杖,確保權杖交換端點正確交換新的存取權杖。
測試項目 | 說明 |
---|---|
請使用無效的更新權杖重新整理權杖,並檢查合作夥伴回應。 | 您的伺服器應向無效的更新權杖要求,傳回 HTTP 400 Bad Request 錯誤和 {"error": "invalid_grant"} 。如果回應與「錯誤代碼或訊息」不符,這個測試案例就會失敗。詳情請參閱「
交換更新權杖以取得存取權杖」一文。 |
測試憑證更新後是否已更新存取權杖。 | 應傳回新的存取權杖,以回應更新權杖要求。如果您的伺服器提供相同的存取權杖,測試案例就會失敗。 |
請確認未過期的存取權杖是否仍有效。 | 畫面上隨即會顯示存取權杖到期時間。 |
檢查重新整理權杖是否已在重新整理時輪替。 | 我們會檢查更新權杖要求後,是否會變更更新權杖。如果更新權杖有所變更,伺服器應僅在使用新更新權杖後,才撤銷舊的更新權杖,以免競爭狀況可能破壞使用者的帳戶連結。如果您在使用新權杖前撤銷舊的更新權杖,測試就會失敗。 |
錯誤訊息
下表列出一些您可能會遇到的常見錯誤訊息和解決方式。
錯誤訊息 | 解決方法 |
---|---|
專案 <_id_> 先前未曾使用或已停用 HomeGraph API | 確認已啟用 HomeGraph API。 |
找不到要求的實體 | 請確認 agentUserId 有效且已連結至服務。 |
請確認您擁有專案「 取得模組資料時發生錯誤:getModuleData 錯誤:https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
提交測試結果
Test Suite 結果必須通過 100% 的測試,才能提交認證表單。如有任何特徵需要手動測試,您仍應執行 Test Suite 工具並附加結果,即使結果尚未通過測試也一樣。
如要提交測試結果,並確認智慧型住宅動作,請按照下列步驟操作:
- 收到測試結果並準備好進行智慧型住宅動作認證後,請按一下 Test Suite 工具中的「提交」。
- 按一下「下載測試結果」按鈕,即可擷取測試結果。
- 按一下「前往提交表單」,將測試結果提交給 Google。
填寫所有必填欄位,然後按一下「提交」。