歡迎來到 Google Home 開發人員中心,你可以在這裡學習如何學習智慧型住宅動作。注意事項:您將在 Actions 主控台建構動作。

Google Home 遊樂場

裝置 SDK

Google Home Playground 是一個網頁應用程式,可讓您模擬可設定的裝置類型和特徵,以此模擬智慧型住宅專案。Google Home Playground 可讓您建立虛擬裝置、修改裝置屬性和狀態、在 Google Home Graph 中查看這些裝置,以及匯入或匯出裝置設定。

完成帳戶連結程序

如要使用 Google Home Playground,建議您先將這項工具連結到帳戶。在手機上開啟 Google Home app (GHA),接著完成帳戶連結程序:

  1. 按一下左上角的「+」圖示。
  2. 依序選取「設定裝置」>「與 Google 服務連結」
  3. 搜尋名稱為 Google Home Playground 的動作。
  4. 選取動作,GHA 就會將您導向登入頁面。按一下「使用 Google 帳戶登入」,然後選取要登入的帳戶。
  5. 按一下「授權」按鈕,即可授權帳戶連結。
這個數字顯示用來連結 Google Home Playground 的 Google Home 應用程式帳戶連結流程。

帳戶連結完成後,GHA 會顯示一組預設虛擬裝置供您互動。

這張圖表會在使用者成功將 Google Home Playground 連結至自己的帳戶時,填入預設的裝置清單。

登入

請點選下方按鈕啟動 Google Home Playground

啟動 Playground

點選「Sign in with Google」,請務必以 GHA 中所用的帳戶登入。

此圖顯示 Google Home Playground 的初始狀態,並醒目顯示右上角的「登入」按鈕。

登入後,Google Home Playground 會顯示儲存在 Home Graph 的虛擬裝置。

此圖顯示裝置清單、裝置資訊,以及 Google Home Playground 預設檢視畫面的記錄。

網頁版 UI 包含三個面板:

  • 裝置清單會顯示你的所有虛擬裝置。你可以透過這個面板選擇特定虛擬裝置查看資訊及建立虛擬裝置。
  • 裝置資訊:顯示所選虛擬裝置的資訊。您也可以透過面板編輯這項資訊,並移除所選的虛擬裝置。
  • 「Log Area」(記錄區域) 會顯示 Google Home PlaygroundHome Graph 之間的互動記錄。您可以展開記錄檔來檢查要求和回應酬載,以進行疑難排解。

虛擬裝置

查看虛擬裝置資訊

在「Device list」(裝置清單) 面板中,選取要查看的虛擬裝置。「裝置資訊」面板會顯示資訊分為五個分頁:

  • 基本資訊:裝置的頂層屬性,包括裝置類型、ID 和名稱。
  • 特性:裝置支援的特性。
  • 屬性:裝置的特定屬性。
  • 狀態:所有裝置狀態。
  • SUV:裝置的次要使用者驗證設定。

編輯虛擬裝置資訊

除了查看虛擬裝置資訊之外,您也可以透過「Device info」(裝置資訊) 面板直接編輯儲存在 Home Graph 的資訊。

修改支援的特性

  1. 選取「Traits」分頁標籤,然後按一下「Edit」按鈕。
  2. 在彈出式面板中,您可以查看裝置目前支援的特性,以及可新增的特徵。使用箭頭 (arrow_forward/arrow_back) 按鈕,新增或移除裝置支援的特性。
  3. 完成更新支援的特性後,按一下「Save」(儲存),系統會將更新後的特徵套用至 Home Graph
  4. 您可在「記錄檔區域」中查看這些特性更新。
這張圖表顯示使用者體驗工具,以便在 Google Home Playground 中為所選裝置新增或刪除支援的特性。

修改裝置屬性

  1. 選取「Basic Information/Attributes」分頁標籤,然後編輯裝置支援的特性屬性。
  2. 編輯完成後,按下 Enter 鍵,系統就會將屬性變更套用到「Home Graph」。
  3. 您可以在「記錄檔區域」中查看這些更新的屬性。

修改裝置狀態

  1. 選取「States」分頁標籤並直接編輯狀態。狀態變更會套用至 Home Graph
  2. 您可以在「記錄區域」中查看這些狀態修改。

在虛擬裝置上新增次要使用者驗證

