如需将 Home API 添加到 Android 应用,您需要满足一些前提条件。
前提条件
对于开发,您需要一台安装了以下工具的计算机:
Android Studio,版本 2024.2.1(“Ladybug”)或更高版本。 请注意,低于此版本的版本可能无法与 Home APIs SDK 正常搭配使用。
Android 调试器 (
adb
)。安装
adb
。您可以使用 SDK 管理器完成此操作。
如需测试 Home API,您需要:
- 一部搭载 Android 10 或更高版本的 Android 设备,并已设置好您打算用于开发的 Google 账号。确保已安装最新版本的 Android Studio,并已使用此开发账号登录。
- Wi-Fi 网络。
- 如需访问和控制 Matter 设备,您还需要支持 Home API 的 Google hub。如需了解详情,请参阅 Android 上的连接 。
住宅中至少有一台受支持的设备。如果此设备(或您要测试的任何其他设备)使用 Thread,则 hub 也必须是 Thread 边界路由器。Android 示例应用支持以下设备类型和特征:
- 色温灯(开启和关闭、亮度)
- 接触传感器(布尔值状态)
- 可调光灯(开和关、亮度)
- 扩展色彩灯(开启和关闭、亮度)
- 通用开关
- Google 相机
- 在家/外出传感器(在家/外出感知)
- 开灯/关灯(开灯和关灯、亮度)
- 开/关灯开关
- 开启/关闭插件单元(开启和关闭)
- 开/关传感器
支持的 Hub
只有部分 Google Nest 中枢支持 Home API。
设置 SDK
此公开 Beta 版中的 Home API 尚不属于 Google 为开发提供的标准库。如需使用 Home API 开发应用,您需要下载这些库并在本地托管。
如需下载 Home API Android SDK,您必须先登录 Google Home Developers。