联犀开发者文档

RTSP-RTMP协议接入

约 2766 字大约 9 分钟

设备接入第三方协议音视频RTSP

2026-08-21

简介

RTSP / RTMP 是联犀平台音视频接入中最轻量的一种方式：无需提前在音视频模块建档，只要设备或流媒体服务提供一路 rtsp://、rtmp:// 或 webrtc:// 流地址，即可完成接入。

平台在「设备接入动态配置」框架中内置了 RTSP-RTMP 协议（与 GB28181、ONVIF 并列，创建产品时在「音视频」协议分组中选择）。接入页提供两种方式：

  • 填写流地址自动接入（quick 模式）：在设备接入页直接填写流地址并保存，平台自动在音视频模块建档设备 + 通道并完成绑定，全程用户无感知；
  • 绑定已有音视频设备：先在「音视频 - 设备管理」中添加 RTSP / RTMP 设备，再到设备接入页选择设备与通道完成绑定。

绑定成功后，可在设备接入页直接进行 WS-FLV / HTTP-FLV 实时预览。

能力边界：RTSP-RTMP 设备仅支持实时预览；PTZ 云台控制与历史回放仅对 GB28181 / ONVIF 设备开放，RTSP-RTMP 设备不支持。

应用场景

  • 快速接入既有摄像机 / NVR：设备已对外提供 RTSP 拉流地址，无需配置 SIP 注册或 ONVIF 探测，填地址即用；
  • 接入流媒体服务或转码源：如通过 ffmpeg 等工具向平台 RTMP 地址推流后，再以 rtmp:// 拉流地址接入预览；
  • 低延迟预览：绑定后通过 WS-FLV / HTTP-FLV 播放实时画面，兼顾兼容性与低延迟，适用于大多数浏览器与内网环境；
  • 测试与临时接入：验证音视频链路、临时演示时，用 quick 模式最快完成设备建档与绑定。

前置条件

  1. 平台音视频能力可用：已部署并启用音视频服务（含媒体服务器），「音视频」菜单可正常访问；
  2. 流地址可达：rtsp:// / rtmp:// / webrtc:// 地址需能被平台媒体服务器访问（拉流由媒体服务器发起，而非浏览器直连）；
  3. 浏览器环境：FLV 预览需要浏览器支持 MediaSource Extensions（MSE），现代浏览器（Chrome、Edge、Firefox、Safari 等）均默认支持；所在网络需能访问流媒体 HTTP 端口（详见注意事项）；
  4. 产品已创建：产品主协议选择「音视频」分组下的 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。页面按设备维度展示「RTSP/RTMP 设备接入配置」，未绑定时提供两种接入方式卡片，绑定后展示绑定信息（音视频设备、通道、传输协议、通道 ID）并在底部提供实时预览区。按需选择以下任一方式接入。

方式一：填写流地址自动接入（quick，推荐）

该方式无需在音视频模块预先建档，是 RTSP-RTMP 接入中最快的路径：

  1. 在「填写流地址自动接入」卡片中填写：
    • 流地址 streamURL：以 rtsp://、rtmp:// 或 webrtc:// 开头的拉流地址（必填）；
    • 设备名称 name：可选，默认取流地址；
  2. 点击「自动接入」，平台保存时自动在音视频模块建档设备 + 通道并完成绑定，用户无感知；
  3. 绑定成功后，页面切换为已绑定状态，展示自动建档的音视频设备、通道、传输协议与通道 ID，并可直接进行实时预览：

自动接入后已绑定

自动建档的音视频设备会以 iot_ 前缀标记；解绑该设备时，若没有其他引用，平台会自动回收（删除）其设备与通道记录。

方式二：绑定已有音视频设备

适用于已在音视频模块中维护好的设备：

  1. 先在「音视频 - 设备管理」中添加 RTSP / RTMP 设备（也可通过设备发现等方式接入）；
  2. 回到设备详情「设备接入」Tab，在「绑定已有音视频设备」卡片中选择音视频设备与通道，点击「确认绑定」。

两种方式任选其一即可；重复保存绑定为幂等操作，会先解绑旧绑定再建立新绑定。

实时预览

绑定成功后，设备接入页提供 WS-FLV / HTTP-FLV 实时预览：点击「开始预览」即可播放实时画面，「停止预览」结束播放。预览基于 FLV over WebSocket / HTTP 协议，无需浏览器插件，兼容主流桌面与移动端浏览器。

绑定后实时预览播放中

预览入口与播放能力统一由音视频服务提供，与接入方式（quick 自动接入或绑定已有设备）无关。

播放协议说明

实时预览默认采用 WS-FLV（WebSocket-FLV）播放，若环境不支持 WebSocket，播放器会自动回退到 HTTP-FLV；浏览器不支持 MSE 或播放器组件不可用时，自动降级为 HLS 兜底播放。与 WebRTC 相比：

