将 Home API 添加到您的 Android 应用

如需向 Android 应用添加 Home API，您需要满足一些前提条件。

前提条件

如需进行开发，您需要一台安装了以下工具的计算机：

  • Android Studio，版本 2024.2.1（“Ladybug”）或更高版本。 请注意，低于此版本的 SDK 可能无法与 Home API SDK 正常搭配使用。

    下载 Android Studio

  • Android 调试程序 (adb)。

    安装 adb。

    您可以使用 SDK 管理器执行此操作。

如需测试 Home API，您需要：

  • 搭载 Android 10 或更高版本的 Android 设备，并已设置您打算用于开发的 Google 账号。确保已安装最新版本的 Android Studio，并使用此开发者账号登录。
  • Wi-Fi 网络。
  • 支持 Home API 的 Google 集线器。

  • 住宅中至少有一台受支持的设备。如果此设备（或您要测试的任何其他设备）使用 Thread，则集线器也必须是 Thread 边界路由器。Android 示例应用支持以下设备类型和 trait：

    • 色温灯（开启和关闭、亮度）
    • 接触传感器（布尔值状态）
    • 可调光灯（开启和关闭、亮度）
    • 扩展色彩灯（开启和关闭、亮度）
    • 通用开关
    • 在家/外出传感器（在家/外出感知）
    • 开/关灯（开启和关闭、亮度）
    • 开/关灯开关
    • 开/关插入式装置（开启和关闭）
    • 开/关传感器

支持的集线器

只有某些 Google Nest Hub 支持 Home API。

表格：支持 Home API 的 Google Nest Hub
设备 操作系统 Thread 边界路由器支持 Google 商店
Google Home Cast
Google Nest Audio 演职人员表
Google Nest Hub Cast
Google Nest Hub (2nd gen) 灯笼海棠
Google Nest Hub Max 灯笼海棠
Google Nest Mini Cast
Google TV Streamer (4k) Android

设置 SDK

此 Beta 版公开测试中的 Home API 尚未纳入 Google 提供的开发标准库。如需使用 Home API 开发应用，您需要在本地下载并托管库。

如需下载 Home API Android SDK，您必须先登录 Google Home 开发者。

立即登录！