將 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 範例應用程式支援下列裝置類型和特徵:

    • 色溫燈 (開啟和關閉、亮度)
    • 接觸感應器 (布林值狀態)
    • 可調光燈 (開關、亮度)
    • 擴展色光 (開啟和關閉、亮度)
    • 一般切換器
    • 活動情形感應器 (活動情形偵測)
    • 開燈/關燈 (開關、亮度)
    • 開關
    • 開啟/關閉外掛程式單元 (開啟和關閉)
    • 開關感應器

支援的 Hub

只有特定 Google Nest Hub 支援 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 API Android SDK,請先登入 Google Home 開發人員帳戶。

立即登入!