请注意！新的开发者预览版计划即将推出。点击此处申请，抢先试用新工具并提供反馈。

开始使用 Matter

  开发者预览版  

借助 Google 的 Home 开发者计划，设备制造商可以将他们的智能家居设备与 Google Home 生态系统连接起来。我们将扩展智能家居 Action 本地执行方式路径，使其能够使用 Google Home app (GHA) 添加支持 Matter 的设备进行设置，并使用 Google Assistant、GHA 或 Google Nest Hub (2nd gen) 等智能显示屏控制这些设备。

本文档介绍了如何开始在 Google Home 生态系统中构建和集成支持 Matter 的平台。

免责声明

关于此开发者预览版 Matter 中描述的过程，请注意以下事项：

  • 用于开发的帐号应仅连接一个支持 Matter 的 hub 以进行测试。如果有多个支持 Matter 的 hub 在同一时间连接或连接到同一结构，可能会导致不可预测的行为。
  • 所有过程都假定使用运行 Ubuntu 20.04 的 Linux 机器来构建和刷写经过 Google 测试的 Matter 示例。虽然系统支持 MacOS 计算机，但建议使用 Linux。您可以根据需要在程序中列出特定于 Mac 的说明。

定义

本文档中会用到以下术语：

边界路由器
为支持 Thread 的设备实现通用 Thread 边界路由器的 hub。
Hub
受支持的 Google Nest 设备，例如 Google Nest Hub (2nd gen)。 需要有一个 hub 才能通过其他 surface（例如 Assistant、GHA 和智能显示屏）控制支持 Matter 的设备。
支持Matter的设备
一个设备或开发板，刷入了启用了 Matter 的 build 或示例应用。
移动设备
用于辅助配对的测试手机。目前是“Android”座机。

前提条件

推荐用于 Matter 开发的 IDE 扩展程序

若要将支持 Matter 的设备与 Google Home 生态系统完全集成，开发者必须：

  1. 具有 Thread 支持的 Google Hub，可用作支持 Thread 的设备的边界路由器，以及充当智能家居 intent 路由的本地执行方式路径。
  2. 满足最低要求的移动设备（测试手机）：
    • Android O（8.1，API 级别 27 或更高版本）
    • iOS（v16.5 或更高版本）
    • BLE 功能
  3. 已启用 Matter 的设备的供应商 ID (VID) 和产品 ID (PID)。
  4. 一台支持 Matter 的设备。此设备应为 Google Home 生态系统目前支持的 Matter 设备类型之一，可以是：
    • 您自己的产品（具有支持 Matter 的固件）。
    • 受支持的供应商平台的开发板，可用作支持 Matter 的设备进行端到端验证。支持以下平台：
表：Matter芯片供应商的示例
供应商 平台 指南 Thread 支持
布法罗实验室 BL602 快速入门
BL702 快速入门
埃斯普利夫 ESP32 快速入门
OTA 测试
北欧半导体 nRF52840 丹麦克朗 快速入门
OTA 测试
荷兰盾 IOTZTB-DK006 开发套件 快速入门
Realtek Ameba D 系列 快速入门
Silicon Labs EFR32MG24 开发套件 快速入门
EFR32MG Zigbee 和 Thread Starter Kit 快速入门
特林克 TLSR9518 快速入门
德克萨斯乐器 CC2652R7 LaunchPad 开发套件 快速入门

供应商 ID

默认情况下，您可以使用 CSA 分配的其中一个 VID 进行测试。选择以下其中一项：0xFFF1、0xFFF2、0xFFF3、0xFFF4。

若要使用正式版 VID，您的集成可以获得认证并发布，您必须先经过 Google 验证，以确保 CSA 向您签发该 VID。

此 VID 应在设备的固件中实现。

只有在特定供应商 ID 和设备类型场景中，Matter 设备才能在 Google Home 生态系统中配对。

  • 测试 VID 无法在消费类设备上使用。
  • 您的正式版 VID 必须由 CSA 签发。Google 会先验证您是该 VID 的所有者，然后您才能在 Google Home Developer Console 中使用此 VID。完成后，您将能够为该 VID 创建集成。
  • 出于开发和现场试验的目的，必须在 Developer Console 中创建项目并将其与相应的 VID 和 PID 组合集成。调试设备的用户必须是项目的成员，或者属于现场试验用户列表。
  • 消费者产品只有在 CSA 认证后才能使用。
表：供应商 ID (VID) 和设备类型配对场景
哪些类型的用户可以委托设备加入 Google Home 生态系统？
VID 类型 VID 认证和控制台集成状态 正式版
（消费者用户）		 开发
（开发者、现场试验用户）
测试 “Developer Console”中无集成（无法认证）
测试 集成存在于 Developer Console 中（无法认证）
正式版 未经认证，Developer Console 中不存在集成
正式版 未经认证，集成存在于 Developer Console 中
正式版 已通过 CSA DCL 认证，Developer Console 中不存在集成
正式版 已通过 CSA DCL 认证，Developer Console 中存在集成

产品 ID

系统会从 Matter 基本信息集群读取设备的相关信息。设备固件中编码的产品 ID 必须与开发者控制台中 Matter 集成的产品 ID 一致。

不支持的功能

某些 Matter 集群尚未向用户公开，但可供系统使用。在大多数情况下，这意味着最终用户不会看到通过这些集群公开的属性：

表：Matter 未向 Google Home 生态系统中的用户公开的集群
集群类型 集群
Core
  • 装订 1
  • 标签
  • 固定标签
  • 用户标签
  • 操作
  • 组键
  • 本地化配置
  • 时间格式本地化
  • 单元本地化
  • 电源配置
  • 电源
  • 诊断集群（诊断日志、常规诊断、软件诊断、线程网络诊断、Wi-Fi 网络诊断、以太网网络诊断）
  • 时间同步
  • 模式选择
应用
  • 无法直接支持群组和场景。您可以通过日常安排获得等效功能。
  • 所有媒体集群。您可以通过 Google Cast 获得等效功能。

1 请参阅开启/关闭灯开关，了解这对开启/关闭灯开关有何影响。

下一页
开发者核对清单