要將 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 智慧家庭中心支援 Home API。
設定 SDK
開放 Beta 版中的 Home API 尚未納入 Google 提供的標準開發程式庫。如要使用 Home API 開發應用程式,您需要下載程式庫並在本機代管。
要下載 Home APIs Android SDK,您必須先登入 Google Home Developers。