Google Home 遊樂場

裝置 SDK

Google Home Playground 是模擬智慧型裝置的網頁應用程式 以及可設定的裝置類型和特徵的首頁專案您可以建立虛擬機器 修改裝置屬性和狀態，在 Google Home Graph，並匯入或匯出裝置設定。

完成帳戶連結

如要使用「Google Home Playground」，建議您先將 加進帳戶在手機上開啟 Google Home app (GHA)，然後 連結程序：

1. 按一下左上角的「加號 (+)」圖示。
2. 選取設定裝置 >支援 Google。
3. 搜尋名為「Google Home Playground」的動作。
4. 選取動作後，GHA 會將您導向 登入頁面。 點選「使用 Google 帳戶登入」，然後選取要登入的帳戶。
5. 按一下「授權」按鈕，即可授權連結帳戶。

完成帳戶連結後，系統會顯示一組預設的虛擬裝置 讓您互動的 GHA。

登入

點選下方按鈕可啟動 Google Home Playground：

啟動遊樂場

點選「Sign in with Google」，請務必使用相同的帳戶登入 以完成帳戶連結。GHA

登入後，Google Home Playground 會顯示虛擬裝置 儲存在「Home Graph」中。

網頁版 UI 由三個面板組成：

• 裝置清單會顯示所有虛擬裝置。您可以選取 透過虛擬裝置查看相關資訊及建立虛擬裝置 這個面板
• 裝置資訊：顯示所選虛擬裝置的資訊。 你也可以透過下列方式編輯這項資訊及移除所選虛擬裝置： 面板
• 記錄區域會顯示 Google Home Playground和Home Graph。你可以 展開記錄檔，檢查要求和回應酬載 來排解問題

虛擬裝置

查看虛擬裝置資訊

在「裝置清單」面板中，選取要查看的虛擬裝置。 在「裝置清單」面板中，選取要查看的虛擬裝置。 「裝置資訊」面板會將裝置資訊分為以下五個分頁：

• 基本資訊：裝置的頂層屬性，包括裝置 type、id 與 name
• 特徵：支援的裝置特性。
• 屬性：裝置的特徵專屬屬性。
• 狀態：所有裝置狀態。
• SUV： 次要使用者驗證設定 裝置。

編輯虛擬裝置資訊

除了查看虛擬裝置的資訊之外，你也可以直接編輯 透過裝置資訊儲存在 Home Graph 的資訊 面板。

修改支援的特徵

1. 選取「Traits」分頁標籤。請按一下「編輯」按鈕。
2. 在彈出式面板中，你可以查看裝置目前支援的特徵，以及 可新增的特徵使用箭頭 (arrow_forward/arrow_back) 按鈕可執行以下操作： 新增或移除裝置支援的 trait。
3. 支援的特徵更新完成後，按一下「Save」(儲存)，然後 更新後的特徵會套用至 Home Graph。
4. 您可以在「Log 區域」中查看這些特徵更新。

修改裝置屬性

1. 選取「屬性」分頁標籤，然後編輯屬性 裝置所支援的特性
2. 編輯完成後，請按下 Enter 鍵，屬性變更將會生效 套用於 Home Graph。
3. 您可以在記錄區域中查看這些更新後的屬性。

修改裝置狀態

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

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

您可以為虛擬裝置新增 SUV，並設定挑戰類型 每個裝置上的對應行為 您可以為虛擬裝置新增 SUV，並設定挑戰類型 每個裝置上的對應行為

在裝置上設定 SUV

1. 在「Device list」(裝置清單) 面板中，選取要啟用的虛擬裝置 設定。
2. 在「裝置資訊」面板中，選取「SUV」分頁標籤，然後設定 包括：
   • 已啟用：要啟用或停用 SUV (無驗證問題) 裝置。
   • 挑戰類型：SUV 是否需要明確確認 (ackNeeded) 或 個人識別碼 (pinNeeded)
   • PIN 碼：有效的 PIN 碼。
   • 處理不正確的 PIN 碼：當 PIN 碼有誤時，是否要詢問 如果有回應，則會傳回錯誤。

找出支援 SUV 的裝置

在「裝置清單」面板中，查看「鑰匙」圖示 鍵會顯示在 每部支援 SUV 的裝置

以下特徵清單需要 SUV：

• ArmDisarm
• LockUnlock
• OpenClose
• 重新啟動
• SoftwareUpdate

建立新的虛擬裝置

1. 在「裝置清單」面板中，按一下「新增裝置」。
2. 在彈出式面板中，選取裝置類型並輸入裝置名稱 開始解鎖裝置。您也可以選取一組預先定義的裝置 。
3. 完成所有步驟後，新裝置就會新增到 Home Graph。

移除虛擬裝置

1. 在「裝置清單」面板中，選取要移除的裝置。 接著在「裝置資訊」面板中選取「基本資訊」分頁標籤，然後 接著在「裝置資訊」面板中選取「基本資訊」分頁標籤，然後 按一下底部的 「移除裝置」。
2. 並透過彈出式快訊確認移除裝置。
3. 確認移除裝置後，系統會將裝置從 Home Graph。

同步處理回應編輯者

你可以在 Google Home Playground 中驗證或更新同步回應。 按一下「Sync Response Editor」開啟內嵌 IDE。

請編輯或複製及貼上同步處理回應，然後按一下「儲存」以套用變更 ，瞭解 Google Home 生態系統在 Google Home 生態系統中的運作方式。

匯入及匯出虛擬裝置

如要排解或重現問題，可以匯出虛擬裝置 與狀態寫入檔案，並與他人分享要匯入及儲存的檔案 複製虛擬裝置

將虛擬裝置匯出為檔案

1. 按一下「file_download」即可匯出 複製到檔案中
2. 輸入要匯出的檔案名稱，然後按一下「確定」。
3. 輸入檔案名稱後，瀏覽器 以及匯出的虛擬裝置

從檔案匯入虛擬裝置

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

檢查互動記錄

與虛擬裝置互動時，Google Home Playground 您的變更會自動套用到 Home Graph。 與 Home Graph 的互動會記錄在記錄區域 面板，您可在此展開每個項目並查看 Home Graph API 要求和回應酬載。

每個記錄項目都是 JSON 陣列，其中包含下列結構的元素：

{
  "uri": string,
  "request": object,
  "response": object
}

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

問號 help 右上角的圖示會顯示目前的裝置類型和特徵清單 由 Google Home Playground 支援。

回報問題

歡迎與我們分享你的意見！使用 驚嘆號圖示 意見回饋