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