Matter SDK 开发指南

从 Android 到 iOS 再到 Web,逐平台解析 Matter SDK 的架构、核心 API 和上手路径。

3 个平台·配网 · 控制 · 限制

Android

基于 Google Play Services 的两层配网架构

SDKHome APIs + connectedhomeip
成熟度GA (生产就绪)
规范版本Matter 1.4.1
最低版本Android 8.1+ (API 27)

Home APIs 提供配网 + 控制 + 自动化的统一 API

查看详情

iOS

系统原生框架,MatterSupport 扩展接入

SDKMatter.framework + MatterSupport
成熟度成熟 (第 4 个 OS 周期)
规范版本Matter 1.4+
最低版本iOS 16.1+

系统级配网 UI,无需额外依赖

查看详情

Web / Node.js

浏览器通过 WebSocket 代理,Node.js 全功能控制

SDKmatter.js + matterjs-server
成熟度生产可用 (Home Assistant 已采用)
规范版本Matter 1.4.2 — 1.6
最低版本Node.js 20.19+

Open Home Foundation 维护的纯 TypeScript 实现

查看详情

平台对比

三个平台的 Matter 接入链路:Android 经 Home APIs 和 connectedhomeip,iOS 经 MatterSupport 和 Matter.framework,Web 经 WebSocket 和 Node.js 上的 matter.js,最终都到达 Matter 设备
从 App 到设备,三个平台各经过哪些软件层
特性AndroidiOSWeb / Node.js
配网能力完整 (GPS 代理)完整 (系统 UI)仅服务端 (浏览器不支持)
设备控制Home APIs / Cluster 直调MTRBaseCluster / MTRDeviceWebSocket 代理 / 直接 Cluster
Thread 支持GPS Thread SDK需要 HomePod/Apple TVmatter.js 原生支持
最低版本Android 8.1 (API 27)iOS 16.1Node.js 20.19
外部依赖Google Play Services (必需)无 (系统内置)无 (纯 JS)
开源可控connectedhomeip 可选Matter.framework 闭源matter.js 全开源