Google Home Playground is a web application that allows you to simulate a smart home project by simulating a virtual home with configurable device types and traits. The Home Playground allows you to create virtual devices, modify the device attributes and states, view these devices in Google Home Graph , and import or export device configurations.
完成帳戶連結
如要使用 Home Playground,建議您先將此工具連結至您的帳戶。開啟 Google Home app (GHA) on your phone, and go through the account linking process:
- 按一下左上角的加號 (+)。
- 依序選取 [設定裝置] > [與 Google 服務連結]。
- 搜尋名為「Google Home Playground」的動作。
- 選取動作,GHA 會將您導向登入頁面。按一下 [Sign in with Google],然後選取要登入的帳戶。
- 按一下 [授權] 按鈕,以授權連結帳戶。

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

登入
點擊下方按鈕即可啟動 Home Playground。
按一下 [Sign in with Google]。請務必以您在 GHA 中使用的帳戶登入,完成帳戶連結作業。

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

網頁版 UI 包含三個面板:
- 裝置清單:顯示所有虛擬裝置。您可以選取特定虛擬裝置來查看其資訊,並透過這個面板建立虛擬裝置。
- 裝置資訊:顯示所選虛擬裝置的資訊。 您也可以透過面板編輯這項資訊,移除所選的虛擬裝置。
- 記錄區域顯示 Home Playground 和 Home Graph 之間的互動記錄。您可以展開記錄來檢查要求和回應酬載以進行疑難排解。
虛擬裝置
查看虛擬裝置資訊
在「裝置清單」面板中,選取您要查看的虛擬裝置。「裝置資訊」面板的資訊分為五種分頁:
- 基本資訊:裝置的頂層屬性,包括裝置類型、ID 和名稱。
- 傾斜:受支援的裝置特徵。
- 屬性:裝置的特性專屬屬性。
- 狀態:所有裝置狀態。
- SUV:裝置的次要使用者驗證設定。
編輯虛擬裝置資訊
除了查看虛擬裝置資訊外,您也可以透過裝置資訊面板,直接編輯儲存在 Home Graph 的資訊。
修改支援的特性
- 選取 [交易] 分頁標籤,然後按一下 [編輯] 按鈕。
- 在彈出式面板中,您可以查看裝置目前支援的特性,以及可新增的特性。使用箭頭
(arrow_forward/arrow_back) 按鈕,新增或移除裝置支援的特性。 - 更新完支援的特徵後,請按一下「Save」(儲存),系統隨即會將更新的特徵套用至 Home Graph。
- 您可在記錄區域中查看這些特徵更新。

修改裝置屬性
- 選取 [Basic Information/Attributes] (基本資訊/屬性) 分頁標籤,然後編輯裝置支援的特性。
- 編輯完畢後,按下 Enter 鍵即可將屬性變更套用至 Home Graph。
- 您可以前往記錄區域查看這些更新後的屬性。
修改裝置狀態
- 選取 [States] 分頁標籤,然後直接編輯狀態。狀態變更會套用至 Home Graph。
- 您可以在記錄區域查看這些狀態的修改內容。
為次要裝置新增次要使用者驗證
您可以將 SUV 新增至虛擬裝置,並設定其挑戰類型和每部裝置上的對應行為。
在裝置上設定 SUV
- 在「Device list」(裝置清單) 面板中,選取您要設定的虛擬裝置。
- 在「Device info」(裝置資訊) 面板中,選取「SUV」分頁標籤,然後設定以下項目:
- 已啟用:裝置是否已啟用 SUV (沒有挑戰)。
- 驗證類型:SUV 是否需要明確確認 (ackneeded) 或個人識別號碼 (pinRequireed)。
- PIN 碼:有效的 PIN 碼。
- 處理錯誤的 PIN 碼:當 PIN 碼錯誤時,是否要再次詢問使用者,否則不會回應。

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

以下特性需要 SUV:
建立新的虛擬裝置
- 在「裝置清單」面板中,按一下 [新增裝置]。
- 在彈出式面板中選取裝置類型,然後輸入新裝置的名稱。您也可以選取一組預先定義的裝置來新增裝置。
- 完成所有步驟後,新裝置就會新增至 Home Graph。

移除虛擬裝置
- 在「裝置清單」面板中,選取您要移除的裝置。
接著,在「Device info」(裝置資訊) 面板中選取 [Basic Information] 分頁標籤,然後按一下底部的 [Remove device] (移除裝置)
。
- 在彈出式快訊中確認移除裝置。
- 確認移除裝置後,系統會從 Home Graph 中移除該裝置。

匯入及匯出虛擬裝置
如要排解或重現問題,您可以將虛擬裝置的狀態 (包含狀態) 匯出至檔案,並與他人分享檔案,以匯入和複製虛擬裝置。

將虛擬裝置匯出至檔案
- 按一下 即可將虛擬裝置匯出至檔案。
- 輸入您要匯出的檔案名稱,然後按一下 [確定]。
- 輸入檔案名稱後,瀏覽器會下載匯出的虛擬裝置檔案。
從檔案匯入虛擬裝置
- 按一下 即可從檔案匯入虛擬裝置。
- 選取您要匯入的檔案,然後按一下 [確定]。
- 在您確認要匯入的檔案後,Home Playground 會從檔案匯入具有狀態的虛擬裝置,並在 Home Graph 中更新匯入裝置的資訊和狀態。
檢查互動記錄
當你與虛擬裝置互動時,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 呼叫的回應主體。請參閱參考說明文件,瞭解每種方法的格式。 |
查看支援的裝置類型和特性
右上方的「問號」說明圖示會顯示目前的裝置類型以及 Home Playground 支援的特性清單。

意見回饋和回報問題
我們想聽聽你的看法!如要提供意見回饋,請按一下右上角的笑臉圖示 feedback_satisfied,或是利用驚嘆號圖示 意見回饋回報問題。
