在C# WinForm应用开发中，实现MP4视频播放并嵌入播放器是很多桌面程序的需求，比如多媒体展示软件、视频教学工具等。目前主流的实现方式有两种，分别是基于系统自带的Windows Media Player组件和第三方开源播放库，两种方式各有适用场景。
方案一：使用Windows Media Player COM组件
Windows系统自带Windows Media Player组件，支持绝大多数常见视频格式，包括MP4，无需额外安装第三方依赖，适合对环境依赖要求低的场景。
1. 添加COM组件引用
首先在Visual Studio中打开WinForm项目，右键点击项目下的引用节点，选择添加引用，切换到COM选项卡，找到Windows Media Player选项，勾选后点击确定，系统会自动生成对应的AxInterop.WMPLib和Interop.WMPLib引用。
2. 添加播放器控件到窗体
打开工具箱，在空白处右键选择选择项，切换到COM组件选项卡，找到Windows Media Player，勾选后确定，工具箱会出现对应的控件，将其拖入窗体即可完成控件添加，默认名称为axWindowsMediaPlayer1。
3. 核心播放代码
实现MP4播放只需要调用控件的URL属性设置视频路径即可，以下是完整的播放、暂停、停止功能代码示例：
using System;
using System.Windows.Forms;
namespace WinFormVideoPlayer
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
// 初始化时设置控件铺满窗体
axWindowsMediaPlayer1.Dock = DockStyle.Fill;
}
// 播放按钮点击事件
private void btnPlay_Click(object sender, EventArgs e)
{
// 设置要播放的MP4文件路径，这里替换为实际路径
string videoPath = @"D:test.mp4";
axWindowsMediaPlayer1.URL = videoPath;
// 设置播放状态为播放
axWindowsMediaPlayer1.Ctlcontrols.play();
}
// 暂停按钮点击事件
private void btnPause_Click(object sender, EventArgs e)
{
axWindowsMediaPlayer1.Ctlcontrols.pause();
}
// 停止按钮点击事件
private void btnStop_Click(object sender, EventArgs e)
{
axWindowsMediaPlayer1.Ctlcontrols.stop();
}
}
}
4. 注意事项
- 该方案依赖系统安装的Windows Media Player版本，部分精简版系统可能缺少对应组件导致无法播放
- 如果MP4视频编码格式比较特殊，可能会出现无法播放的情况，此时需要转码或者更换方案
- 控件默认会显示播放控制栏，可通过
axWindowsMediaPlayer1.uiMode = "none"隐藏控制栏，自定义控制按钮
方案二：使用LibVLCSharp开源库
LibVLCSharp是VideoLAN官方推出的C#绑定库，基于VLC播放器内核，支持几乎所有视频格式，兼容性强，还支持网络视频流播放，适合对格式兼容性要求高的场景。
1. 安装NuGet包
右键点击项目选择管理NuGet程序包，搜索LibVLCSharp.WinForms，安装最新稳定版本，安装完成后会自动引入所有依赖项。
2. 添加播放控件与初始化
LibVLCSharp的WinForm控件需要手动初始化，以下是完整的窗体代码：
using System;
using System.Windows.Forms;
using LibVLCSharp.Shared;
using LibVLCSharp.WinForms;
namespace WinFormVideoPlayer
{
public partial class Form1 : Form
{
private LibVLC _libVLC;
private MediaPlayer _mediaPlayer;
public Form1()
{
InitializeComponent();
// 初始化LibVLC环境
Core.Initialize();
_libVLC = new LibVLC();
_mediaPlayer = new MediaPlayer(_libVLC);
// 创建视频播放控件
VideoView videoView = new VideoView
{
Dock = DockStyle.Fill,
MediaPlayer = _mediaPlayer
};
// 将控件添加到窗体
this.Controls.Add(videoView);
}
// 播放MP4视频
private void PlayVideo(string filePath)
{
// 创建媒体对象，支持本地路径和网络URL
Media media = new Media(_libVLC, filePath, FromType.FromPath);
_mediaPlayer.Media = media;
_mediaPlayer.Play();
}
private void Form1_Load(object sender, EventArgs e)
{
// 窗体加载时播放测试视频
PlayVideo(@"D:test.mp4");
}
// 窗体关闭时释放资源
private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
_mediaPlayer.Stop();
_mediaPlayer.Dispose();
_libVLC.Dispose();
}
}
}
3. 方案优势
- 支持所有VLC支持的视频格式，几乎不存在无法播放的MP4文件
- 支持RTSP、HTTP等网络视频流播放，适用场景更广泛
- 跨平台兼容性好，后续如果需要迁移到WPF或者.NET Core项目也可以快速适配
两种方案对比
以下是两种方案的详细对比，开发者可以根据实际需求选择：
| 对比项 | Windows Media Player组件 | LibVLCSharp库 |
|---|---|---|
| 依赖要求 | 依赖系统自带组件，无需额外安装 | 需要安装NuGet包，无系统组件依赖 |
| 格式兼容性 | 仅支持常见编码格式 | 支持几乎所有视频格式 |
| 网络流支持 | 支持有限 | 支持所有常见网络流协议 |
| 部署难度 | 低，无需额外打包依赖 | 中，需要随程序打包库文件 |
常见问题处理
Q：播放时出现黑屏但有声音？
A：大概率是视频解码器问题，Windows Media Player方案可以尝试安装对应的解码器包，LibVLCSharp方案则基本不会出现该问题。
Q：如何获取视频播放进度？
A：Windows Media Player方案可以通过axWindowsMediaPlayer1.Ctlcontrols.currentPosition获取当前进度，LibVLCSharp方案可以通过_mediaPlayer.Time获取，单位为毫秒。
Q：如何设置视频循环播放？
A：Windows Media Player方案设置axWindowsMediaPlayer1.settings.setMode("loop", true)，LibVLCSharp方案监听播放结束事件，结束后重新调用Play方法即可。
C#WinFormMP4播放视频播放器嵌入MediaPlayer控件修改时间：2026-07-15 18:30:36