Olink 文档

Matter 桥接（Beta） ​

Beta 版本

Matter 桥接目前为 Beta（实验性） 功能，接口、配置方式与支持的设备范围可能在不另行通知的情况下发生变化。生产环境请谨慎启用，并优先使用已稳定的 HomeKit（HAP）桥接。

概述 ​

Olink 除支持 HomeKit（HAP）外，同时提供 Matter 桥接（Beta） 能力：将米家（MIoT）设备桥接为一个 Matter Bridge（桥设备），从而被支持 Matter 的生态（如 Apple 家庭、Google Home、Amazon Alexa、SmartThings 等）发现并控制。

MIoT 设备 ──→ Olink 映射引擎 ──→ Matter Bridge ──→ Matter 生态（Home / Google / Alexa …）

与 HAP 类似，Matter 同样复用 Olink 的「输入层 → Schema 层 → 输出层」三层映射，区别仅在最末的输出层由 HAP 特征声明改为 Matter Cluster/Attribute 声明。

启用 Beta 特性 ​

Matter 桥接默认可能未开启，需在服务配置中显式启用（具体开关名与路径以当前控制台/配置文件版本为准）：

  1. 确认所用 Olink 版本已包含 Matter 支持（参考 设备映射管理 中的输出层说明）。
  2. 在配置中开启 Matter 桥接相关开关并重启服务。
  3. 在控制台「映射管理」中确认目标设备已映射到 Matter 输出层。

若界面中未出现 Matter 相关入口，说明当前构建未启用该 Beta 模块，请升级或重新编译对应版本。

配网（Commissioning） ​

Matter 设备通过 配网码（Pairing Code）或二维码 完成接入，流程与 HomeKit 类似但协议不同：

  1. 在 Olink 控制台获取 Matter 桥的 配网码 / QR 码（通常为 11 位或 21 位数字，或对应的二维码）。
  2. 在目标生态 App（如 Apple「家庭」）中选择「添加配件 / 扫描二维码」。
  3. 扫描或输入配网码，完成 Commissioning。
  4. 配对成功后，桥下挂载的米家设备将出现在对应生态中。

支持的设备类型 ​

Matter 桥接当前支持的设备类型与 HAP 大体对应，常见包括：

  • 灯（On/Off、调光、色温/颜色）
  • 开关 / 插座（On/Off）
  • 窗帘 / 窗覆盖（Window Covering）
  • 传感器（运动、接触、温湿度、光照等）
  • 门锁（Door Lock，部分）

具体支持范围随版本演进，请以控制台实际可映射的类型为准。

已知限制 ​

  • Beta 状态：行为不保证稳定，升级可能改变映射或配网方式。
  • 桥而非直连：Olink 以「桥」的形式暴露设备，部分生态对桥下子设备的自动化能力有限制。
  • 实时性：设备状态依赖米家侧上报与 Olink 缓存，极端网络下可能存在延迟。
  • OTA / 固件：Matter OTA 等高级能力当前一般不在桥接范围内。

相关文档 ​