视频缩略图生成插件技术文档

视频缩略图生成插件技术文档

video_thumbnail This plugin generates thumbnail from video file or URL. It returns image in memory or writes into a file. It offers rich options to control the image format, resolution and quality. Supports iOS and Android. 项目地址: https://gitcode.com/gh_mirrors/vi/video_thumbnail

安装指南

为了在您的Flutter项目中使用video_thumbnail插件，您需要遵循以下步骤：

1. 打开您的项目的pubspec.yaml文件。
2. 在dependencies部分添加以下行：

   dependencies:
     video_thumbnail: ^0.5.3
   

3. 保存文件后，在命令行中运行flutter pub get以下载并安装插件。

项目使用说明

video_thumbnail插件允许从本地视频文件或URL中生成缩略图，并可以选择将图片保存到内存或文件系统。它支持对图像格式、分辨率和质量进行精细控制，并兼容iOS和Android平台。

项目API使用文档

• 生成内存中的缩略图

  使用thumbnailData方法可以创建一个位于内存中的缩略图。

  Future<Uint8List> generateMemoryThumbnail(String videoPath) async {
    final uint8list = await VideoThumbnail.thumbnailData(
      video: videoPath,
      imageFormat: ImageFormat.JPEG,
      maxWidth: 128, // 自动调整高度保持原比例，宽度限制为128像素
      quality: 25,   // 图像质量，范围0-100
    );
    return uint8list;
  }
  

• 生成文件形式的缩略图

  使用thumbnailFile方法可以直接将缩略图保存至指定路径的文件。

  Future<String> generateToFileThumbnail(String videoUrlOrPath) async {
    final tempDir = await getTemporaryDirectory();
    final fileName = await VideoThumbnail.thumbnailFile(
      video: videoUrlOrPath,
      thumbnailPath: tempDir.path,
      imageFormat: ImageFormat.WEBP,
      maxHeight: 64, // 自动调整宽度保持原比例，高度限制为64像素
      quality: 75,   // 图像质量
    );
    return fileName;
  }
  

注意事项

• 当在Android上同时设置maxHeight和maxWidth时，会按这两个参数精确地缩放缩略图，不同于iOS的行为。
• 确保网络视频资源的URL是正确的编码格式，以便正确处理。
• 在处理应用内资源（如assets目录下的视频）时，先将其复制到临时目录，然后从中生成缩略图。

性能提示

目前，特别是在iOS平台上生成WebP格式的缩略图时可能会遇到性能问题，这可能是由于底层库libwebp的实现所致。若遇到相关性能瓶颈，开发者可考虑反馈或贡献代码优化。

通过上述文档，您应已掌握如何集成和使用video_thumbnail插件来高效生成视频缩略图，无论是从本地文件、网络链接还是应用程序内的资产。

video_thumbnail This plugin generates thumbnail from video file or URL. It returns image in memory or writes into a file. It offers rich options to control the image format, resolution and quality. Supports iOS and Android. 项目地址: https://gitcode.com/gh_mirrors/vi/video_thumbnail