RTSP-RTMP协议接入
简介
RTSP / RTMP 是联犀平台音视频接入中最轻量的一种方式：无需提前在音视频模块建档，只要设备或流媒体服务提供一路 rtsp://、rtmp:// 或 webrtc:// 流地址，即可完成接入。
平台在「设备接入动态配置」框架中内置了 RTSP-RTMP 协议（与 GB28181、ONVIF 并列，创建产品时在「音视频」协议分组中选择）。接入页提供两种方式：
- 填写流地址自动接入（quick 模式）：在设备接入页直接填写流地址并保存，平台自动在音视频模块建档设备 + 通道并完成绑定，全程用户无感知；
- 绑定已有音视频设备：先在「音视频 - 设备管理」中添加 RTSP / RTMP 设备，再到设备接入页选择设备与通道完成绑定。
绑定成功后，可在设备接入页直接进行 WebRTC 实时预览。
能力边界：RTSP-RTMP 设备仅支持实时预览；PTZ 云台控制与历史回放仅对 GB28181 / ONVIF 设备开放，RTSP-RTMP 设备不支持。
应用场景
- 快速接入既有摄像机 / NVR：设备已对外提供 RTSP 拉流地址，无需配置 SIP 注册或 ONVIF 探测，填地址即用；
- 接入流媒体服务或转码源：如通过
ffmpeg等工具向平台 RTMP 地址推流后，再以rtmp://拉流地址接入预览； - 低延迟预览：支持
webrtc://前缀的 WebRTC 流地址，适用于对实时性要求较高的场景； - 测试与临时接入：验证音视频链路、临时演示时，用 quick 模式最快完成设备建档与绑定。
前置条件
- 平台音视频能力可用：已部署并启用音视频服务（含媒体服务器），「音视频」菜单可正常访问；
- 流地址可达：
rtsp:///rtmp:///webrtc://地址需能被平台媒体服务器访问（拉流由媒体服务器发起，而非浏览器直连）； - 浏览器环境：WebRTC 预览需要浏览器支持 WebRTC，且所在网络可访问媒体端口（详见注意事项）；
- 产品已创建：产品主协议选择「音视频」分组下的
RTSP-RTMP。
产品配置
1. 创建产品
在设备管理 - 产品中创建产品，主协议选择「音视频」分组下的 RTSP-RTMP，按需完善产品名称、品类等信息，创建成功后即可进入产品详情：
2. 产品接入说明
进入产品详情「设备接入」Tab，平台按协议渲染 RTSP / RTMP 接入说明页，内容包括两种接入方式的说明，以及流地址格式规则：
说明页给出的地址规则如下：
- RTSP 拉流地址格式：
rtsp://<设备IP>:<端口>/<路径>，例如rtsp://192.168.1.100:554/Streaming/Channels/101； - RTMP 推流地址规则：
rtmp://<服务器>/live/<stream>?secret=<推流密钥>，其中<服务器>为音视频服务媒体服务器地址，<stream>为自定义流名，<推流密钥>为推流鉴权密钥（在音视频模块的设备管理中可查看）。
设备接入
在产品下创建 IoT 设备后，进入设备详情「设备接入」Tab，按需选择以下任一方式接入。
方式一：填写流地址自动接入（quick，推荐）
该方式无需在音视频模块预先建档，是 RTSP-RTMP 接入中最快的路径：
- 在「填写流地址自动接入」卡片中填写：
- 流地址 streamURL：以
rtsp://、rtmp://或webrtc://开头的拉流地址（必填）； - 设备名称 name：可选，默认取流地址；
- 流地址 streamURL：以
- 点击「自动接入」，平台保存时自动在音视频模块建档设备 + 通道并完成绑定，用户无感知；
- 绑定成功后，页面切换为已绑定状态，展示自动建档的音视频设备、通道、传输协议与通道 ID，并可直接进行实时预览：
自动建档的音视频设备会以
iot_前缀标记；解绑该设备时，若没有其他引用，平台会自动回收（删除）其设备与通道记录。
方式二：绑定已有音视频设备
适用于已在音视频模块中维护好的设备：
- 先在「音视频 - 设备管理」中添加 RTSP / RTMP 设备（也可通过设备发现等方式接入）；
- 回到设备详情「设备接入」Tab，在「绑定已有音视频设备」卡片中选择音视频设备与通道，点击「确认绑定」。
两种方式任选其一即可；重复保存绑定为幂等操作，会先解绑旧绑定再建立新绑定。
实时预览
绑定成功后，设备接入页提供 WebRTC 实时预览：点击「开始预览」即可播放实时画面，「停止预览」结束播放。预览采用 WebRTC 协议，延迟低、无需插件，浏览器原生支持。
预览入口与播放能力统一由音视频服务提供，与接入方式（quick 自动接入或绑定已有设备）无关。
能力边界
RTSP-RTMP 设备的接入页仅提供实时预览，以下能力仅对 GB28181 / ONVIF 设备开放：
| 能力 | GB28181 / ONVIF | RTSP-RTMP |
|---|---|---|
| WebRTC 实时预览 | ✅ | ✅ |
| PTZ 云台控制（方向 / 变倍 / 预置位） | ✅ | ❌ 不支持 |
| 历史回放（录像日历 / 录像列表 / 播放） | ✅ | ❌ 不支持 |
如需云台控制或历史回放能力，请使用 GB28181 协议接入 或 ONVIF 协议接入接入相应设备。
接入验证
在联犀测试环境完成端到端验证，流程与结果如下：
- 创建主协议为 RTSP-RTMP 的产品，产品创建成功（见上文产品配置章节截图）；
- 在产品下创建 IoT 设备，进入设备详情「设备接入」Tab；
- 填写
rtsp://拉流地址并「自动接入」，平台自动建档设备与通道并完成绑定； - 页面切换为已绑定状态，展示自动建档设备信息，可发起 WebRTC 实时预览。
| 验证项 | 状态 | 详情 |
|---|---|---|
| 产品创建 | ✅ 成功 | 主协议 RTSP-RTMP，产品创建成功 |
| 自动建档绑定 | ✅ 成功 | 填写流地址保存后自动建档设备 + 通道并绑定 |
| 绑定信息展示 | ✅ 可见 | 页面展示自动建档设备名称、通道、传输协议 |
| WebRTC 实时预览 | ✅ 可用 | 绑定后可直接发起实时预览 |
技术方案
接入架构
RTSP/RTMP 流源 ──拉流──> 媒体服务器（ZLMediaKit） ──WebRTC──> 浏览器实时预览
摄像头 / 流媒体服务 平台媒体服务器 设备接入页 iframe- 创建产品选择 RTSP-RTMP 后，产品 / 设备详情的「设备接入」Tab 通过 iframe 渲染音视频服务自托管的接入配置页（由平台反向代理提供，与平台同源）；
- 绑定关系双向存储：音视频设备记录上保存其绑定的 IoT 产品与设备，IoT 设备侧记录绑定的音视频设备与通道；
- quick 模式在保存流地址时调用音视频建档接口，自动创建设备（以
iot_前缀标记）与通道并完成绑定； - 预览链路：点击开始预览后经音视频播放接口发起 WebRTC 会话，由媒体服务器拉取源流并转发到浏览器，信令与媒体通道均为平台内建能力。
绑定关系存储
- 音视频设备记录新增「绑定产品 / 绑定设备」字段（空 = 未绑定），标识该音视频设备绑定到哪个 IoT 设备；
- IoT 设备侧通过协议配置保存绑定的音视频设备 ID 与通道 ID；
- quick 自动建档的设备在解绑且无其他引用时被自动回收，避免残留脏数据。
部署说明
RTSP-RTMP 接入无需单独部署协议容器：GB28181 / ONVIF / RTSP-RTMP 三个音视频协议的注册与接入配置页均由音视频服务内嵌托管（随 all-in-one 镜像打包），平台启动时自动完成协议注册，配置页始终可用。
流媒体能力依赖平台媒体服务器（ZLMediaKit），其提供 RTSP / RTMP 拉流与推流入口、WebRTC 播放等能力，具体监听端口与公网放行策略由部署环境决定（RTSP / RTMP / WebRTC 及 RTP 接收端口需在部署环境放行）。
注意事项
- 能力边界：RTSP-RTMP 设备不支持 PTZ 云台控制与历史回放，仅提供 WebRTC 实时预览；
- quick 设备回收：填写流地址自动建档的设备在解绑时会被自动回收（删除设备与通道记录），重新接入需再次填写流地址；
- 流地址可达性：拉流由媒体服务器发起，流地址必须是媒体服务器可访问的地址（内网地址需确保媒体服务器与设备 / 流源网络互通）；
- WebRTC 网络要求：实时预览依赖浏览器 WebRTC 能力与媒体端口连通性，部分网络会阻断 UDP 媒体端口导致无法播放，需在部署环境放行 WebRTC 信令与媒体端口（TCP + UDP）；
- 推流密钥：使用 RTMP 推流地址时需携带
secret=<推流密钥>参数，密钥可在音视频模块设备管理中查看； - 地址前缀：仅支持
rtsp://、rtmp://、webrtc://三种前缀的流地址。
参考链接
更新日志
2026/8/22 01:02
查看所有更新日志
bdb19-于
