如要將 Home API 新增至 Android 應用程式,必須符合幾項必要條件。
必要條件
如要進行開發,您需要一台電腦,並在電腦上安裝下列工具:
2024.2.1 版 (「Ladybug」) 以上版本。 Android Studio請注意,如果使用舊版,可能無法正常使用 Home API SDK。
Android 偵錯工具 (
adb)。安裝
adb。您可以使用 SDK 管理工具完成這項操作。
如要測試 Home API,您需要:
- 搭載 Android 10 以上版本的 Android 裝置,並使用您打算用於開發的 Google 帳戶完成設定。請確認已安裝最新版本的 Android Studio,並使用這個開發帳戶登入。
- Wi-Fi 網路。
- 如要存取及控制Matter裝置,你還需要支援 Home API 的 Google 中樞裝置。詳情請參閱「Android 上的連線 」。
住家中至少有一部支援的裝置。如果這個裝置 (或任何你想測試的裝置) 使用 Thread,中樞也必須是 Thread 邊界路由器。Android 範例應用程式支援下列裝置類型和特徵:
- 色溫燈 (開啟和關閉、亮度)
- 接觸感應器 (布林值狀態)
- 可調光燈具 (開關、亮度)
- 擴展色光 (開啟和關閉、亮度)
- Generic Switch
- Google 相機
- 活動情形感應器 (活動情形偵測)
- 開燈/關燈 (開關燈、亮度)
- 開關
- 開啟/關閉外掛程式單元 (開啟和關閉)
- 開關感應器
支援的集線器
只有特定 Google Nest Hub 支援 Home API。
除了這些支援的中樞裝置,還有無中樞模式,可提供有限的 Home API 功能。
設定 SDK
開放 Beta 版中的 Home API 尚未納入 Google 提供的標準開發程式庫。如要使用 Home API 開發應用程式,您需要下載程式庫並在本機代管。
如要下載 Home API Android SDK,請先登入 Google Home 開發人員帳戶。