繼續進行帳戶授權前,請確認您已備妥以下項目:
- 在行動裝置上安裝 Google Home app (GHA),並在 Google 帳戶中設定至少一個住家 (建築物)。
- 住家中至少有一個支援範例應用程式的裝置類型:
- 色溫燈光 (開啟/關閉、亮度)
- 接觸感應器 (布林值狀態)
- 可調光燈具 (開啟、關閉、亮度)
- 擴充型彩燈 (開啟/關閉、亮度)
- 通用切換
- 活動情形感應器 (活動情形偵測)
- 開/關燈 (開啟和關閉、亮度)
- 開/關燈開關
- 開/關插入式裝置 (開啟和關閉)
- 開/關感應器
- 兩部裝置,用於測試範例自動化功能。
在透過 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 中核准的裝置類型。
輕觸「允許存取所選住家」:
- 如果帳戶已連結住家,請選擇要授權的住家。如果在所選住家中找不到任何裝置,你可以:
- 輕觸「允許存取其他住家」,即可選取其他住家。
- 使用 Google Home app (GHA) 在該住家中設定所選裝置。請注意,只有下列裝置類型支援本範例應用程式中的控制項:
- 色溫燈光 (開啟/關閉、亮度)
- 接觸感應器 (布林值狀態)
- 可調光燈具 (開啟、關閉、亮度)
- 擴充型彩燈 (開啟/關閉、亮度)
- 通用切換
- 活動情形感應器 (活動情形偵測)
- 開/關燈 (開啟和關閉、亮度)
- 開/關燈開關
- 開/關插入式裝置 (開啟和關閉)
- 開/關感應器
- 如果帳戶沒有連結的住家,畫面上會顯示「所選帳戶沒有任何結構體」的訊息。
- 向後滑動即可返回主要的應用程式示例畫面。
- 如要設定住家,請使用 GHA。然後再次嘗試授予範例應用程式權限。
您隨時可以選取任何範例應用程式畫面右上方的個人資料圖示
,重新查看權限流程。成功授權住家裝置後,系統會將你導向裝置檢視畫面。您可以透過範例應用程式控制裝置,並觀察裝置狀態變更。