#4010·homebridge

在 Matter 的基础上,为桥接 HAP 启用添加公共 API 同步

作者: n0rt0nthec4t创建于 2026年9月9日更新于 2026年9月9日
标签enhancement
  • 现状

Homebridge 2.x 暴露出HAP和Matter的桥平面能动性,但公共API不对称.

已运出的来源 :

  • Server.isHapEnabled( BridgeConfig) 存在于 dest/ server.d.ts 中
  • api.isMatterEnabled () 存在于 dist/ api.d.ts 中

来文方的评论还指出:

  • HAP是“默认的;用户通过bridge.hap.uplied:假的”
  • 物质是“选择进入;桥梁。 物质块必须存在,不能通过桥梁明确禁用。 matter. field: false”

这意味着HAP在桥层配置,但公用插件API只将Matter一面曝光为一等跑时检查.

拟议变动

为 HAP 启用添加相应的公共 API 访问器, 类似于 api. is Matter Enabled () 。

例如:

  • api.isHapEnabled( ):布尔

这将允许插件/平台询问当前桥实例是启用了HAP而无需到达服务器内部,还是重复了桥的配置逻辑.

++ 附加上下文

当前不对称使得插件在决定是创建还是注册 HAP 配件相对于给定桥实例的 Matter 配件时更难做正确的事情.

这在处理下列事项时尤其相关:

  • 主桥与子桥配置
  • 桥型专用启用/失效旗帜
  • 取决于实际桥梁状态而非仅插件配置的运行时间行为

由于HAP实际上就是默认的运输,而物质是选入运输,API应该一致地暴露出两个州.

这不是一个功能性的 HAP 错误;它是一个 API 均等差距,它影响了插件/平台的开发并桥接状态意识.

内容来源: homebridge/homebridge