借助 Google 的 Home 开发者计划,设备制造商可以将其智能家居设备与 Google Home 生态系统相关联。我们正在扩展智能家居 Action 的本地执行路径,以便您使用 Google Home app (GHA) 添加支持 Matter 的设备进行设置,并使用 Google Assistant、GHA 或 Google Nest Hub (2nd gen) 等智能显示屏控制这些设备。
本文档介绍了如何开始在 Google Home 生态系统中构建和集成受 Matter 支持的平台。
免责声明
关于 Matter 文档中介绍的流程,请注意以下事项:
- 我们建议用于开发的账号仅连接一个启用了 Matter 的集线器进行测试。在测试期间同时连接多个启用了 Matter 的集线器或将多个集线器连接到同一结构可能会导致不可预测的行为。
- 所有这些步骤都假定使用运行 Ubuntu 20.04 的 Linux 机器来构建和刷写已由 Google 测试的 Matter 示例。虽然支持 macOS 计算机,但建议使用 Linux。在需要时,会在相应步骤中说明适用于 Mac 的说明。
如何构建
如需构建可与 Google Home 生态系统集成的 Matter 支持设备,您需要使用与 Matter 兼容的开发板和 Matter SDK。
最简单的入门方法是学习我们的 Codelab。建议您至少完成以下 Codelab 之一:
学习完 Codelab 后,查看我们的受支持设备列表,以确保您计划集成的设备受 Google Home 生态系统支持。然后,阅读开发者核对清单,了解从创建项目到发布的整个开发流程。
定义
本文档中会用到以下术语:
- 边界路由器
- 一种集线器,用于为启用了 Thread 的设备实现通用 Thread 边界路由器。
- Hub
- 支持的 Google Nest 设备,例如 Google Nest Hub (2nd gen)。必须使用 hub,才能通过其他 Surface(例如 Assistant、GHA 和智能显示屏)控制启用了 Matter 的设备。
- 支持 Matter 的设备
- 已刷写启用 Matter 的 build 或示例应用的设备或开发板。
- 移动设备
- 用于协助配对的测试手机。目前,这是一款 Android 手机。
前提条件
如需将支持 Matter 的设备与 Google Home 生态系统完全集成,开发者必须满足以下条件:
- 支持 Thread 的 Google 集线器,可同时用作支持 Thread 的设备的边界路由器,以及用于路由智能家居 intent 的本地执行方式路径。
- 一台符合最低要求的移动设备(测试手机):
- Android O(8.1、API 级别 27 或更高版本)
- iOS(16.5 或更高版本)
- BLE 功能
- 启用了 Matter 的设备的供应商 ID (VID) 和产品 ID (PID)。
- 支持 Matter 的设备。此设备应属于 Google Home 生态系统中支持的 Matter 设备类型之一,并且可以是:
- 您自己的产品,其固件支持 Matter。
- 以下任一 Matter 设备,用于进行端到端验证:
供应商 | 平台 | Thread 支持 | 指南 |
---|---|---|---|
Bouffalo Lab | BL602 | ||
BL702 | |||
Espressif | ESP32 | OTA 测试 | |
Nordic Semiconductor | nRF52840 DK | OTA 测试 | |
NXP | IOTZTB-DK006 开发套件 | ||
Realtek | Ameba D 系列 | ||
Silicon Labs | EFR32MG24 开发套件 | ||
EFR32MG Zigbee 和 Thread 入门套件 | |||
Telink | TLSR9518 | ||
Texas Instruments | CC2652R7 LaunchPad 开发套件 |
供应商 ID
默认情况下,您可以使用 CSA 分配的 VID 之一进行测试。选择以下之一:0xFFF1
、0xFFF2
、0xFFF3
、0xFFF4
。
如需使用正式版 VID 以便您的集成能够获得认证并发布,您必须先让 Google 对其进行验证,以确保该 VID 是由 CSA 签发给您的。
此 VID 应在设备的固件中实现。
Matter 设备只能在特定的供应商 ID 和设备类型场景中与 Google Home 生态系统配对。
- 测试 VID 不能在用户设备中使用。
- 您的正式版 VID 必须由 Connectivity Standards Alliance (Alliance) 签发。您必须先让 Google 验证您是该 VID 的所有者,然后才能在 Google Home Developer Console 中使用该 VID。完成后,您就可以为该 VID 创建集成。
- 出于开发和现场试验目的,您必须在 Developer Console 中创建项目和集成,并使用相应的 VID 和 PID 组合。设备的委托用户必须是项目成员,或者包含在现场试用用户列表中。
- 只有在您的产品获得 Alliance 认证后,消费者用户才能使用。
一个集成只能使用一次 VID 和 PID。如果您想在集成中使用相同的 VID 或 PID,则需要执行以下操作之一:
- 将使用 VID 或 PID 的集成修改为其他 VID 或 PID。
- 使用 VID 或 PID 删除集成。
哪些类型的用户可以将设备委托到 Google Home 生态系统中? | |||
---|---|---|---|
VID 类型 | VID 认证和控制台集成状态 | 正式版
(使用者) |
开发
(开发者、测试用户) |
测试 | Developer Console 中没有集成(无法认证) | ||
测试 | Developer Console 中存在集成(无法获得认证) | ||
生产 | 未经认证,集成不存在于 Developer Console | ||
生产 | 未经认证,集成存在于 Developer Console | ||
生产 | 在 Alliance DCL 中获得认证,但 Developer Console 中不存在集成 | ||
生产 | 已通过 Alliance DCL 认证,并且 Developer Console 中存在集成 |
产品 ID
系统会从 Matter 基本信息集群读取设备相关信息。设备固件中编码的商品 ID 必须与 Developer Console 中 Matter 集成的商品 ID 一致。
不支持的功能
某些 Matter 集群尚未向用户公开,但系统可能会使用这些集群。在大多数情况下,这意味着最终用户无法看到通过这些集群公开的属性:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
¹ 如需了解这对开/关型灯具开关有何影响,请参阅开/关型灯具开关。