tsightler/ring-mqtt

ring-mqtt

镜像概述和主要用途

ring-mqtt是一个基于https://github.com/dgreif/ring%E5%BC%80%E5%8F%91%E7%9A%84%E8%84%9A%E6%9C%AC%EF%BC%8C%E6%8F%90%E4%BE%9BMQTT%E5%8D%8F%E8%AE%AE%E4%B8%8ERing%E5%85%AC%E5%8F%B8%E4%BA%A7%E5%93%81%EF%BC%88%E5%A6%82%E6%91%84%E5%83%8F%E5%A4%B4%E3%80%81%E6%8A%A5%E8%AD%A6%E8%AE%BE%E5%A4%87/%E4%BC%A0%E6%84%9F%E5%99%A8%E5%8F%8A%E6%99%BA%E8%83%BD%E7%85%A7%E6%98%8E%EF%BC%89%E4%B9%8B%E9%97%B4%E7%9A%84%E6%A1%A5%E6%8E%A5%E5%8A%9F%E8%83%BD%E3%80%82%E5%85%B6%E4%B8%BB%E8%A6%81%E8%AE%BE%E8%AE%A1%E7%9B%AE%E6%A0%87%E6%98%AF%E6%94%AF%E6%8C%81%E4%B8%8EHome Assistant的简单集成（支持Home Assistant风格的MQTT发现机制），同时也可兼容任何支持MQTT协议的工具，通过基于位置/设备ID和传感器类型的一致主题命名规则实现设备交互。

核心功能和特性

• 多产品支持：兼容Ring摄像头、报警设备/传感器及智能照明等产品
• Home Assistant集成：原生支持Home Assistant的MQTT发现机制，可实现自动集成
• 通用MQTT兼容性：适用于任何支持MQTT协议的工具，不局限于特定平台
• 标准化主题命名：采用基于位置/设备ID和传感器类型的统一主题命名规则，确保交互一致性

使用场景和适用范围

• Home Assistant用户：需将Ring设备集成到智能家居系统中的用户，通过MQTT实现设备状态监控与控制
• MQTT工具用户：使用第三方MQTT客户端或自动化工具的用户，可通过本镜像与Ring设备交互
• 多平台集成场景：需要在不同系统间统一管理Ring设备的场景

重要升级说明（4.0版本）

4.0版本对主题层级进行了调整，采用更简洁的格式以适配新版Home Assistant设备模型。Home Assistant用户无需额外操作，发现机制会自动处理新主题层级；使用其他MQTT工具的用户需根据新主题规则调整配置。各设备及传感器的新主题格式详见https://github.com/tsightler/ring-mqtt/blob/master/docs/TOPICS.md%E6%96%87%E6%A1%A3%E3%80%82

完整文档与支持

获取完整使用文档或报告问题，请访问https://github.com/tsightler/ring-mqtt%E3%80%82