WPF MediaPlayer获取网络视频流当前帧并展示图片完整范例

原创

已于 2026-06-26 17:34:40 修改 · 228 阅读

于 2026-06-26 17:33:56 首次发布

WPF MediaPlayer获取网络视频流当前帧并展示图片完整范例

前言

在WPF开发中，若需要处理网络视频流（如RTSP、HTTP-FLV等支持的网络视频地址），并实现实时获取当前播放帧、转换为图片并展示的需求，System.Windows.Media.MediaPlayer是WPF原生提供的媒体播放类，无需引入额外第三方播放器库，轻量且易集成。本文将从基础原理、完整代码实现、关键细节解析三个方面，给出可直接运行的范例，解决网络视频流帧提取与图片展示的核心问题。

核心原理

MediaPlayer支持网络视频流的播放（需确保视频流格式为WPF原生支持的类型，如MP4、WMV、HTTP-FLV等，RTSP部分需结合系统解码器支持）；
通过RenderTargetBitmap将MediaPlayer的当前播放画面渲染为位图，再转换为WPF的ImageSource，最终绑定到Image控件实现展示；
借助DispatcherTimer定时提取帧，实现准实时帧展示效果，提取频率可自定义。

环境说明

.NET框架：.NET Framework 4.7.2 / .NET 6/7/8（WPF）
开发工具：Visual Studio 2022
支持的网络视频流：HTTP/HTTPS协议的MP4、FLV、WMV，RTSP（需系统安装对应解码器，如LAV Filters）
注意：MediaPlayer为后台播放类，无可视化界面，需配合DrawingVisual完成画面渲染。

一、完整代码实现

本文实现一个WPF窗口程序，包含核心功能：

输入网络视频流地址，启动/停止播放；
定时提取视频当前帧，转换为图片并展示；
帧提取频率可配置，支持实时刷新；
异常处理（网络地址无效、视频流无法播放、帧提取失败等）。

1. XAML布局设计

新建WPF应用程序，修改MainWindow.xaml，布局包含地址输入框、操作按钮、帧展示图片控件，采用简单的网格布局，适配窗口大小：

<Window x:Class="WpfMediaPlayerFrameCapture.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfMediaPlayerFrameCapture"
        mc:Ignorable="d"
        Title="WPF网络视频流帧提取" Height="600" Width="800"
        Closing="Window_Closing">
    <Grid Margin="10" ShowGridLines="False">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="Auto" Margin="0,10,0,10"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>
        <!-- 网络视频流地址输入 -->
        <StackPanel Grid.Row="0" Orientation="Horizontal" Spacing="10">
            <TextBlock Text="视频流地址：" VerticalAlignment="Center" FontSize="14"/>
            <TextBox x:Name="txtVideoUrl" Width="500" Height="30" VerticalAlignment="Center"
                     Text="https://xxx.xxx.xxx/stream.mp4"/> <!-- 替换为实际网络视频流地址 -->
        </StackPanel>
        <!-- 操作按钮 -->
        <StackPanel Grid.Row="1" Orientation="Horizontal" Spacing="10">
            <Button x:Name="btnStart" Content="启动播放并提取帧" Width="180" Height="35"
                    Click="BtnStart_Click" Background="#1E90FF" Foreground="White" BorderThickness="0"/>