帳戶授權

繼續進行帳戶授權前,請確認您已備妥以下項目:

  1. 在行動裝置上安裝 Google Home app (GHA),並在 Google 帳戶中設定至少一個住家 (建築物)。
  2. 住家中至少有一個支援範例應用程式的裝置類型:
    • 色溫燈光 (開啟/關閉、亮度)
    • 接觸感應器 (布林值狀態)
    • 可調光燈具 (開啟、關閉、亮度)
    • 擴充型彩燈 (開啟/關閉、亮度)
    • 通用切換
    • 活動情形感應器 (活動情形偵測)
    • 開/關燈 (開啟和關閉、亮度)
    • 開/關燈開關
    • 開/關插入式裝置 (開啟和關閉)
    • 開/關感應器
  3. 兩部裝置,用於測試範例自動化功能。

在透過 Home API 使用裝置前,必須先透過 GHA 控制裝置。

執行範例應用程式

執行範例應用程式。首次執行時,系統會要求您允許 Google 帳戶存取住家。這樣一來,範例應用程式就能取得權限,存取及控制該住家中的結構體和裝置。

應用程式的預設權限行為會因應用程式是否已在 Google Home Developer Console 上註冊而有所不同。

如果應用程式未註冊至 Developer Console,則會處於未驗證狀態。建議您使用以下方法測試 Home API 的用途:

  • 只有在 OAuth 資訊主頁中註冊為測試使用者的使用者,才能授予應用程式權限。未經驗證的應用程式最多只能有 100 位測試使用者。

  • 未經驗證的應用程式可存取任何裝置類型的裝置,這些裝置類型皆為 OAuth 支援的 Google Home API (Developer Console 中的裝置類型清單)。系統會授予結構體中的所有裝置。

如果應用程式已註冊至 Developer Console ,且已獲准存取一或多種裝置類型,且已完成 OAuth 品牌驗證,則會處於已驗證狀態。如要將應用程式發布至正式環境,就必須使用這個狀態:

  • 測試使用者限制不再適用。任何使用者都能授予應用程式權限。
  • 使用者只能將權限授予 Developer Console 中核准的裝置類型。

輕觸「允許存取所選住家」

  • 如果帳戶已連結住家,請選擇要授權的住家。如果在所選住家中找不到任何裝置,你可以:
    1. 輕觸「允許存取其他住家」,即可選取其他住家。
    2. 使用 Google Home app (GHA) 在該住家中設定所選裝置。請注意,只有下列裝置類型支援本範例應用程式中的控制項:
      • 色溫燈光 (開啟/關閉、亮度)
      • 接觸感應器 (布林值狀態)
      • 可調光燈具 (開啟、關閉、亮度)
      • 擴充型彩燈 (開啟/關閉、亮度)
      • 通用切換
      • 活動情形感應器 (活動情形偵測)
      • 開/關燈 (開啟和關閉、亮度)
      • 開/關燈開關
      • 開/關插入式裝置 (開啟和關閉)
      • 開/關感應器
  • 如果帳戶沒有連結的住家,畫面上會顯示「所選帳戶沒有任何結構體」的訊息。
    1. 向後滑動即可返回主要的應用程式示例畫面。
    2. 如要設定住家,請使用 GHA。然後再次嘗試授予範例應用程式權限。

您隨時可以選取任何範例應用程式畫面右上方的個人資料圖示 ,重新查看權限流程。

選取要執行應用程式範例的結構。
圖 1:選取結構體
所選結構體,顯示可用的裝置。
圖 2:結構體和裝置
裝置的控制設定。
圖 3:裝置控制項
所選結構體,顯示可用的自動化動作。
圖 4:結構體和自動化動作

成功授權住家裝置後,系統會將你導向裝置檢視畫面。您可以透過範例應用程式控制裝置,並觀察裝置狀態變更。