如要將 Home API 新增至 Android 應用程式,必須符合幾項先決條件。
必要條件
如要進行開發,您必須在電腦上安裝下列工具:
Android Studio 2024.2.1 版 (「Ladybug」) 以上版本。請注意,如果版本早於此版本,可能無法與 Home API SDK 正常搭配運作。
Android 偵錯工具 (
adb)。安裝
adb。方法是使用 SDK Manager。
如要測試 Home API,您需要:
- 搭載 Android 10 以上版本的 Android 裝置,並已設定要用於開發的 Google 帳戶。請確認已安裝最新版本的 Android Studio,並使用這個開發人員帳戶登入。
- Wi-Fi 網路。
- 如要存取及控制 Matter 裝置,你還需要支援 Home API 的 Google 中樞裝置。詳情請參閱「Android 連線能力 」。
住家中至少有一部支援的裝置。如果這部裝置 (或任何其他要測試的裝置) 使用 Thread,中樞也必須是 Thread Border Router (TBR)。Android 範例應用程式支援下列裝置類型和特徵:
- 色溫燈 (開關、亮度)
- 接觸感應器 (布林值狀態)
- 可調光燈具 (開關、亮度)
- 門鎖
- 擴充彩色燈 (開關、亮度)
- 一般切換
- Google 邊界路由器
- Google 相機
- Google Doorbell
- 活動情形感應器 (在宅感應)
- 開關燈 (開和關、亮度)
- 電燈開關
- 開/關外掛式裝置 (開和關)
- 開關感應器
支援的中樞
只有特定 Google Nest Hub 支援 Home API。
設定 SDK
這個公開測試版中的 Home API 尚未納入 Google 開發人員平台提供的標準程式庫。如要使用 Home API 開發應用程式,請在本機下載並託管程式庫。
如要下載 Home API Android SDK,請先登入 Google Home 開發人員。