如要將 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。
設定 SDK
開放 Beta 版中的 Home API 尚未納入 Google 提供的標準開發程式庫。如要使用 Home API 開發應用程式,您需要下載程式庫並在本機代管。
如要下載 Home API Android SDK,請先登入 Google Home 開發人員帳戶。