Skip to content

品牌适配器:米家 ​

本章对应控制台 「米家」 页面的操作说明。

米家适配器是 Olink 的可选社区品牌适配器之一:把该生态设备纳入 Olink 统一设备模型。是否启用由用户自行决定,不属于平台强制预装能力。设备进入统一模型后,可再按需配置 HomeKit、Matter 等出口;出口与适配器解耦,并非「仅服务于某一品牌 → 某一客户端」的专用桥。

网关管理 ​

扫描与添加网关 ​

通过扫描功能发现局域网内可接入的米家网关类设备,按照向导提示填入必要信息并保存。

扫描网关

授权操作 ​

通过 授权链接 在浏览器中登录米家账号完成授权。授权流程采用米家 Home Assistant 集成方案,需要手动将回调地址输入到指定输入框中。

授权操作

授权成功后浏览器若跳到 olink.homeassistant.local 并提示无法访问 / 网络错误,多为 mDNS 解析不到主机名。请复制地址栏完整回调地址,粘贴到弹窗「手动粘贴回调地址」后确认;或把主机名改成 Olink 的局域网 IP 再粘贴。详见 米家授权后网络错误。

米家回调地址约定端口为 8123,故 Olink 会监听 8123;本机 HA 停掉后常会看到 Olink 占用该端口。与 HA 冲突时可关闭 Olink 的 8123 监听,授权改为手动粘贴回调。见 为何监听 / 接管 8123。

加载设备 ​

从适配器侧同步家庭、房间与设备到 Olink 统一模型。首次连接或设备有大变更后务必执行;否则下游映射与出口(如 HomeKit)看不到最新设备。

加载设备

同步映射规则 ​

只有存在映射规则的设备类型才支持接入 Olink 系统。

映射规则

同步房间 ​

将米家的房间结构同步到 Olink 中,为设备提供空间组织基础。

同步房间

房间管理 ​

  • 与米家 MIoT 家庭 / 房间 数据保持对齐,用于在控制台内按空间组织设备。
  • 当米家侧房间结构发生变化后,建议在网关上再次执行 加载设备 操作,然后检查下游映射是否正确。

映射管理 ​

与融合中枢一致,存在两层关系(适配器与出口解耦):

  1. 适配器设备 → Olink 设备/实体:在映射管理中维护,决定是否纳入统一设备模型及服务能力。
  2. Olink 设备 → 出口配件(如 HomeKit):在对应出口页添加配件,或通过 TOML 声明服务与特征。

设备可见性排查 ​

若某设备在「接入设备」或出口客户端中不可见,请依次检查:

  • 是否已加载:确认设备已从适配器同步到 Olink
  • 映射是否启用/完整:检查设备映射规则是否正确配置
  • 该型号是否在支持范围内:可结合适配器调试能力查看属性读写是否正常

本适配器接入流程 ​

  1. 同步房间:建议先将适配器侧房间结构同步到 Olink
  2. 加载设备:同步设备到统一模型
  3. 检查映射规则:确保设备类型有对应的映射规则
  4. 验证接入状态:确认可在「接入设备」页查看
  5. 配置出口(可选):例如在 HomeKit 页为已接入设备添加配件(摄像头请走单配件流程,见 摄像头)

云端偶发标离线导致出口客户端无响应时,可在设备 接入配置 中设 force_online = true(一直在线)。见常见问题 设备常离线问题。

适配器设备接入