RtspViewer 2.1.6
See the version list below for details.
dotnet add package RtspViewer --version 2.1.6
NuGet\Install-Package RtspViewer -Version 2.1.6
<PackageReference Include="RtspViewer" Version="2.1.6" />
<PackageVersion Include="RtspViewer" Version="2.1.6" />
<PackageReference Include="RtspViewer" />
paket add RtspViewer --version 2.1.6
#r "nuget: RtspViewer, 2.1.6"
#:package RtspViewer@2.1.6
#addin nuget:?package=RtspViewer&version=2.1.6
#tool nuget:?package=RtspViewer&version=2.1.6
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(控件默认) |
按 RecordQuality(1~100) 映射目标码率的 VBR 重编码 |
170 KB(≈175 kbps) | 中 | 日常回查(推荐) |
Bitrate |
解码后按 RecordBitrate 目标码率重编码,可缩放 |
330 KB(≈335 kbps) | 中 | 需要精确统一码率 |
Direct |
H264 码流不解码、不重编码,直接封装进 MP4 | 4600 KB(≈4700 kbps) | 最低 | 画质无损存档 |
* 2560x1440 相机、8 秒实测;再编码两档均缩放 0.5(1280x720@15fps)。对照:旧 ffmpeg CRF28 方案约 60 KB(≈70 kbps)——Quality 档体积约为其 2~3 倍(微软软编在低码率下效率不如 x264),但画面清晰度相当,且完全脱离 ffmpeg.exe。
本机微软 H264 编码器的 ICodecAPI 为只读(SetValue 返回 E_NOTIMPL),码率控制经输出类型的
MT_AVG_BITRATE生效;Quality 档的"质量→码率"映射已按 720p@15fps 标定:q50≈215kbps、 q75≈385kbps、q100≈560kbps。要更小体积:调低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,不影响录像帧率 |
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属性上报。 停止录制后立刻重新开始会被拒绝(上一段正在封存),画面会提示"上一段录像保存中"。
进一步缩小录像体积
- 相机切子码流:海康/大华地址把
Channels/101(主码流)改为102(子码流,通常 640x360/480p), 直通模式下体积直接降到子码率,且几乎不占 CPU。 - 再编码场景用
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 | Versions 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. |
-
.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.