Google Home Playground 是模擬智慧型家居專案的網頁應用程式,可使用可設定的裝置類型和特徵。您可以建立虛擬裝置、修改裝置屬性和狀態、在 Google Home Graph 中查看這些裝置,以及匯入或匯出裝置設定。
完成帳戶連結
如要使用 Google Home Playground,建議您先將工具連結至帳戶。在手機上開啟 Google Home app (GHA),然後按照「在 Google Home 應用程式中連結第三方智慧住宅裝置」一文所述的步驟連結帳戶。
- 搜尋名為「Google Home Playground」的整合功能。
- 選取整合項目後,GHA 會將您導向登入頁面。按一下「使用 Google 帳戶登入」,然後選取要登入的帳戶。
- 按一下「授權」按鈕,授權連結帳戶。

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

登入
按一下下方按鈕,啟動 Google Home Playground:
點選「Sign in with Google」,請務必使用 GHA 中使用的帳戶登入,才能完成帳戶連結。

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

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

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

找出啟用 SUV 的裝置
在「裝置清單」面板中,每個支援 SUV 的裝置旁都會顯示鑰匙圖示 鑰匙。

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

移除虛擬裝置
- 在「裝置清單」面板中,選取要移除的裝置。接著,在「裝置資訊」面板中選取「基本資訊」分頁,然後點選底部的「移除裝置」
。
- 在彈出式警告中確認移除裝置。
- 確認移除裝置後,裝置就會從 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 支援的目前裝置類型和特徵清單。

回報問題
我們很樂於傾聽你的意見!使用右上方的驚嘆號圖示 意見回饋功能,回報遇到的問題。
