Cloud-to-cloud Local Home SDK Device SDK
Google Home Playground 是一個網頁應用程式,用於模擬具有可設定裝置類型和特性的智慧住宅專案。您可以建立虛擬裝置、修改裝置屬性和狀態、在 Google Home Graph 中查看這些裝置,以及匯入或匯出裝置設定。
完成帳戶連結程序
如要使用 Google Home Playground,建議您先將這項工具連結到帳戶。在手機上開啟 Google Home app (GHA),接著完成帳戶連結程序:
- 按一下左上角的「+」圖示。
- 依序選取「設定裝置」>「與 Google 服務連結」。
- 搜尋名稱為 Google Home Playground 的動作。
- 選取動作,GHA 就會將您導向登入頁面。按一下「使用 Google 帳戶登入」,然後選取要登入的帳戶。
- 按一下「授權」按鈕,即可授權帳戶連結。

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

登入
請點選下方按鈕啟動 Google Home Playground:
點選「Sign in with Google」,請務必以 GHA 中所用的帳戶登入。

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

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

修改裝置屬性
- 選取「Attributes」分頁標籤,然後編輯裝置支援的特性屬性。
- 編輯完成後,按下 Enter 鍵,系統就會將屬性變更套用到「Home Graph」。
- 您可以在「記錄檔區域」中查看這些更新的屬性。
修改裝置狀態
- 選取「States」分頁標籤並直接編輯狀態。狀態變更會套用至 Home Graph。
- 您可以在「記錄區域」中查看這些狀態修改。
在虛擬裝置上新增次要使用者驗證
你可以將 SUV 新增至虛擬裝置,並設定各裝置的挑戰類型和對應的行為。你可以將 SUV 新增至虛擬裝置,並設定各裝置的挑戰類型和對應的行為。
在裝置上設定 SUV
- 在「Device list」(裝置清單) 面板中,選取要設定的虛擬裝置。
- 在「Device info」(裝置資訊) 面板中,選取「SUV」(SUV) 分頁標籤,然後設定下列項目:

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

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

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

同步處理回應編輯者
您可以在 Google Home Playground 中驗證或更新同步回應。按一下「Sync Response Editor」,開啟嵌入的 IDE。

編輯或複製及貼上您的同步回應,然後按一下「儲存」套用變更,確認其在 Google Home 生態系統中的運作方式。

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

將虛擬裝置匯出為檔案
- 按一下 即可將虛擬裝置匯出成檔案。
- 輸入要匯出的檔案名稱,然後按一下「確定」。
- 輸入檔案名稱後,瀏覽器會下載已匯出的虛擬裝置檔案。
從檔案匯入虛擬裝置
- 按一下 即可從檔案匯入虛擬裝置。
- 選取要匯入的檔案,然後按一下「OK」。
- 確認要匯入的檔案後,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 支援的目前裝置類型和特性清單。

回報問題
我們想聽聽你的看法!使用右上方的驚嘆號圖示 意見回饋回報問題。
