授權帳戶前,請確認您已:
- 在 Android 行動裝置上安裝 Google Home app (GHA),並在 Google 帳戶中設定至少一個住家 (結構)。
- 至少一個支援範例應用程式的裝置類型:
- 色溫燈 (開啟和關閉、亮度)
- 接觸感應器 (布林值狀態)
- 可調光燈 (開關、亮度)
- 擴展色光 (開啟和關閉、亮度)
- 一般切換器
- Google 相機
- 活動情形感應器 (活動情形偵測)
- 開燈/關燈 (開燈/關燈、亮度)
- 開關
- 開啟/關閉外掛程式單元 (開啟和關閉)
- 開關感應器
- 用於測試範例自動化的兩部裝置。
如要透過 Home API 使用裝置,必須先透過 GHA 控制裝置。
執行 Android 範例應用程式
執行 Android 範例應用程式。首次執行時,系統會要求您允許存取 Google 帳戶中的住家。這樣一來,範例應用程式就能存取及控制該住家中的結構和裝置。
應用程式的預設權限行為會因應用程式是否已在 Google Home Developer Console 註冊而異。
如果應用程式未在 Developer Console 中註冊,就會處於「未驗證」狀態。建議您使用這個方法測試 Home API:
只有在 OAuth 控制台中註冊為測試使用者的使用者,才能授予應用程式權限。未經驗證的應用程式最多只能有 100 位測試使用者。
未經驗證的應用程式可以存取 OAuth 支援的任何裝置類型 (裝置類型清單請參閱Developer Console)。系統會授予存取結構中所有裝置的權限。
如果應用程式已在Developer Console 中註冊,並獲准存取一或多種裝置類型,且已完成 OAuth 的品牌驗證,就會處於「已驗證」狀態。如要發布應用程式,必須先達到這個狀態:
- 測試使用者限制不再適用。任何使用者都可以授予應用程式權限。
- 使用者只能將權限授予 Developer Console 中核准的裝置類型。
輕觸「允許存取所選住家」:
- 如果帳戶已連結住家,請選擇要授權的住家。如果所選住家中沒有任何裝置,你可以:
- 輕觸「允許存取其他住家」,選取其他住家。
- 使用 Google Home app (GHA) 在該住家中設定所選裝置。請注意,只有下列裝置類型支援透過這個範例應用程式控制:
- 色溫燈 (開啟和關閉、亮度)
- 接觸感應器 (布林值狀態)
- 可調光燈 (開關、亮度)
- 擴展色光 (開啟和關閉、亮度)
- 一般切換器
- Google 相機
- 活動情形感應器 (活動情形偵測)
- 開燈/關燈 (開燈/關燈、亮度)
- 開關
- 開啟/關閉外掛程式單元 (開啟和關閉)
- 開關感應器
- 如果帳戶未連結任何住家,畫面上會顯示「所選帳戶沒有任何結構」訊息。
- 向後滑動即可返回「Sample App」主畫面。
- 如要設定住家,請使用 GHA。然後再次嘗試授予範例應用程式權限。
如要隨時重新查看權限流程,請在任一範例應用程式畫面中選取右上方的個人資料圖示
。



成功授予含有裝置的住家權限後,系統會將你帶往裝置檢視畫面。您可以透過範例應用程式控制裝置,並觀察裝置的狀態變化。