你可以將 SUV 新增至虛擬裝置,並設定各裝置的挑戰類型和對應的行為。

在裝置上設定 SUV

  1. 在「Device list」(裝置清單) 面板中,選取要設定的虛擬裝置。
  2. 在「Device info」(裝置資訊) 面板中,選取「SUV」(SUV) 分頁標籤,然後設定下列項目:
    • Enabled:裝置是否已啟用 SUV,或設為停用 (沒有驗證)。
    • 驗證類型:SUV 是否需要明確確認 (ackneeded) 或個人識別號碼 (pinneeded)。
    • PIN 碼:有效的 PIN 碼,
    • 如何處理不正確的 PIN 碼:如果 PIN 碼有誤、是否再詢問使用者,否則請回覆錯誤。
這張圖表顯示使用者體驗工具,以便在 Google Home Playground 中的所選裝置啟用次要使用者驗證特徵。

找出啟用 SUV 的裝置

在「Device list」(裝置清單) 面板中,每個已啟用 SUV 的裝置旁邊都會顯示金鑰 金鑰

這個圖表顯示建議啟用次要使用者驗證功能的裝置。

下列特性需要 SUV:

建立新的虛擬裝置

  1. 在「裝置清單」面板中,按一下「新增裝置」
  2. 在彈出式面板中選取裝置類型,並為新裝置輸入裝置名稱。或者,您也可以選取要新增的預先定義裝置組合。
  3. 完成所有步驟後,新裝置就會新增至 Home Graph
這張圖表顯示使用者體驗工具,可在 Google Home Playground 中新增裝置類型。

移除虛擬裝置

  1. 在「裝置清單」面板中,選取要移除的裝置。 接著,在「Device info」(裝置資訊) 面板中,選取「Basic Information」(基本資訊) 分頁標籤,然後按一下底部的 垃圾桶圖示「Remove device」(移除裝置)
  2. 在彈出式通知中確認移除裝置。
  3. 在確認移除裝置後,裝置會從 Home Graph 中移除。
這張圖表顯示使用者體驗工具,用於移除 Google Home Playground 中的虛擬裝置類型。

匯入及匯出虛擬裝置

如要排解問題或重現問題,您可以將虛擬裝置的狀態匯出到檔案中,然後與他人共用檔案,以便匯入及複製虛擬裝置。

這張圖表顯示用來在 Google Home Playground 中匯入及匯出虛擬裝置的使用者體驗工具。

將虛擬裝置匯出為檔案

  1. 按一下 即可將虛擬裝置匯出成檔案。
  2. 輸入要匯出的檔案名稱,然後按一下「確定」。
  3. 輸入檔案名稱後,瀏覽器會下載已匯出的虛擬裝置檔案。

從檔案匯入虛擬裝置

  1. 按一下 即可從檔案匯入虛擬裝置。
  2. 選取要匯入的檔案,然後按一下「OK」
  3. 確認要匯入的檔案後,Google Home Playground 會匯入檔案中狀態的虛擬裝置,並更新 Home Graph 中匯入裝置的資訊和狀態。

檢查互動記錄

與虛擬裝置互動時,Google Home Playground 會自動將您的變更套用至 Home Graph。與 Home Graph 的互動會記錄在「Log Area」(記錄區域) 面板中,您可以展開每個項目來檢查 Home Graph API 要求和回應酬載。

每個記錄項目都是 JSON 陣列,包含下列結構的元素:

{
  "uri": string,
  "request": object,
  "response": object
}
欄位 類型 說明
uri string Home Graph API 呼叫的網址。
request object Home Graph API 呼叫的要求主體。如需每種方法的格式,請參閱參考說明文件
response object Home Graph API 呼叫的回應內文。如需每種方法的格式,請參閱參考說明文件

查看支援的裝置類型和特性

右上方的「問號」說明圖示會顯示 Google Home Playground 支援的目前裝置類型和特性清單。

這張圖表顯示使用者體驗工具,可在 Google Home Playground 中新增裝置類型。

意見回饋與回報問題

我們想聽聽你的看法!請按一下右上方的笑臉圖示 feedback_satisfied,或透過驚嘆號圖示 意見回饋回報問題。

這個圖示顯示了在 Google Home Playground 中提供意見回饋和回報問題的圖示。