Google Home 遊樂場

雲端對雲端    Local Home SDK    Home API

Google Home Playground 是一個 Web 應用程序，它模擬智慧家庭項目，具有可配置的設備類型和特性。您可以建立虛擬裝置、修改裝置屬性和狀態、在 Google Home Graph 中查看這些裝置，以及匯入或匯出裝置設定。

完成帳戶關聯

如要使用 Google Home Playground，建議您先將工具連結至帳戶。在手機上開啟 Google Home app (GHA)，然後按照「在 Google Home 應用程式中連結第三方智慧住宅裝置」一文中的說明，完成帳戶連結程序。

1. 搜尋名為 Google Home Playground 的整合。
2. 選取整合服務，系統會將你導向登入頁面。GHA按一下「使用 Google 帳戶登入」，然後選取帳戶登入。
3. 按一下「授權」按鈕，授權連結帳戶。

完成帳戶關聯後，GHA 上將顯示一組預設虛擬設備供您互動。

登入

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

啟動 Playground

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

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

網頁使用者介面由三個面板組成：

• 裝置清單會顯示所有虛擬裝置。您可以選取特定虛擬裝置，透過這個面板查看相關資訊及建立虛擬裝置。
• 設備資訊 顯示所選虛擬設備的資訊。 你也可以透過面板編輯這項資訊，以及移除所選虛擬裝置。
• 日誌區域顯示Google Home Playground和Home Graph之間的交互日誌。您可以展開記錄，檢查要求和回應酬載，以進行疑難排解。

虛擬裝置

查看虛擬設備資訊

在「裝置清單」面板中，選取要查看的虛擬裝置。 在「裝置清單」面板中，選取要查看的虛擬裝置。 「裝置資訊」面板會顯示裝置資訊，並依五個分頁分類：

• 基本資訊：裝置的頂層屬性，包括裝置類型、ID 和名稱。
• 特性: 設備支援的特性。
• 屬性：裝置的特徵專屬屬性。
• 狀態：所有裝置狀態。
• SUV：裝置的雙重使用者驗證設定。

編輯虛擬裝置資訊

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

修改支持的性狀

1. 選擇 特性 標籤；點選 編輯 按鈕。
2. 在彈出面板中，您可以查看設備目前支援的特性以及可新增的特性。使用 arrow (arrow_forward/arrow_back) 按鈕，為裝置新增或移除支援的特徵。
3. 更新完支援的特性後，點選儲存，更新後的特性將套用於Home Graph。
4. 您可以在記錄區域中查看這些特徵更新。

修改裝置屬性

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

修改裝置狀態

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

為虛擬裝置新增雙重使用者驗證

您可以在虛擬裝置中新增 SUV，並在每個裝置上設定驗證類型和對應行為。您可以在虛擬裝置中新增 SUV，並在每個裝置上設定驗證類型和相應行為。

在裝置上設定 SUV

1. 在「裝置清單」面板中，選取要設定的虛擬裝置。
2. 在「Device info」面板中，選取「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 生態系統的運作方式。

匯入及匯出虛擬裝置

如要排解或重現問題，您可以將虛擬裝置及其狀態匯出至檔案，並與他人共用該檔案，讓對方匯入並複製您的虛擬裝置。

將虛擬裝置匯出至檔案

1. 按一下 file_download，將虛擬裝置匯出至檔案。
2. 輸入要匯出的檔案名稱，然後按一下「確定」。
3. 輸入檔案名稱後，瀏覽器就會下載匯出的虛擬裝置檔案。

從檔案匯入虛擬裝置

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

檢查互動記錄

當您與虛擬裝置互動時，Google Home Playground 會自動將您的變更套用到 Home Graph。與 Home Graph 的交互記錄在 日誌區域 面板中，您可以展開每個條目來檢查 Home Graph API 請求和回應有效負載。

每個日誌條目都是一個 JSON 數組，包含以下結構的元素：

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

查看支援的設備類型和特性

按一下右上方的問號 說明圖示，即可查看 Google Home Playground 目前支援的裝置類型和特徵清單。

回報問題

我們期待您的回饋！報告在使用過程中遇到問題驚嘆號圖標 回饋在右上角。