在 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