如需将 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 Border Router (TBR)。Android 示例应用支持以下设备类型和特征:
- 色温灯(开关、亮度)
- 接触传感器(布尔值状态)
- 可调光灯(开关、亮度)
- 门锁
- 扩展彩色灯(开和关、亮度)
- 通用开关
- Google 边界路由器
- Google 相机
- Google 门铃
- 在家/外出传感器(在家/外出感知)
- 开关灯(开和关、亮度)
- 电灯开关
- 开关插接单元(开和关)
- 开/关传感器
支持的集线器
只有部分 Google Nest Hub 支持 Home API。
设置 SDK
此公开 Beta 版中的 Home API 尚不属于 Google 提供的标准开发库。如需使用 Home API 开发应用,您需要在本地下载并托管这些库。
如需下载 Home APIs Android SDK,您必须先登录 Google Home Developers。