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

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 事件触发后再去更新绑定。

说到底，WPF 视频播放真正的难点，往往不在于“怎么播”，而在于“怎么稳播”——格式兼容性、控件的生命周期管理、全屏时的特殊行为，以及和 WPF 渲染线程的耦合。这些细节一旦被忽略，调试时很可能只看到一个黑屏或者无声的画面，而错误提示却又非常模糊，这才是最让人头疼的地方。