將 Home API 新增至 Android 應用程式

要將 Home API 新增到 Android 應用程式中,您需要滿足一些先決條件。

必要條件

如要進行開發,您需要一台電腦,並在電腦上安裝下列工具:

  • 2024.2.1 版 (「Ladybug」) 以上版本。 Android Studio請注意,如果版本較舊,可能無法正常使用 Home API SDK。

    下載 Android Studio

  • 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。

表格:支援 Home API 的 Google Nest Hub
裝置 Thread 支援邊界路由器 Google 商店
Google Home
Google Nest Audio
Google Nest Hub
Google Nest Hub (2nd gen)
Google Nest Hub Max
Google Nest Mini
Google TV Streamer (4k)
Nest WiFi Pro

設定 SDK

開放 Beta 版中的 Home API 尚未納入 Google 提供的標準開發程式庫。如要使用 Home API 開發應用程式,您需要下載程式庫並在本機代管。

要下載 Home APIs Android SDK,您必須先登入 Google Home Developers。

立即登入!