文档目录

接入摄像头

本页内容

Rerinku View 支持六种接入方式。前四种在控制台里添加；后两种由设备自己连上来，自动出现在设备列表里。

方式	适合	怎么添加
ONVIF	大多数网络摄像头	自动发现，或手动填 IP
RTSP	只提供 RTSP 地址的摄像头、录像机、流媒体服务	手动填地址
国标（GB28181）	国标摄像头和录像机	设备注册到 Rerinku View，再从发现列表添加
USB（UVC）	接在 Rerinku View 主机上的 USB 摄像头（仅 Linux）	自动发现
Rerinku View SDK	用 SDK 开发固件的设备	设备注册后自动出现
Rerinku Cam	安卓手机	在 App 里连接后自动出现

发现与添加

打开侧栏的设备，内容区上方有两个按钮：

发现设备：Rerinku View 在后台持续扫描局域网。ONVIF 摄像头每 10 秒探测一次，国标设备注册后会列出它的通道，Linux 上接入的 USB 摄像头即插即见。新设备出现时，页面上还会弹出「发现新设备」卡片。
手动添加：自动发现不到的设备（比如在另一个网段），在这里填写信息添加。

在发现列表里点「添加」，填写账号密码（国标和 USB 不需要），可以顺便选一个分组。添加时 Rerinku View 会实际连接一次设备来验证，信息不对会直接提示。点「忽略」的设备之后不会再提醒。

手动添加需要：IP 地址、端口（默认 80）、用户名（默认 admin）和密码。添加后，Rerinku View 会读出摄像头的所有码流（每个 ONVIF 配置算一路），并自动支持它的云台。

ONVIF 自动发现依赖局域网组播（UDP 3702）。跨网段、关闭了组播的网络，或者 Rerinku View 运行在 macOS / Windows 的 Docker Desktop 里时，摄像头不会被自动发现，请手动添加。
主机防火墙可能拦截发现的回包；发现不到时先检查防火墙。

填写完整的 rtsp:// 或 rtsps:// 地址。账号和密码请填在单独的字段里，不要写进地址，写进地址的会被拒绝。

RTSP 设备没有在线状态、命令和云台：Rerinku View 只是拉流，缩略图也靠拉流截帧。能用 ONVIF 的摄像头建议用 ONVIF 添加。

Rerinku View 内置了国标平台（SIP 服务器）。首次启动生成的配置文件默认开启了它，监听 5060 端口，注册密码是 change-me，接入设备前请先修改密码，不用国标就把它关掉。

录像机（NVR）本身不会出现在列表里，要添加的是它下面的各个通道。媒体收流方式默认是自动：2022 版的设备走 TCP，其余走 UDP，媒体端口是随机分配的。5060 端口被其他程序占用时，国标平台无法启动，设置页会显示「监听未运行」。

只支持 Linux。摄像头需要能输出 H.264、H.265 或 MJPEG，只能输出原始画面（YUYV、NV12）的摄像头不支持。默认采集 1280×720 / 30 帧，同一台设备上的麦克风会自动匹配为音频源。

运行 Rerinku View 的用户需要在 video 组里（sudo usermod -aG video 用户名）；Docker 里需要把设备传进容器（--device /dev/video0）。
同一个 USB 摄像头同时只能被一个程序打开：正在看画面时刷新缩略图会失败，界面会继续显示上一张。

用 Rerinku View SDK 开发的设备主动向 Rerinku View 注册，注册成功就出现在设备列表里，不需要在控制台添加。设备需要能访问 Rerinku View 的 8080 端口和 1883 端口（MQTT）。

默认任何设备都可以注册。要限制只有你的设备能接入，在配置里设置设备密钥 DEVICE_KEY，见配置参考。

在旧手机上安装 Rerinku Cam，填写 Rerinku View 的地址，或扫描 设置 → 快速连接 → 手机 App 里的二维码。第一次连上后，它会以 RLIVE-… 开头的名字出现在设备列表里。Rerinku View 设置了设备密钥时，在 App 的设置里填上即可。

多路码流。 ONVIF 摄像头的每个配置算一路码流，通常有主码流和子码流。实时画面默认播放 H.264 码流里分辨率最高的那一路；播放器的「画质」菜单可以切换。RTSP、USB、国标设备都只有一路。

编码	实时画面	说明
H.264	直接转发	几乎不占 CPU，所有浏览器都能播
H.265	直接转发	需要浏览器支持 WebRTC 的 H.265 解码（Safari 支持，Chrome 需要硬件解码）。不支持时会提示换 H.264 码流
MJPEG	转成 H.264	每台设备一个转码进程，占用 CPU
其他（如 MPEG-4）	不支持

声音：Opus 和 8 kHz 单声道的 G.711 直接转发，AAC 等其他格式转成 Opus；录像里的声音统一保存为 AAC。

主码流是 H.265、子码流是 H.264 的摄像头，实时画面默认会选 H.264 的那一路，可能是子码流，画面会比较模糊。浏览器支持 H.265 时，可以在「画质」里切回主码流。

设备页列出所有设备，可以搜索、改分组、开关录像。每一行末尾的菜单里有：录像回放、设备日志、重新读取设备信息、命令和删除设备。

分组：添加设备时或在设备设置里选择分组，输入新名字即可新建分组。目前不能改名或删除分组。

设备详情：点设备名进入详情页。

左侧是画面，下面是在线时长、当前观看人数、网络延迟、设备信息和通道。用 Rerinku View SDK 接入的设备还会显示温度、CPU 等运行状态。
右侧的标签：
- 设置：名称、描述、分组、录像、智能检测；ONVIF 和 RTSP 设备可以修改账号密码（会先用新密码连一次设备，设备拒绝就不保存）。
- 命令：ONVIF 和国标设备的标准命令，Rerinku View SDK 设备的内置和自定义命令。
- 日志：设备的连接和操作记录。
协议支持时，标题栏有「重启」按钮。

删除设备不会删除它的录像，录像会按存储策略到期清理。

ONVIF 和国标设备支持云台。云台控制在画面右边缘的抽屉里，默认收起，实时画面墙的每一格和设备详情页的画面都有：

浏览器断开时云台会在 3 秒内自动停下，不会一直转。