集成：MQTT 与 Home Assistant

MQTT 发布

Rerinku View 可以把事件发到你自己的 MQTT 服务器（Home Assistant 自带的 Mosquitto、Node-RED、你的自动化系统等），主题沿用 Frigate 的习惯。Rerinku View 作为客户端去连你的服务器；它内置给设备用的 MQTT 服务不对第三方开放。

在 设置 → 通知 → MQTT 发布 里开启，默认关闭：

设置	说明
地址	支持 tcp://、mqtt://、ssl://、tls://、mqtts://、ws://、wss://，如 tcp://192.168.1.10:1883
用户名 / 密码	可选。密码加密保存，保存后不再显示
主题前缀	默认 rerinku，不能包含 + 或 #

主题

以下用默认前缀 rerinku 举例：

主题	内容	保留
rerinku/available	online 或 offline；Rerinku View 断线时由遗嘱消息置为 offline	是
rerinku/events	每次事件变化一条 JSON（见下）	否
rerinku/<摄像头>/<种类>	这类事件进行中为 ON，结束为 OFF	是
rerinku/<摄像头>/<类别>	画面里这类目标的当前数量，如 rerinku/前门/person → 2；事件结束归 0	是

• <摄像头> 是摄像头名称转成小写、空格换成短横线后的结果，中文等文字会保留；转换后为空时用 device-<id>。
• <种类> 是 object（AI 识别）、motion（移动侦测）、tampering（遮挡/破坏）、image-quality、digital-input、digital-output、audio-alarm 或 unknown。除了 AI 识别，摄像头自己上报的告警也会发布。
• 消息以 QoS 1 发送。保留主题的最新状态即使在断线期间也一直记着，每次连上都会整份重发；events 是实时流，断线期间的不补发。

rerinku/events 的消息：

{
  "type": "new",
  "id": 1842,
  "camera": "前门",
  "device_id": 3,
  "device_name": "前门",
  "kind": "object",
  "labels": ["person"],
  "faces": ["小明"],
  "score": 0.91,
  "zones": [],
  "has_snapshot": true,
  "start_time": 1793000000,
  "end_time": null
}

type 依次为 new、update、end；时间是 Unix 秒，事件未结束时 end_time 为 null。

需要注意：两台同名的摄像头会落到同一个主题上；摄像头改名后，旧名字的保留消息会留在服务器上，需要的话自己清掉。和 Frigate 相比，目前没有快照主题，也没有 Home Assistant 的 MQTT 自动发现。

Home Assistant

Rerinku View 的 Home Assistant 集成把每台摄像头接入 Home Assistant，需要 Home Assistant 2026.9.0 或更高。

安装

1. 从集成仓库下载，把其中的 custom_components/rerinku 整个目录复制到 Home Assistant 配置目录的 custom_components/ 下。
2. 重启 Home Assistant。
3. 在 设置 → 设备与服务 → 添加集成 里搜索 Rerinku，填入 Rerinku View 的地址即可完成绑定。

提供的实体

每台摄像头会生成：

实体	说明
camera	快照用 Rerinku View 的缩略图；实时画面用 Home Assistant 原生的 WebRTC 播放，直接连 Rerinku View
binary_sensor × 5	移动侦测、目标检测、有人、有车、有宠物。「有人」带 recognized 属性，列出认出的人

状态通过 WebSocket 实时推送，另外每 60 秒对账一次。

限制

• Rerinku View 设了访问密码时，集成目前无法连接。
• H.265 的摄像头不会转码，Home Assistant 所在的浏览器不支持 H.265 的 WebRTC 解码时看不到画面。
• 集成里没有录像开关，也不能回放。
• 2026 年 10 月之前接入的 Rerinku View 升级后，设备的序列号格式统一了，Home Assistant 里会生成一批新实体，旧实体需要手动删除。