模擬工具

動作控制台中的模擬工具可讓您透過易於使用的網路介面，模擬硬體裝置和其設定，藉此測試您的動作。您也可以存取偵錯資訊，例如出貨和接收的要求和回應。

注意： 如果內嵌編輯器中有尚未儲存的變更程式碼，並瀏覽至模擬工具，系統會提示您將變更部署到程式碼，或是使用先前儲存並部署的程式碼。

測試專案

測試動作專案時，必須遵守下列限制：

• 測試動作最長可持續 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"
  }

注意：雖然模擬工具可讓您為實際上沒有鍵盤輸入方法 (智慧螢幕、喇叭) 的裝置輸入回應，但 inputType 欄位仍可正確顯示 VOICE 的值。

指定裝置

模擬工具會模擬不同的裝置，方便您測試動作的裝置專屬體驗。

如要變更模擬裝置，請按照下列步驟操作：

1. 按一下左上角的裝置下拉式選單。系統預設會選取 [智慧螢幕]。

   

2. 請從以下裝置中進行模擬：

   • 智慧螢幕：支援 Google 助理的裝置 (例如具有螢幕和喇叭功能的 Nest Hub)。
   • 手機 - 支援 Google 助理且具備螢幕和喇叭功能的手機。
   • 揚聲器 - 支援 Google 助理的智慧型揚聲器，具有喇叭功能。
   • KaiOS - 支援 Google 助理的手機 (使用 KaiOS)。

選取語言

您可以從第二個下拉式選單中選取語言，以設定您要模擬的語言和地區。如要進一步瞭解如何建立多語言動作，請參閱本地化說明文件。

注意：變更語言設定時，叫用動作的叫用詞組會變更為對應的語言。

設定位置

您可以手動設定裝置的座標和地址。這項功能可讓您測試在主控台中設置的任何指定地區功能，以及您在執行要求中設定的地區專屬回應。

如要取得要在動作中使用的模擬位置，請使用使用者資訊輔助程式要求使用者授予權限。

注意：請參閱本地化說明文件，進一步瞭解如何建立多地區動作。

設定

按一下左上角的 [設定] 按鈕，存取模擬工具的其他選項。

請選取版本

您可以指定您要測試的動作專案版本 (已發布版本或草稿版本)。如要選取專案版本，請按照下列步驟操作：

1. 在模擬工具中，按一下右上角的 [Settings] (設定) 按鈕。

2. 按一下「選取版本」旁邊的下拉式選單，然後選擇要測試的版本。

在版本下拉式選單中，選取您要測試的動作專案版本，然後按一下 [完成]。除了「草稿」版本以外，您還會看到提交的所有版本；在提交前，該版本代表專案目前的狀態。

測試網址

為了避免在測試動作專案時變更實際工作環境，您可以提供獨立的網址來取代實際工作環境 Webhook。測試動作的每個版本都由動作專案進行設定。一個 Actions 專案可以有多個版本和一個專屬測試網址，方便您在模擬工具中測試不同版本的動作，同時不影響實際工作環境。

啟用「測試網址」設定後，模擬工具會覆寫動作專案的實際工作環境 Webhook 網址，並改用您提供的測試 Webhook 網址。

注意：測試網址設定只會決定模擬工具測試時呼叫的 Webhook。這項設定不適用於在模擬工具外測試動作的使用者。

在模擬工具中設定測試網址之前：

• 決定您要用來測試 Actions 專案版本的網址。

• 設定您要用來進行測試的網址，以接受來自網址的要求。

如何在模擬工具中設定測試網址：

1. 按一下模擬工具右上角的「Settings」(設定)。

2. 啟用 [測試網址]。

3. 在 [測試網址] 方塊中，輸入您想用來測試的網址。

您指定的測試網址會顯示在模擬工具中。

帳戶連結

帳戶連結可讓動作使用 Google 登入、以 OAuth 為基礎的 Google 登入「簡化」連結或 OAuth。

如果您尚未為 Action 設定帳戶連結，請按一下「Settings」(設定) 下方的 [Set up accountlink] (設定帳戶連結)，前往主控台的「Accounting」(帳戶連結) 部分。

如要連結帳戶，請按照下列步驟進行：

1. 在 Actions 主控台模擬工具的模擬工具輸入區域，輸入「talk to my test app」，測試您的動作。

   注意： 如果您已指定叫用名稱並儲存並儲存叫用資訊，請改為說出「與 <叫用名稱> 交談」來展開對話。

2. 傳送查詢，將動作的帳戶連結流程初始化。

3. 使用提示登入帳戶。

   注意： 如果測試使用者擁有多個帳戶，模擬工具會顯示 Google 登入模式對話方塊。如果測試使用者只有一個帳戶，系統會自動使用該帳戶。請確定瀏覽器並未封鎖彈出式視窗。

4. 確認帳戶連結成功。

連結帳戶會保留，直到帳戶取消連結為止，因此您可以在使用相同連結帳戶時更新動作。

如要取消連結帳戶，請在「帳戶連結」下依序按一下 [設定] > [取消連結]。

裝置端測試

這項設定可讓您在實體裝置上啟用或停用測試。 如要在裝置上進行測試，您必須登入用來建立 Actions on Google 專案的帳戶。

音訊播放

切換這個選項，即可在測試期間將音訊設為靜音或啟用音訊播放功能。

開發沙箱

啟用這個選項後，系統就不會透過您的付款方式收費。詳情請參閱交易說明文件。

模擬未驗證的使用者

這個選項會在使用者為其他人設定 Voice Match 的裝置上模擬使用者。