Flutter Windows端如何获取视频指定位置的图像帧

无需依赖功能不匹配或平台不兼容的第三方包，直接基于dart_vlc原生封装的libVLC帧回调能力即可实现需求，提取的帧为纯视频内容，不会混入播放控制UI，完美支持Windows平台。

实现步骤 #

• 初始化播放器时开启原生帧回调
  dart_vlc底层基于libVLC，支持直接输出解码后的原始视频帧数据，数据不经过Flutter组件渲染层，初始化Player时传入videoFrameCallback配置即可开启回调：

  // 提前声明变量存需要的帧数据，避免每次回调都触发存储逻辑
  bool needCaptureFrame = false;
  Uint8List? targetFrameBuffer;
  int targetFrameWidth = 0;
  int targetFrameHeight = 0;
  
  final Player player = Player(
    id: 0,
    // 配置帧输出参数
    videoFrameCallback: VideoFrameCallback(
      width: 1920, // 输出帧宽度，建议和视频原分辨率一致
      height: 1080, // 输出帧高度，建议和视频原分辨率一致
      pixelFormat: PixelFormat.bgra, // Windows原生像素格式，后续转码无需额外通道转换
      onFrame: (VideoFrame frame) {
        // 仅当主动触发取帧时才保存数据，平时不做处理减少性能消耗
        if (needCaptureFrame) {
          targetFrameBuffer = frame.buffer;
          targetFrameWidth = frame.width;
          targetFrameHeight = frame.height;
          needCaptureFrame = false;
        }
      },
    ),
  );
  

• 定位到目标位置提取帧
  需要提取某个时间点的帧时，先将播放器seek到对应时间点，等待帧渲染完成后读取缓存的像素数据即可：

  // 标记需要取帧
  needCaptureFrame = true;
  // 跳转到目标时间点，例如视频第20秒位置
  await player.seek(Duration(seconds: 20));
  // 等待帧解码渲染完成，80-120ms足够
  await Future.delayed(const Duration(milliseconds: 100));
  // 此时targetFrameBuffer中就是对应时间点的纯视频帧数据
  

  如果不想打断前台正常播放的进度，可以单独初始化一个不绑定任何NativeVideo组件的后台Player实例专门用来取帧，取帧完成后直接销毁，完全不会干扰前台播放状态，也不会产生额外的UI渲染消耗。
• 原始像素数据转存为图片文件
  拿到原始BGRA格式的像素数据后，使用全平台兼容的纯Dart image包将数据编码为PNG/JPG格式即可保存到本地：
  首先在pubspec.yaml中添加依赖：

  dependencies:
    image: ^4.2.0
  

  转码保存逻辑：

  import 'package:image/image.dart' as img;
  import 'dart:io';
  
  if (targetFrameBuffer != null) {
    // 将原始像素数据转为Image对象
    final img.Image capturedImage = img.Image.fromBytes(
      width: targetFrameWidth,
      height: targetFrameHeight,
      bytes: targetFrameBuffer!.buffer,
      order: img.ChannelOrder.bgra,
    );
    // 编码为PNG格式写入文件
    final Uint8List pngBytes = img.encodePng(capturedImage);
    await File('C:/your/save/path/frame_20s.png').writeAsBytes(pngBytes);
    // 取完清空缓存
    targetFrameBuffer = null;
  }
  

方案适配说明 #

• screenshot包的实现逻辑是截取Flutter组件树的绘制缓存，dart_vlc的视频内容通过Windows原生渲染表面直接绘制，不在Flutter组件绘制缓存范围内，既无法捕获真实视频内容，还会将上层叠加的播放控制按钮一并截取，不适用于该场景。
• export_video_frame、video_thumbnail等包目前仅适配安卓、iOS移动端，未提供Windows平台原生编译支持，无法在Windows桌面端正常运行。

性能优化提示 #

• 帧回调配置的分辨率不要高于视频原分辨率，避免帧画面拉伸模糊。
• 不需要取帧时可以临时关闭帧回调，减少不必要的CPU、内存占用。
• 批量提取多个时间点的帧时，建议复用同一个后台Player实例，依次seek到不同时间点取帧即可，无需反复创建销毁播放器。

内容的提问来源于stack exchange，提问作者Sadikul Haque Sadi