RtspViewer 2.1.8

dotnet add package RtspViewer --version 2.1.8
                    
NuGet\Install-Package RtspViewer -Version 2.1.8
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="RtspViewer" Version="2.1.8" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="RtspViewer" Version="2.1.8" />
                    
Directory.Packages.props
<PackageReference Include="RtspViewer" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add RtspViewer --version 2.1.8
                    
#r "nuget: RtspViewer, 2.1.8"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package RtspViewer@2.1.8
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=RtspViewer&version=2.1.8
                    
Install as a Cake Addin
#tool nuget:?package=RtspViewer&version=2.1.8
                    
Install as a Cake Tool

RtspViewer

RTSP 摄像头 WinForms 控件:拖进窗体就出画面,翻一个 IsRecording 属性就录像。纯 C# 拉流 + Windows 自带 Media Foundation 解码/编码/封装——零 FFmpeg、零第三方依赖、零原生二进制,装包即用。

  • 双框架:.NET Framework 4.6.1 与 .NET 8 同包支持,各框架下都只有 一个 RtspViewer.dll(约 160KB),旧版 ffmpeg.exe 方案为 22.8MB
  • 实时预览:RTP/H264 拉流,Media Foundation 硬/软解码,预览帧率可节流,CPU 占用低
  • 三种录制方式:质量档 VBR(默认,体积可小至直通的 1/25)/ 目标码率 CBR / H264 无损直通
  • 录像只动属性:IsRecording = true/false,停止返回时文件已定稿、可直接复制播放;MP4 faststart,系统播放器直接拖放
  • H.265 自动切换:检测到相机流是 H.265 时,自动通过海康 ISAPI 把该通道切回 H.264 再出图(可关闭)
  • 断流自动重连,RTSP 支持 tcp/udp 传输切换
  • 全部为系统组件与 MIT 库,无 GPL 传染

说明:本控件仅解码 H264。H265 相机会被自动切成 H264(海康 ISAPI);非海康品牌需手动在相机里改。

安装

dotnet add package RtspViewer

RtspClientSharp(MIT)的源码直接编入 RtspViewer.dll——源码就在本工程 RtspClientSharp/ 子目录里,直接改、改完 dotnet pack 即出新包。装包后引用目录里只有 RtspViewer.dll 一个文件,无任何原生二进制或其他依赖。

快速开始

using RtspViewer;

var video = new VideoDisplay
{
    Dock = DockStyle.Fill,
    VideoAddress = "rtsp://admin:123456@192.168.1.64:554/Streaming/Channels/102", // 建议用子码流
    RecordDirectory = "Recordings",
    RecordMode = RecordModeKind.Quality,  // 质量档:体积小画质够用;存档用 Direct 直通无损
};
Controls.Add(video);   // AutoStart=true,句柄创建后自动连接

video.IsRecording = true;    // 开始录制
video.IsRecording = false;   // 停止并保存 mp4——同步等到定稿完成才返回,返回后文件即可打开/复制/上传

三种录制方式(RecordMode)

模式 说明 实测体积* CPU 适用
Quality(控件默认) VBR 重编码,按画面运动强度自适应码率:静止时自动降到基准的 25%,行人级运动约 60~80%,剧烈运动拉满 静止 500 KB / 行人 900 KB / 剧烈运动 1.6 MB 中 日常回查(推荐)
Bitrate 解码后按 RecordBitrate 目标码率重编码,可缩放 330 KB(≈335 kbps) 中 需要精确统一码率
Direct H264 码流不解码、不重编码,直接封装进 MP4 4600 KB(≈4700 kbps) 最低 画质无损存档

* 2560x1440 相机、12 秒实测;再编码两档均缩放 0.5(1280x720@15fps)。对照:旧 ffmpeg CRF28 方案静止约 60 KB——Quality 档静止体积约为其 3~4 倍(微软软编在低码率下效率不如 x264),但运动画面不再花屏,且完全脱离 ffmpeg.exe。

本机微软 H264 编码器的 ICodecAPI 为只读(SetValue 返回 E_NOTIMPL),码率控制经输出类型的 MT_AVG_BITRATE 生效;Quality 档的"质量→基准码率"映射按 720p@15fps 标定:q50 基准 ≈1.66Mbps(静止时实际只用约 1/4)、q75≈2.6Mbps、q100≈4.1Mbps。运动检测基于 8x8 亮度块 变化 + 时间并集,传感器噪点不会误触发。要更小体积:调低 RecordQuality / RecordFps / RecordScale。

常用属性

属性 默认 说明
VideoAddress - RTSP 流地址
AutoStart true 控件创建后自动连接
ReconnectInterval 1500 断流重连间隔(ms)
IsRecording false 置 true 开始录制(可在连接前/设计器里设置,流就绪后自动开录);置 false 停止保存——同步等待定稿完成才返回,返回后文件立即可用
RecordMode Quality 录制方式:Quality / Bitrate / Direct
RecordBitrate 400000 Bitrate 模式目标码率(bps)
RecordQuality 50 Quality 模式质量档(1~100)
RecordDirectory Recordings 录像保存目录;相对路径按程序(exe)目录解析,避免宿主进程工作目录不同导致文件写到别处
RecordFileName "" 自定义文件名,空=按时间戳命名;同名覆盖,没带 .mp4 自动补
RecordFps 15 录制帧率(不要超过相机实际帧率)
RecordScale 0.5 录制分辨率缩放,1=原始,0.5=宽高减半(Direct 直通时不缩放)
RecordFaststart true 录制结束把索引(moov)移到文件头,浏览器/播放器可直接拖放播放;超长录像会多一次文件重写,可关闭
PreviewFps 15 预览帧率上限(1~60),越低越省 CPU,不影响录像帧率

