雲端轉雲端 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 之間的互動記錄。您可以展開記錄檔來檢查要求和回應酬載,以進行疑難排解。
虛擬裝置
查看虛擬裝置資訊
在「裝置清單」面板中,選取要查看的虛擬裝置。在「裝置清單」面板中,選取要查看的虛擬裝置。「裝置資訊」面板會顯示其資訊分為五個分頁:
- 基本資訊:裝置的頂層屬性,包括裝置類型、ID 和名稱。
- Traits:裝置支援的 traits。
- 屬性:裝置的特徵專屬屬性。
- 狀態:所有裝置狀態。
- SUV:裝置的次要使用者驗證設定。
編輯虛擬裝置資訊
除了查看虛擬裝置的資訊,您也可以透過「裝置資訊」面板直接編輯儲存在 Home Graph 中的資訊。
修改支援的 traits
- 選取「Traits」分頁標籤,然後按一下「Edit」按鈕。
- 彈出式面板中會顯示裝置目前支援的特性,以及要新增的特徵。使用箭頭
(arrow_forward/arrow_back) 按鈕新增或移除裝置支援的 trait。 - 更新支援的特徵後,按一下「Save」,更新後的特徵將套用至 Home Graph。
- 您可以在「記錄區域」中查看這些特徵更新。
修改裝置屬性
- 選取「Attributes」分頁標籤,然後編輯裝置支援的特徵屬性。
- 完成編輯後,按下 Enter 鍵,屬性變更就會套用至 Home Graph。
- 您可以在記錄區域中查看這些更新的屬性。
修改裝置狀態
- 選取「States」分頁標籤並直接編輯狀態。狀態變更會套用至 Home Graph。
- 您可以在記錄區域中查看這些狀態修改。
在虛擬裝置中新增雙重使用者驗證
您可以將 SUV 新增至虛擬裝置,並設定其挑戰類型,並在每部裝置上對應行為。您可以將 SUV 新增至虛擬裝置,並在每部裝置上設定挑戰類型和對應行為。
在裝置上設定 SUV
- 在「Device list」面板中,選取要設定的虛擬裝置。
- 在「裝置資訊」面板中,選取「SUV」分頁標籤並設定下列選項:
找出支援 SUV 的裝置
在「裝置清單」面板中,每部啟用 SUV 的裝置旁邊會顯示鍵盤圖示 鍵。
需要 SUV 的特徵清單如下:
建立新的虛擬裝置
- 在「裝置清單」面板中,按一下「新增裝置」。
- 在彈出式面板中,選取裝置類型,並為新裝置輸入裝置名稱。或者,您也可以選取要新增的預先定義裝置組合。
- 完成所有步驟後,新裝置就會新增至 Home Graph。
移除虛擬裝置
- 在「裝置清單」面板中,選取要移除的裝置。 接著,在「Device info」(裝置資訊) 面板中選取「Basic Information」分頁標籤,然後在「Device info」(裝置資訊) 面板中選取「Basic Information」(基本資訊) 分頁標籤,然後按一下底部的 「Remove device」(移除裝置)。
- 在彈出式快訊中確認移除裝置。
- 確認移除裝置後,系統就會將裝置從 Home Graph 中移除。
同步回應編輯器
您可以在 Google Home Playground 中驗證或更新同步回應。按一下「Sync Response Editor」開啟嵌入式 IDE。
編輯或複製及貼上您的同步回應,然後按一下「Save」來套用變更,看看在 Google Home 生態系統中的運作方式。
匯入及匯出虛擬裝置
如要進行疑難排解或重現問題,您可以將虛擬裝置及其狀態匯出為檔案,然後與他人共用該檔案,以便匯入及複製虛擬裝置。
將虛擬裝置匯出為檔案
- 按一下 即可將虛擬裝置匯出至檔案。
- 輸入要匯出的檔案名稱,然後按一下「確定」。
- 輸入檔案名稱後,瀏覽器就會下載已匯出的虛擬裝置檔案。
從檔案匯入虛擬裝置
- 按一下 即可從檔案匯入虛擬裝置。
- 選取要匯入的檔案,然後按一下「OK」。
- 一旦確認要匯入的檔案,Google Home Playground 就會從檔案匯入狀態的虛擬裝置,並在 Home Graph 中更新匯入裝置的資訊和狀態。
檢查互動記錄
當您與虛擬裝置互動時,Google Home Playground 會自動將變更套用至 Home Graph。與 Home Graph 的互動會記錄在「Log 區域」面板中,您可以展開每個項目來檢查 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 呼叫的回應主體。如要瞭解每種方法的格式,請參閱參考說明文件。參考說明文件。 |
查看支援的裝置類型和 trait
右上角的問號 help 圖示會顯示 Google Home Playground 目前的裝置類型和 trait 清單。
回報問題
我們想聽聽你的看法!使用右上方的驚嘆號圖示 意見回饋回報問題。