对比项WS-FLV / HTTP-FLVWebRTC（旧版）
延迟约 1~3 秒约 200~500 毫秒
浏览器兼容性高（需 MSE，主流浏览器均支持）中（需 WebRTC 支持，部分移动端/企业环境受限）
网络要求HTTP / WebSocket 端口，企业内网通常可通需放行 UDP 媒体端口及 ICE 候选端口
插件依赖无无
适用场景监控预览、普通实时查看对延迟极敏感的双向对讲、远程控制

切换方式：播放协议由设备接入页播放器根据环境与后端返回的播放地址自动选择，用户无需手动切换。若后续版本提供手动切换入口，可在播放器控件或页面设置中选择 WS-FLV / HTTP-FLV / WebRTC。

能力边界

RTSP-RTMP 设备的接入页仅提供实时预览，以下能力仅对 GB28181 / ONVIF 设备开放：

能力GB28181 / ONVIFRTSP-RTMP
WS-FLV / HTTP-FLV 实时预览✅✅
PTZ 云台控制（方向 / 变倍 / 预置位）✅❌ 不支持
历史回放（录像日历 / 录像列表 / 播放）✅❌ 不支持

如需云台控制或历史回放能力，请使用 GB28181 协议接入 或 ONVIF 协议接入接入相应设备。

技术方案

接入架构

RTSP/RTMP 流源 ──拉流──> 媒体服务器（ZLMediaKit） ──WS-FLV/HTTP-FLV──> 浏览器实时预览
   摄像头 / 流媒体服务         平台媒体服务器                 设备接入页 iframe
  • 创建产品选择 RTSP-RTMP 后，产品 / 设备详情的「设备接入」Tab 通过 iframe 渲染音视频服务自托管的接入配置页（由平台反向代理提供，与平台同源）；
  • 绑定关系双向存储：音视频设备记录上保存其绑定的 IoT 产品与设备，IoT 设备侧记录绑定的音视频设备与通道；
  • quick 模式在保存流地址时调用音视频建档接口，自动创建设备（以 iot_ 前缀标记）与通道并完成绑定；
  • 预览链路：点击开始预览后经音视频播放接口获取 WS-FLV / HTTP-FLV 播放地址，由媒体服务器拉取源流并以 FLV 格式转发到浏览器播放。

绑定关系存储

  • 音视频设备记录新增「绑定产品 / 绑定设备」字段（空 = 未绑定），标识该音视频设备绑定到哪个 IoT 设备；
  • IoT 设备侧通过协议配置保存绑定的音视频设备 ID 与通道 ID；
  • quick 自动建档的设备在解绑且无其他引用时被自动回收，避免残留脏数据。

部署说明

RTSP-RTMP 接入无需单独部署协议容器：GB28181 / ONVIF / RTSP-RTMP 三个音视频协议的注册与接入配置页均由音视频服务内嵌托管（随 all-in-one 镜像打包），平台启动时自动完成协议注册，配置页始终可用。

流媒体能力依赖平台媒体服务器（ZLMediaKit），其提供 RTSP / RTMP 拉流与推流入口，以及 WS-FLV / HTTP-FLV / HLS / WebRTC 等多种播放能力，具体监听端口与公网放行策略由部署环境决定（RTSP / RTMP / FLV / WebRTC 及 RTP 接收端口需在部署环境按需放行）。

注意事项

  • 能力边界：RTSP-RTMP 设备不支持 PTZ 云台控制与历史回放，仅提供 WS-FLV / HTTP-FLV 实时预览；
  • quick 设备回收：填写流地址自动建档的设备在解绑时会被自动回收（删除设备与通道记录），重新接入需再次填写流地址；
  • 流地址可达性：拉流由媒体服务器发起，流地址必须是媒体服务器可访问的地址（内网地址需确保媒体服务器与设备 / 流源网络互通）；
  • FLV 网络要求：实时预览基于 HTTP / WebSocket 传输 FLV 流，依赖浏览器 MSE 支持；播放端口为流媒体服务器的 HTTP 入口（经反向代理对外，具体端口以部署配置为准），企业内网一般可直接访问，无需像 WebRTC 那样放行 UDP 媒体端口；
  • 推流密钥：使用 RTMP 推流地址时需携带 secret=<推流密钥> 参数，密钥可在音视频模块设备管理中查看；
  • 地址前缀：仅支持 rtsp://、rtmp://、webrtc:// 三种前缀的流地址。

参考链接

更新日志

2026/8/31 14:31
查看所有更新日志
  • 2fc1c-Merge #36 into master from docs/user-facing-cleanup于
  • eb33f-Merge #35 into master from docs/third-party-protocols-update于
  • 70dbb-Merge #34 into master from docs/third-party-protocols-update于
  • b72ca-Merge #27 into master from docs/av-protocol-access于