c#如何在WPF中播放视频_c#在WPF中播放视频项目实例附完整源码

时间：2026-05-06 07:10

MediaElement 播放本地视频需设 LoadedBeha vior、用绝对正确 pack: 路径、绑定 ViewModel 属性并监听 MediaFailed；全屏需无边框窗口手动管理；进度音量控制应防抖、暂停后 Seek、延时更新。用 MediaElement 播放本地视频是最直

MediaElement 播放本地视频需设 LoadedBeha vior、用绝对/正确 pack:// 路径、绑定 ViewModel 属性并监听 MediaFailed；全屏需无边框窗口手动管理；进度/音量控制应防抖、暂停后 Seek、延时更新。

用 `MediaElement` 播放本地视频是最直接的方式

想在 WPF 里播个本地视频，最省事的办法就是直接用自带的 MediaElement 控件。它开箱即用，能直接加载本地文件、网络地址甚至内存流，不需要额外引入第三方库。其底层调用的是 Windows Media Foundation，所以对 MP4（H.264+AAC）、WMV、A VI 这类常见格式支持得相当稳定。不过，像 WebM 或纯 VP9 这类格式，它就不支持了。

这里有个关键点：必须设置 LoadedBeha vior 属性为 “Manual” 或 “Play”。如果不设，控件初始化后可能根本不会去加载媒体。另外，路径要用绝对路径，或者确保运行时的工作目录正确。

Source 属性只认 URI 字符串，像 FileInfo 或 byte[] 是传不进去的。如果视频是项目资源，得先确保它被复制到输出目录，设置 Copy to Output Directory = Copy always。
播放前，最好检查一下 MediaElement.LoadedBeha vior 是不是 MediaState.Manual，否则调用 Play() 方法可能会静默失败。
如果遇到视频黑屏但有声音的情况，大概率是解码器缺失（比如没装 HEVC 扩展）或者硬件加速冲突。可以尝试临时加上 RenderOptions.SetBitmapScalingMode(this, BitmapScalingMode.NearestNeighbor) 来绕过。

绑定视频路径时别直接写死字符串，用 `Binding` + `INotifyPropertyChanged`

在 XAML 里硬编码一个路径，比如 Source=“pack://application:,,,/Assets/demo.mp4”，看起来简单，但项目一旦换环境或者资源结构有调整，很容易出问题。真实项目中，更推荐的做法是把路径抽离成 ViewModel 的一个属性，通过数据绑定来驱动播放。

这里要特别注意 pack:// 协议的写法细节：application 表示当前程序集，siteoforigin 表示启动目录。如果视频放在子文件夹里，路径得写成 pack://application:,,,/Assets/Video/demo.mp4，漏掉一个斜杠或者大小写不对，都会触发 MediaFailed 事件。

绑定之后，一定要监听 MediaElement.MediaFailed 事件。错误信息通常在 e.ErrorException.Message 里，常见的比如 “The specified media is not supported” 或者 “Access is denied”。
如果采用 MVVM 模式，当 ViewModel 中的路径属性变更后，必须触发 PropertyChanged 通知，否则 UI 不会更新。很多人调试半天，最后发现就是忘了调用 OnPropertyChanged()。
不要在 MediaOpened 事件里立刻去读取 Position 来获取视频时长。得等 MediaElement.HasVideo 属性变为 true 之后，再读取 NaturalDuration，否则返回的可能是 Automatic。

全屏播放时 `MediaElement` 会脱离 WPF 渲染树，需手动处理尺寸和焦点

WPF 的 MediaElement 在全屏模式下，实际上是由系统渲染器接管的，不再走 WPF 的布局逻辑。这意味着，你没法再靠 Stretch=“Uniform” 或者 Grid.RowSpan 来控制它的显示区域，鼠标事件（比如点击暂停）也可能无法响应。

一个实用的解决方案是：不直接使用系统全屏，而是创建一个无边框窗口，让它覆盖整个屏幕，然后把 MediaElement 放进去，并手动同步窗口尺寸与视频的宽高比。在 Windows 10 及以上系统，还可以启用 IsManipulationEnabled=“True” 来支持手势缩放，不过要注意处理好触摸事件和键盘焦点可能产生的冲突。

设置 WindowStyle=“None” 和 WindowState=“Maximized” 后，一定要把 Topmost 属性设为 “True”，否则任务栏可能会遮挡视频。
当用户按 Esc 退出全屏时，别只改 WindowState，还得记得重置 MediaElement 的 Width 和 Height，否则恢复窗口后画面可能会拉伸变形。
在某些显卡驱动下，全屏时如果弹出右键菜单或触发系统快捷键（比如 Win+D），可能导致 MediaElement 卡住。建议监听窗口的 Deactivated 事件，并主动调用 Pause()。

想控制进度条或音量？别直接拖 `Slider`，要双向绑定 + 事件防抖

把 Slider.Value 直接双向绑定到 MediaElement.Position.TotalSeconds，想法很美好，但现实很骨感。由于精度丢失、异步加载、Seek 操作不精确等问题，这样绑定很容易导致进度条频繁跳变。更稳妥的做法是：在拖动 Slider 时，先暂停播放，等用户松手后，再执行 Seek 操作并恢复播放。

音量控制也是类似的道理。MediaElement.Volume 是 double 类型（范围 0.0–1.0），但系统音量调节本身有滞后。如果用户快速连续拖动 Slider，会频繁触发 ValueChanged 事件，容易造成卡顿。

给进度条 Slider 加上 IsMoveToPointEnabled=“True”，这样用户点击任意位置就能跳转，而不必非得拖到刻度点。
在 Slider.PreviewMouseLeftButtonUp 事件里调用 MediaElement.Seek()，而不是在 ValueChanged 事件里，这样可以大幅减少无效的 Seek 请求。
音量 Slider 最好能加上一点延迟，比如通过附加属性模拟一个 Delay=“100” 的效果，防止鼠标每移动一个像素就写一次 Volume 属性。
进度条的最大值应该绑定到 MediaElement.NaturalDuration.TimeSpan.TotalSeconds。但要注意，这个值在视频刚加载时可能为 0，需要等到 MediaOpened 事件触发后再去更新绑定。