動作控制台中的模擬工具可讓您透過易於使用的網路介面,模擬硬體裝置和其設定,藉此測試您的動作。您也可以存取偵錯資訊,例如出貨和接收的要求和回應。
測試專案
測試動作專案時,必須遵守下列限制:
- 測試動作最長可持續 30 天。30 天後,您必須建立新的測試版本。
- 您可以使用任何支援的硬體裝置 (Android 6.0+、iOS 9.1+ 和支援語音功能的喇叭) 測試開發中的動作。裝置必須以您在 Actions 主控台中使用的同一個 Google 帳戶登入。說出「Ok Google,與我的測試應用程式通訊」,即可叫用目前的動作草稿版本。
- 根據預設,模擬工具會使用您草稿中的動作版本。瞭解如何選取其他要測試的版本。
輸入法
您可以按一下回應文字欄位中的按鈕,指定要用於測試的輸入方式。
以下清單說明輸入的類型和可用的裝置:
- 自動偵測:自動偵測語音、鍵盤或觸控輸入。
- 觸控 - 用於互動式體驗和元素,例如建議方塊。適用於智慧螢幕和手機裝置。
- 語音 - 使用語音輸入功能。適用於智慧螢幕、手機和喇叭裝置。
- 鍵盤 - 只能輸入文字。適用於手機。
系統會自動偵測預設輸入法。系統也會根據您選取的途徑,停用及啟用輸入類型。
每次向 RawInput
物件的執行要求時,都會包含 inputType
欄位的輸入方法。
{
"inputType": "VOICE",
"query": "Tell me a fact about Google's headquarters"
}
指定裝置
模擬工具會模擬不同的裝置,方便您測試動作的裝置專屬體驗。
如要變更模擬裝置,請按照下列步驟操作:
按一下左上角的裝置下拉式選單。系統預設會選取 [智慧螢幕]。
請從以下裝置中進行模擬:
- 智慧螢幕:支援 Google 助理的裝置 (例如具有螢幕和喇叭功能的 Nest Hub)。
- 手機 - 支援 Google 助理且具備螢幕和喇叭功能的手機。
- 揚聲器 - 支援 Google 助理的智慧型揚聲器,具有喇叭功能。
- KaiOS - 支援 Google 助理的手機 (使用 KaiOS)。
選取語言
您可以從第二個下拉式選單中選取語言,以設定您要模擬的語言和地區。如要進一步瞭解如何建立多語言動作,請參閱本地化說明文件。
設定位置
您可以手動設定裝置的座標和地址。這項功能可讓您測試在主控台中設置的任何指定地區功能,以及您在執行要求中設定的地區專屬回應。
如要取得要在動作中使用的模擬位置,請使用使用者資訊輔助程式要求使用者授予權限。
設定
按一下左上角的 [設定] 按鈕,存取模擬工具的其他選項。
請選取版本
您可以指定您要測試的動作專案版本 (已發布版本或草稿版本)。如要選取專案版本,請按照下列步驟操作:
在模擬工具中,按一下右上角的 [Settings] (設定) 按鈕。
按一下「選取版本」旁邊的下拉式選單,然後選擇要測試的版本。
在版本下拉式選單中,選取您要測試的動作專案版本,然後按一下 [完成]。除了「草稿」版本以外,您還會看到提交的所有版本;在提交前,該版本代表專案目前的狀態。
測試網址
為了避免在測試動作專案時變更實際工作環境,您可以提供獨立的網址來取代實際工作環境 Webhook。測試動作的每個版本都由動作專案進行設定。一個 Actions 專案可以有多個版本和一個專屬測試網址,方便您在模擬工具中測試不同版本的動作,同時不影響實際工作環境。
啟用「測試網址」設定後,模擬工具會覆寫動作專案的實際工作環境 Webhook 網址,並改用您提供的測試 Webhook 網址。
在模擬工具中設定測試網址之前:
決定您要用來測試 Actions 專案版本的網址。
設定您要用來進行測試的網址,以接受來自網址的要求。
如何在模擬工具中設定測試網址:
按一下模擬工具右上角的「Settings」(設定)。
啟用 [測試網址]。
在 [測試網址] 方塊中,輸入您想用來測試的網址。
您指定的測試網址會顯示在模擬工具中。
帳戶連結
帳戶連結可讓動作使用 Google 登入、以 OAuth 為基礎的 Google 登入「簡化」連結或 OAuth。
如果您尚未為 Action 設定帳戶連結,請按一下「Settings」(設定) 下方的 [Set up accountlink] (設定帳戶連結),前往主控台的「Accounting」(帳戶連結) 部分。
如要連結帳戶,請按照下列步驟進行:
在 Actions 主控台模擬工具的模擬工具輸入區域,輸入「talk to my test app」,測試您的動作。
傳送查詢,將動作的帳戶連結流程初始化。
使用提示登入帳戶。
確認帳戶連結成功。
連結帳戶會保留,直到帳戶取消連結為止,因此您可以在使用相同連結帳戶時更新動作。
如要取消連結帳戶,請在「帳戶連結」下依序按一下 [設定] > [取消連結]。
裝置端測試
這項設定可讓您在實體裝置上啟用或停用測試。 如要在裝置上進行測試,您必須登入用來建立 Actions on Google 專案的帳戶。
音訊播放
切換這個選項,即可在測試期間將音訊設為靜音或啟用音訊播放功能。
開發沙箱
啟用這個選項後,系統就不會透過您的付款方式收費。詳情請參閱交易說明文件。
模擬未驗證的使用者
這個選項會在使用者為其他人設定 Voice Match 的裝置上模擬使用者。