歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。

Google Home 遊樂場

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Device SDK

Google Home Playground 是一款網頁應用程式,可讓您模擬具有可設定裝置類型和特性的虛擬住家,藉此模擬智慧住宅專案。Home Playground 可讓您建立虛擬裝置、修改裝置屬性和狀態、在 Google Home Graph 中查看這些裝置,以及匯入或匯出裝置設定。

完成帳戶連結

如要使用 Home Playground,建議您先將此工具連結至您的帳戶。在手機上開啟 Google Home app (GHA),然後完成帳戶連結程序:

  1. 按一下左上角的加號 (+)。
  2. 依序選取 [設定裝置] > [與 Google 服務連結]
  3. 搜尋名為「Google Home Playground」的動作。
  4. 選取動作,GHA 會將您導向登入頁面。按一下 [Sign in with Google],然後選取要登入的帳戶。
  5. 按一下 [授權] 按鈕,以授權連結帳戶。
下圖顯示連結 Google Home Playground 的 Google Home 應用程式帳戶連結流程。

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

此圖表顯示使用者成功將 Google Home Playground 連結至自己的帳戶時填入的預設裝置清單。

登入

點擊下方按鈕即可啟動 Home Playground

啟動 Playground

按一下 [Sign in with Google]。請務必登入您在 GHA 中所使用的帳戶,以完成帳戶連結作業。

下圖顯示 Google Home Playground 的初始狀態,並醒目顯示右上角的登入按鈕。

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

下圖顯示 Google Home Playground 預設檢視畫面的裝置清單、裝置資訊和記錄區域。

網頁版 UI 包含三個面板:

  • 裝置清單:顯示所有虛擬裝置。您可以選取特定虛擬裝置來查看其資訊,並透過這個面板建立虛擬裝置。
  • 裝置資訊:顯示所選虛擬裝置的資訊。 您也可以透過面板編輯這項資訊,移除所選的虛擬裝置。
  • 記錄區域會顯示 Home PlaygroundHome Graph 之間的互動記錄。您可以展開記錄來檢查要求和回應酬載以進行疑難排解。

虛擬裝置

查看虛擬裝置資訊

在「裝置清單」面板中,選取您要查看的虛擬裝置。「裝置資訊」面板的資訊分為五種分頁:

  • 基本資訊:裝置的頂層屬性,包括裝置類型、ID 和名稱。
  • 傾斜:受支援的裝置特徵。
  • 屬性:裝置的特性專屬屬性。
  • 狀態:所有裝置狀態。
  • SUV:裝置的次要使用者驗證設定。

編輯虛擬裝置資訊

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

修改支援的特性

  1. 選取 [交易] 分頁標籤,然後按一下 [編輯] 按鈕。
  2. 在彈出式面板中,您可以查看裝置目前支援的特性,以及可新增的特性。使用箭頭 (arrow_forward/arrow_back) 按鈕,新增或移除裝置支援的特性。
  3. 完成支援的屬性更新後,請按一下 [Save] (儲存),更新後的更新資料就會套用至 Home Graph
  4. 您可在記錄區域中查看這些特徵更新。
下圖顯示在 Google Home Playground 中,所選裝置新增或刪除支援的特徵的使用者體驗工具。

修改裝置屬性

  1. 選取 [Basic Information/Attributes] (基本資訊/屬性) 分頁標籤,然後編輯裝置支援的特性。
  2. 編輯完畢後,按下 Enter 鍵即可將屬性變更套用到 Home Graph
  3. 您可以前往記錄區域查看這些更新後的屬性。

修改裝置狀態

  1. 選取 [States] 分頁標籤,然後直接編輯狀態。狀態變更會套用至 Home Graph
  2. 您可以在記錄區域查看這些狀態的修改內容。

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

您可以將 SUV 新增至虛擬裝置,並設定其挑戰類型和每部裝置上的對應行為。

在裝置上設定 SUV

  1. 在「Device list」(裝置清單) 面板中,選取您要設定的虛擬裝置。
  2. 在「Device info」(裝置資訊) 面板中,選取「SUV」分頁標籤,然後設定以下項目:
    • 已啟用:裝置是否已啟用 SUV (沒有挑戰)。
    • 驗證類型:SUV 是否需要明確確認 (ackneeded) 或個人識別號碼 (pinRequireed)。
    • PIN 碼:有效的 PIN 碼。
    • 處理錯誤的 PIN 碼:當 PIN 碼錯誤時,是否要再次詢問使用者,否則不會回應。
下圖顯示在 Google Home Playground 中,所選裝置的啟用次要使用者驗證特性的使用者體驗工具。

找出啟用 SUV 的裝置

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

此圖顯示建議啟用次要使用者驗證的裝置。

以下特性需要 SUV:

建立新的虛擬裝置

  1. 在「裝置清單」面板中,按一下 [新增裝置]
  2. 在彈出式面板中選取裝置類型,然後輸入新裝置的名稱。您也可以選取一組預先定義的裝置來新增裝置。
  3. 完成所有步驟後,新裝置就會新增至 Home Graph
下圖顯示在 Google Home Playground 中新增裝置類型類型的使用者體驗工具。

移除虛擬裝置

  1. 在「裝置清單」面板中,選取您要移除的裝置。 接著,在「Device info」(裝置資訊) 面板中選取 [Basic Information] 分頁標籤,然後按一下底部的 [Remove device] (移除裝置)垃圾桶圖示
  2. 在彈出式快訊中確認移除裝置。
  3. 確認移除裝置後,裝置就會從 Home Graph 中移除。
下圖顯示了在 Google Home Playground 中移除虛擬裝置類型的使用者體驗工具。

匯入及匯出虛擬裝置

如要排解或重現問題,您可以將虛擬裝置的狀態 (包含狀態) 匯出至檔案,並與他人分享檔案,以匯入和複製虛擬裝置。

下圖顯示在 Google Home Playground 中匯入及匯出虛擬裝置的使用者體驗工具。

將虛擬裝置匯出至檔案

  1. 按一下 即可將虛擬裝置匯出至檔案。
  2. 輸入您要匯出的檔案名稱,然後按一下 [確定]
  3. 輸入檔案名稱後,瀏覽器會下載匯出的虛擬裝置檔案。

從檔案匯入虛擬裝置

  1. 按一下 即可從檔案匯入虛擬裝置。
  2. 選取您要匯入的檔案,然後按一下 [確定]
  3. 在您確認要匯入的檔案後,Home Playground 會從匯入檔案匯入具備狀態的虛擬裝置,並在 Home Graph 中更新匯入裝置的資訊和狀態。

檢查互動記錄

您與虛擬裝置互動時,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 呼叫的回應主體。請參閱參考說明文件,瞭解每種方法的格式。

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

右上方的「問號」說明圖示會顯示 Home Playground 支援的目前裝置類型和特性清單。

下圖顯示在 Google Home Playground 中新增裝置類型類型的使用者體驗工具。

意見回饋和回報問題

我們想聽聽你的看法!如要提供意見回饋,請按一下右上角的笑臉圖示 feedback_satisfied,或是利用驚嘆號圖示意見回饋回報問題。

下圖顯示在 Google Home Playground 中提供意見回饋和回報問題的圖示。