适用于 .NET 和 C# 的商业 GStreamer SDK
Media Blocks SDK .NET 是基于 GStreamer 的商业 .NET SDK。你用强类型的块(源、编码器、效果和输出)在 C# 中搭建管道,而不是写字符串管道、直接操作原始元素;需要时,仍可把任意 GStreamer 元素封装成块。
每年 €500 起 · Lifetime 许可证 €1,800 起
有没有商业的 .NET GStreamer SDK?
有。VisioForge Media Blocks SDK .NET 在 GStreamer 上运行其媒体管道,以商业许可证提供,并由 VisioForge 提供支持。它不是 GStreamer API 的一对一复制:每个块把一个或多个 GStreamer 元素封装在带设置对象的 C# 类中,再由 MediaBlocksPipeline.Connect 连接各个块。当 SDK 没有你所需元素的块时,CustomMediaBlock 可以按工厂名或 bin 描述封装该元素,并把原始 Gst.Element 交给你。
GStreamer 绑定与 Media Blocks SDK .NET 对比
| gstreamer-sharp 绑定(NuGet 包 GstSharp) | Media Blocks SDK .NET | |
|---|---|---|
| 编程对象 | GStreamer API 本身,由 GObject Introspection 生成:元素、pad、caps 和总线消息 | 带设置类的强类型块,用 MediaBlocksPipeline.Connect 连接;原始元素通过 CustomMediaBlock 使用 |
| GStreamer 运行时 | 不包含在包中;需要你为每个目标平台安装或打包 GStreamer | Windows、macOS、Android 和 iOS:原生库包含在 VisioForge.CrossPlatform.Core.* NuGet 包中(Android 还需添加一个 Java 绑定项目)。Linux:通过发行版的包管理器安装其 GStreamer 1.22 或更高版本(Ubuntu 24.04 提供 1.24),再加上 VisioForge.CrossPlatform.Core.Linux.x64 或 VisioForge.CrossPlatform.Core.Linux.arm64 |
| 最新 NuGet 版本 | GstSharp 1.18.0,2020 年 9 月发布,提供 .NET Framework 4.5 程序集 | VisioForge.DotNet.MediaBlocks,随每个 SDK 版本发布 |
| 没有封装的元素 | 所有元素都直接使用 | CustomMediaBlock 可把任意元素或 bin 描述封装成块 |
| UI 与平台 | 视频输出和 UI 集成需要自己实现 | 在 Windows、macOS、Linux、Android 和 iOS 上提供 WinForms、WPF、WinUI 3、MAUI、Uno Platform 和 Avalonia 的视频视图;Unity 包适用于 Windows、macOS、Android 和 iOS |
| 许可与支持 | 开源绑定 | 商业许可证、免版税分发、VisioForge 支持 |
Media Blocks SDK .NET 在 GStreamer 之上增加了什么
SDK 通过 NuGet 包 VisioForge.DotNet.MediaBlocks 提供。媒体处理由 GStreamer 完成;SDK 为其提供 C# 形式的接口。
- 用强类型块代替字符串管道:RTSPSourceBlock、H264EncoderBlock 或 MP4SinkBlock 接收设置对象,因此元素名或属性名的拼写错误会成为编译错误,而不是运行时故障
- 编码器选择:无参数的 H264EncoderBlock 在有硬件编码器时选用硬件编码器,否则回退到软件编码器
- 在 Windows、macOS、Android 和 iOS 上,运行时随 NuGet 包提供;在 Linux 上,SDK 使用发行版的 GStreamer
- 需要时可用任意 GStreamer 元素:CustomMediaBlock 接收工厂名或 bin 描述,从字典设置属性,并通过 OnElementAdded 交出原始 Gst.Element
- 自定义强类型块:继承 MediaBlock,即可用设置类和 IsAvailable() 检查封装一个元素,写法与内置块相同
- 更高层 SDK 使用同一引擎:Video Capture SDK .NET 中的 VideoCaptureCoreX 和 Media Player SDK .NET 中的 MediaPlayerCoreX 运行在同一个基于 GStreamer 的管道上
应用场景
从 gst-launch 原型到 C# 应用
用强类型块重建在命令行中试过的管道,SDK 未封装的元素则放进 CustomMediaBlock 继续使用。
IP 摄像机录制与转推
把 RTSP 和 ONVIF 摄像机录制为 MP4 或 MPEG-TS,并从同一个管道通过 HLS、RTMP、RTSP 或 SRT 转推。
跨平台媒体应用
用 C# 编写一次管道,在 Windows、macOS、Linux、Android 和 iOS 上运行,并使用 WPF、MAUI、Avalonia 及其他受支持 UI 框架的视频视图。
第三方及自研 GStreamer 插件
在 Media Blocks 管道中使用厂商的摄像机插件、gst-plugins-bad 中的元素或你自己编写的插件。
代码示例
第一个示例只使用强类型块;第二个示例与控制台示例 CustomGrayscaleBlock 一样,用 CustomMediaBlock 封装 GStreamer 元素。
用强类型块把 RTSP 摄像机录制为 MP4
C#把任意 GStreamer 元素封装成块
C#GStreamer 所处的位置
你的代码操作的是块。每个块在管道启动时构建自己的 GStreamer 元素,GStreamer 原生库来自 VisioForge 的 NuGet 包,在 Linux 上则来自系统。
常见问题
是否存在基于 GStreamer 的商业 .NET SDK?▼
Media Blocks SDK .NET 是 GStreamer API 的一对一封装吗?▼
能否使用 SDK 未封装的 GStreamer 元素?▼
能否使用 gst-launch 管道描述?▼
需要单独安装 GStreamer 吗?▼
支持哪些平台和 UI 框架?▼
如何试用?▼
文档与示例
用 GStreamer 元素构建 MediaBlock
逐步讲解 CustomMediaBlock 和强类型 MediaBlock 子类:pad、属性、动态 pad 和生命周期。
CustomGrayscaleBlock 示例
控制台示例,分别用 CustomMediaBlock 和强类型子类两种方式封装 videobalance,并各自录制为 MP4。
管道入门
创建 MediaBlocksPipeline,添加并连接块,启动和停止管道。
特殊块参考
CustomMediaBlock、CustomMediaBlockSettings 和 CustomMediaBlockPad 的全部属性。
部署指南
Windows、macOS、Linux、Android 和 iOS 的部署概览,并附有各平台详细指南的链接。
Ubuntu 部署
用 apt 安装 GStreamer 1.22 或更高版本,并添加适用于 Linux 的 VisioForge 核心包。
开始用 C# 构建 GStreamer 管道
下载功能完整的 30 天试用版并运行 Media Blocks 示例。根据输出的不同,可能会出现水印或未注册版本提示。
基于 GStreamer 的 SDK
Media Blocks SDK .NET
管道 SDK:自行组合源、处理块和输出,并用 CustomMediaBlock 封装任意 GStreamer 元素。
了解更多 →Video Capture SDK .NET
采集 SDK:VideoCaptureCoreX 在同一个基于 GStreamer 的管道上录制和推流摄像机、屏幕和音频设备。
了解更多 →Media Player SDK .NET
播放器 SDK:MediaPlayerCoreX 在同一个基于 GStreamer 的管道上播放文件和网络流。
了解更多 →每年 €500 起 · Lifetime 许可证 €1,800 起
