借助 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 之一：
为云到云集成启用本地执行方式
49 分钟
Updated 2024年12月21日
学习如何利用 Local Home SDK 启用本地执行方式，从而增强智能家居与 Google 助理间的集成。
将智能家居设备关联到 Google 助理
35 分钟
Updated 2024年11月23日
构建和部署云到云集成，以便将虚拟智能洗衣机集成到 Google 助理。
调试智能家居
25 分钟
Updated 2024年11月23日
了解如何使用 GCP 指标和 Logging 找出和解决生产问题。了解如何使用测试套件来发现功能和 API 问题。
智能家居基于日志的指标
16 分钟
Updated 2024年11月23日
了解如何在 Google Cloud 上使用基于日志的指标来跟踪模式和分析智能家居集成错误日志。
调试 Local Home
50 分钟
Updated 2024年11月23日
了解如何使用 GCP 指标和 Logging 找出和解决生产问题。了解如何使用测试套件来发现功能和 API 问题。了解如何在开发 Local Home 应用时使用 Chrome 开发者工具。
增强云到云集成并确保其安全无虞
50 分钟
Updated 2024年11月23日
了解如何通过自定义设备特征来优化云到云集成并增强其安全性，以及如何使用双重身份验证来确保其安全。
使用 WebRTC 实现 CameraStream
23 分钟
Updated 2024年11月23日
了解如何使用 CameraStream 特征和 WebRTC 从摄像头流式传输到 Google Nest 显示设备。
监控智能家居的服务中断情况
31 分钟
Updated 2024年11月21日
在此 Codelab 中，您将了解如何为智能家居集成设置自动提醒以检测服务中断情况。
为 Cast 接收器添加实时支持
30 分钟
Updated 2024年11月9日
在此 Codelab 中，您将构建一个使用 Cast Live API 的自定义 Web 接收器应用。
向网络接收器添加 Ad Breaks API 支持
56 分钟
Updated 2024年11月9日
在此 Codelab 中，您将构建一个使用 Cast Ad Breaks API 的自定义网络接收器应用。
调试 Cast 接收器应用
59 分钟
Updated 2024年11月9日
在此 Codelab 中，您将向现有自定义 Web 接收器应用添加 Cast 调试日志记录器。
构建自定义 Web 接收器
1 小时 37 分钟
Updated 2024年11月9日
在此 Codelab 中，您将构建一个自定义 Web 接收器应用，以便在支持 Cast 的设备上播放内容。
让 Android 应用支持 Cast
2 小时 48 分钟
Updated 2024年11月9日
在此 Codelab 中，您将修改现有 Android 视频应用，以便在支持 Google Cast 的设备上投射内容。
使 Web 应用支持 Cast
1 小时 18 分钟
Updated 2024年11月9日
在此 Codelab 中，您将修改现有的网络视频应用，以便在支持 Google Cast 的设备上投射内容。
使 Android TV 应用支持 Cast
1 小时 8 分钟
Updated 2024年11月9日
在此 Codelab 中，您将修改现有 Android TV 应用，以支持从现有的 Cast 发送器应用进行投射和通信。
调试 Matter 集成
36 分钟
Updated 2024年11月6日
了解如何使用分析工具排查 Matter 集成问题，并详细了解开发者支持资源。
构建具备设备权限的 Web 应用
1 小时
Updated 2024年10月13日
在此 Codelab 中，你将学习“设备权限”的运作方式，并构建一个处理身份验证及针对 Nest Thermostat 调用 Smart Device Management API 的 Web 应用。
构建 Android Matter 应用
1 小时 17 分钟
Updated 2024年9月20日
自定义 Matter 的 Google Home 示例应用，以委托和管理设备。
使 iOS 应用支持 Cast
2 小时 28 分钟
Updated 2024年9月11日
在此 Codelab 中，您将修改现有 iOS 视频应用，以在支持 Google Cast 的设备上投射内容。
构建 Matter 设备
1 小时 17 分钟
Updated 2024年8月22日
在此 Codelab 中，您将构建、提交和使用 Matter 设备。
构建 Matter 虚拟设备
1 小时 12 分钟
Updated 2024年8月22日
在此 Codelab 中，您将构建、提交和使用虚拟 Matter 设备。
构建基本 Cast 接收器
Updated 2022年7月29日
在此 Codelab 中，您将使用 Google Cast 应用框架构建支持 Cast 的接收器应用。
学习完 Codelab 后，查看我们的受支持设备列表，以确保您计划集成的设备受 Google Home 生态系统支持。然后，阅读开发者核对清单，了解从创建项目到发布的整个开发流程。
定义
本文档中会用到以下术语：
- 边界路由器
- 一种集线器，用于为启用了 Thread 的设备实现通用 Thread 边界路由器。
- Hub
- 支持的 Google Nest 设备，例如 Google Nest Hub (2nd gen)。若要通过其他 Surface（例如 Assistant、GHA 和智能显示屏）控制启用了 Matter 的设备，则必须使用 hub。
- 支持 Matter 的设备
- 已刷写启用 Matter 的 build 或示例应用的设备或开发板。
- 移动设备
- 用于协助配对的测试手机。目前，这是一款 Android 手机。
前提条件
如需将支持 Matter 的设备与 Google Home 生态系统完全集成，开发者必须满足以下条件：
- 支持 Thread 的 Google 集线器，可同时用作支持 Thread 的设备的边界路由器，以及用于路由智能家居 intent 的本地执行方式路径。
- 满足最低要求的移动设备（测试手机）：
- Android O（8.1、API 级别 27 或更高版本）
- iOS（v16.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) 签发。您需要先验证自己是该 VID 的所有者，然后才能在 Google Home Developer Console 中使用该 VID。完成后，您就可以为该 VID 创建集成。
- 出于开发和 Field Trial 目的，必须在 Developer Console 中创建项目和集成，并使用相应的 VID 和 PID 组合。为设备配置的用户必须是项目成员，或者包含在 Field Trial 用户列表中。
- 只有在您的产品获得 Alliance 认证后，消费者用户才能使用。
一个集成只能使用一次 VID 和 PID。如果您想在集成中使用相同的 VID 或 PID，则需要执行以下操作之一：
- 将使用 VID 或 PID 的集成修改为其他 VID 或 PID。
- 使用 VID 或 PID 删除集成。
| 哪些类型的用户可以将设备委托到 Google Home 生态系统中？ | |||
|---|---|---|---|
| VID 类型 | VID 认证和控制台集成状态 | 正式版
（使用者） |
开发
（开发者、Field Trial 用户） |
| 测试 | Developer Console 中没有集成（无法认证） | ||
| 测试 | Developer Console 中存在集成（无法获得认证） | ||
| 生产 | 未经认证，集成不存在于 Developer Console | ||
| 生产 | 未经认证，集成存在于 Developer Console | ||
| 生产 | 在 Alliance DCL 中获得认证，但在 Developer Console 中不存在集成 | ||
| 生产 | 已通过 Alliance DCL 认证，并且 Developer Console 中存在集成 | ||
产品 ID
系统会从 Matter 基本信息集群读取设备相关信息。设备固件中编码的产品 ID 必须与开发者控制台中 Matter 集成的产品 ID 一致。
不支持的功能
某些 Matter 集群尚未向用户公开，但系统可能会使用这些集群。在大多数情况下，这意味着最终用户无法看到通过这些集群公开的属性：
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ 如需了解这对开关型灯具的影响，请参阅开关型灯具。