控件 Visible=false(含在隐藏的 TabPage 里)或窗口最小化时自动暂停解码与画面更新, CPU 只剩拉流本身(实测 0.1% vs 预览时 1.8%);恢复可见后等下一个关键帧出图(海康相机 通常 1~2 秒内)。任何状态下录像都不受影响:隐藏/最小化时开始、进行、停止录像均正常。 | RtspTransport | tcp | tcp 稳定不花屏(推荐),udp 延迟低 | | AutoSwitchToH264 | true | 检测到相机流是 H.265 时,自动通过海康 ISAPI 把该通道切成 H.264 并重连;非海康地址仅提示不动作 | | IsConnected | - | (只读)是否已连接 | | FrameSize | - | (只读)当前视频分辨率 | | CurrentRecordFile | - | (只读)当前录制文件完整路径 | | LastError | - | (只读)最近一次录制/保存错误信息,无错误为空串 |

事件与方法

video.RecordSaved += (_, path) => Console.WriteLine("已保存: " + path);  // 录像成功保存(UI线程)
video.RecordError += (_, msg)  => Console.WriteLine("录像失败: " + msg);  // 录制/保存失败(UI线程)
video.Snapshot(@"D:\snap\a.jpg");   // 抓取当前画面存 JPG,无画面返回 false

录制失败不再静默:错误会叠加显示在画面左下角,并通过 RecordError 事件 / LastError 属性上报。 停止录制后立刻重新开始会被拒绝(上一段正在封存),画面会提示"上一段录像保存中"。

进一步缩小录像体积

  1. 相机切子码流:海康/大华地址把 Channels/101(主码流)改为 102(子码流,通常 640x360/480p), 直通模式下体积直接降到子码率,且几乎不占 CPU。
  2. 再编码场景用 RecordScale=0.5、降低 RecordFps(12~15)、调小 RecordBitrate 或 RecordQuality。

常见问题

画面花屏/丢帧 保持 RtspTransport=tcp;udp 延迟低但丢包会花屏。

录制停止后文件稍晚才定稿 录像定稿(写 moov)在拉流线程完成,停止录制后约一帧时间(几十~上百 ms)即落盘;程序关闭时会自动兜底定稿。

相机是 H265 不用管。控件检测到 H.265 流会自动通过海康 ISAPI 把该通道切成 H.264 并重连出图(AutoSwitchToH264=false 可关闭,改为仅在画面提示);非海康品牌请在相机设置里手动改 H.264。

许可证说明

  • RtspViewer 控件主体(GreatBear 原创代码):版权所有 (c) GreatBear,允许免费在项目(含商业项目)中引用使用;未经许可不得二次打包、转售或作为控件库再分发(该限制不适用于下述 MIT 部分)。
  • RtspClientSharp 源码(已并入 RtspViewer.dll,含 H.265 识别等修改):版权所有 (c) Kirill Bogdanov,MIT 许可证,该部分权利由 MIT 独立授予。
  • Media Foundation:Windows 系统自带组件,不随包再分发。

完整文本见包内 LICENSE.txt。

Product Compatible and additional computed target framework versions.
.NET net8.0-windows7.0 is compatible.  net9.0-windows was computed.  net10.0-windows was computed. 
.NET Framework net461 is compatible.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETFramework 4.6.1

    • No dependencies.
  • net8.0-windows7.0

    • No dependencies.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on RtspViewer:

Package Downloads
PCHMI

PCHMI工控组态控件,支持Modbus‑TCP、SIEMENS S7、KEYENCE HOSTLINK、PANASONIC MEWTOCOL、MITSUBISHI MC、OPC Ua、MQTT、BECKHOFF ADS、CODESYS V3、AB LogixE/IP、OMRON FINS E/IP等多种PLC通信协议,快速搭建上位机HMI画面。实时数据采集JSON、EXCEL、SQLITE、MYSQL、POSTGRESQL、SQLSERVER等统一数据库操作接口

PCHMI.Core

PCHMI工控组态控件,支持Modbus‑TCP、SIEMENS S7、KEYENCE HOSTLINK、PANASONIC MEWTOCOL、MITSUBISHI MC、OPC Ua、MQTT、BECKHOFF ADS、CODESYS V3、AB LogixE/IP、OMRON FINS E/IP等多种PLC通信协议,快速搭建上位机HMI画面。实时数据采集JSON、EXCEL、SQLITE、MYSQL、POSTGRESQL、SQLSERVER等统一数据库操作接口

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.1.8 267 10/17/2026
2.1.6 120 10/16/2026
2.1.1 119 10/15/2026
2.1.0 120 10/13/2026
1.0.5 146 10/4/2026
1.0.2 130 10/3/2026