Project Icon

video_editor

Flutter视频编辑库 提供裁剪旋转和封面选择功能

video_editor是一个Flutter视频编辑库,支持视频裁剪、旋转、缩放和封面选择等功能。该库提供灵活的UI设计和导出工具,但不直接处理视频导出。目前仅支持iOS和Android平台,使用Dart编写。它包含VideoEditorController用于控制编辑,以及用于裁剪、修剪和封面选择的组件。开发者可自定义界面样式,并通过FFmpeg配置进行视频导出。

Flutter 视频编辑器

Pub GitHub stars

一个允许编辑(修剪、裁剪、旋转和缩放)视频并选择封面的视频编辑器,具有非常灵活的UI设计。

该库提供了一些工具来执行导出,但不处理导出过程。

这个库完全用Dart编写,但使用了外部包如video_thumbnail,这使得它目前只在iOS和Android平台上可用(网页支持正在进行中)。

注意 如果你使用的版本在1.2.3到2.4.0之间,你的项目可能受GPL许可证约束。

AndroidiOS
支持SDK 16+11.0+

📖 安装

以下步骤将帮助你将此库作为依赖项添加到你的Flutter项目中。

  • 运行flutter pub add video_editor,或手动将video_editor添加到pubspec.yaml文件中。
dependencies:
  video_editor: ^2.4.0
  • 在代码中导入包:
import 'package:video_editor/video_editor.dart';

📸 截图

在iPhone 11 Pro上运行的示例应用自定义示例,浅色模式

👀 使用方法

final VideoEditorController _controller = VideoEditorController.file(
  File('/path/to/video.mp4'),
  minDuration: const Duration(seconds: 1),
  maxDuration: const Duration(seconds: 10),
);

@override
void initState() {
  super.initState();
  _controller.initialize().then((_) => setState(() {}));
}

@override
void dispose() {
  _controller.dispose();
  super.dispose();
}

/// 基本导出视频功能
Future<void> exportVideo() async {
  final config = VideoFFmpegVideoEditorConfig(_controller);
  // 返回生成的命令和输出路径
  final FFmpegVideoEditorExecute execute = await config.getExecuteConfig();

  // ... 自行处理视频导出,使用ffmpeg_kit_flutter、你自己的视频服务器等...
}

/// 将视频导出为GIF图像
Future<void> exportGif() async {
  final gifConfig = VideoFFmpegVideoEditorConfig(
    _controller,
    format: VideoExportFormat.gif,
  );
  // 返回生成的命令和输出路径
  final FFmpegVideoEditorExecute gifExecute = await gifConfig.getExecuteConfig();

  // ...
}

/// 导出视频,使用自定义命令(超快预设 + 水平翻转)
Future<void> exportMirroredVideo() async {
  final mirrorConfig = VideoFFmpegVideoEditorConfig(
      _controller,
      name: 'mirror-video'
      commandBuilder: (VideoFFmpegVideoEditorConfig config, String videoPath, String outputPath) {
        final List<String> filters = config.getExportFilters();
        filters.add('hflip'); // 添加水平翻转

        return '-i $videoPath ${config.filtersCmd(filters)} -preset ultrafast $outputPath';
      },
    );
  // 返回生成的命令和输出路径
  final FFmpegVideoEditorExecute mirrorExecute = await mirrorConfig.getExecuteConfig();

  // ...
}

更多详情请查看示例

VideoEditorController

函数描述
initialize(double? aspectRatio)初始化controller参数、视频、修剪和封面,调用cropAspectRatio
rotate90Degrees(RotateDirection)按提供的方向将视频旋转90度
setPreferredRatioFromCrop将宽高比更新为当前裁剪区域比例
cropAspectRatio(double?)更新宽高比 + 将裁剪区域更新到视频尺寸的中心
updateCrop(Offset, Offset)更新控制器的裁剪最小值和最大值
applyCacheCrop使用缓存值更新控制器的裁剪最小值和最大值
updateTrim(double, double)更新控制器的修剪最小值和最大值
获取器描述
-----------------------------------------------------------------
Duration startTrim裁剪区域的起始值
Duration endTrim裁剪区域的结束值
Duration trimmedDuration所选裁剪区域的持续时间
bool isTrimmed当裁剪值不是默认视频时长时设为true
bool isTrimming当startTrim或endTrim正在变化时设为true
Duration maxDuration裁剪区域可能的最大持续时间
Duration minDuration裁剪区域可能的最小持续时间
Offset minCrop裁剪区域的左上角位置(介于0.01.0之间)
Offset maxCrop裁剪区域的右下角位置(介于0.01.0之间)
Size croppedArea裁剪区域的实际大小
double? preferredCropAspectRatio选定的首选裁剪宽高比
bool isRotated当旋转角度不为0时设为true
int rotation设置的旋转角度090180270
int cacheRotation编辑器中应用的所有旋转角度之和
CoverData? selectedCoverVal用于导出最终封面的选定封面缩略图
int coverThumbnailsQuality = 10coverThumbnailsQuality参数指定生成的封面缩略图质量,范围从0到100(更多信息
int trimThumbnailsQuality = 10trimThumbnailsQuality参数指定生成的裁剪滑块缩略图质量,范围从0到100(更多信息

小部件

点击展开小部件文档

裁剪

1. CropGridViewer

此小部件用于在视频上启用裁剪操作(CropGridViewer.edit),或仅预览裁剪结果(CropGridViewer.preview)。

参数描述
required VideoEditorController controllercontroller参数是必需的,以便控制器设置的每个更改都会在裁剪视图中传播
EdgeInsets margin用于缩进裁剪视图的空间量,在预览模式下不使用
bool rotateCropArea当裁剪视图旋转时保持preferredCropAspectRatio

修剪器

1. TrimSlider

显示包含视频缩略图的修剪器,具有旋转和裁剪参数。

参数描述
required VideoEditorController controllercontroller参数是必需的,以便控制器设置的每个更改都会在修剪滑块视图中传播
double height = 0.0height参数指定生成的缩略图的高度
double horizontalMargin = 0.0horizontalMargin参数指定滑块周围的水平空间。当修剪可以拖动时(controller.maxDuration < controller.videoDuration)很重要
Widget? childchild参数可以指定在此小部件下方显示的小部件(例如:TrimTimeline)
bool hasHaptic = truehasHaptic参数指定当修剪触及边缘(左或右)时是否可以触发触觉反馈
double maxViewportRatioo = 2.5maxViewportRatio参数指定视图比例的上限
ScrollController? scrollControllerscrollController参数指定用于修剪滑块视图的滚动控制器
2. TrimTimeline

显示视频时间线。

参数描述
required VideoEditorController controllercontroller参数是必需的,因为根据controller.maxDuration,生成的时间线会有所不同
double quantity = 8时间线中预期显示的元素quantity
EdgeInsets padding = EdgeInsets.zeropadding参数指定时间线周围的空间
String localSeconds = 's'用于表示秒数的字符串,显示在每个时间线元素旁边
TextStyle? textStyle用于设置时间线文本样式的TextStyle

封面

1. CoverSelection

显示一些生成的封面,具有旋转和裁剪参数,用于更新所选封面。

参数描述
required VideoEditorController controllercontroller参数是必需的,以便控制器设置的每个更改都会在封面选择视图中传播
double size = 0.0size参数指定生成的缩略图的最大尺寸
double horizontalMargin = 0.0当裁剪视图外有边距时,需要指定horizontalMargin参数,以便在发生更改时可以正确计算新布局
int quantity = 5quantity参数指定要生成的缩略图数量
Wrap? wrap用于自定义缩略图包装器的wrap小部件
Function? selectedCoverBuilder返回所选封面应如何显示
2. CoverViewer

显示带有旋转和裁剪参数的所选封面。

参数描述
required VideoEditorController controllercontroller参数是必需的,以便控制器设置的每个更改都会在封面视图中传播裁剪参数
String noCoverText = 'No selection'noCoverText参数指定当selectedCover为null时显示的文本

样式

点击展开样式文档

1. CropStyle

您可以创建自己的CropStyle类来自定义CropGridViewer的外观。

参数描述
Color croppingBackground = Colors.black.withOpacity(0.48)croppingBackground 参数指定裁剪时裁剪区域外的绘制区域颜色
Color background = Colors.blackbackground 参数指定非裁剪时裁剪区域外的绘制区域颜色
double gridLineWidth = 1gridLineWidth 参数指定裁剪线的宽度
Color gridLineColor = Colors.whitegridLineColor 参数指定裁剪线的颜色
int gridSize = 3gridSize 参数指定裁剪视图中列和行的数量
Color boundariesColor = Colors.whiteboundariesColor 参数指定裁剪区域角落的颜色
Color selectedBoundariesColor = kDefaultSelectedColorselectedBoundariesColor 参数指定选中的裁剪区域角落的颜色
double boundariesLength = 20boundariesLength 参数指定裁剪区域角落的长度
double boundariesWidth = 5boundariesWidth 参数指定裁剪区域角落的宽度

2. TrimStyle

你可以创建自己的 TrimStyle 类来自定义 TrimSlider 的外观。

参数描述
Color background = Colors.black.withOpacity(0.6)background 参数指定修剪区域外的绘制区域颜色
Color positionLineColor = Colors.redpositionLineColor 参数指定显示视频位置的线条颜色
double positionLineWidth = 2positionLineWidth 参数指定显示视频位置的线条宽度
Color lineColor = Colors.whitelineColor 参数指定修剪区域周围边框的颜色
Color onTrimmingColor = kDefaultSelectedColoronTrimmingColor 参数指定修剪过程中修剪区域周围边框的颜色
Color onTrimmedColor = kDefaultSelectedColoronTrimmedColor 参数指定修剪参数不为默认值时修剪区域周围边框的颜色
double lineWidth = 2lineWidth 参数指定修剪区域周围边框的宽度
TrimSliderEdgesType borderRadius = 5borderRadius 参数指定修剪器周围的边框半径
double edgesType = TrimSliderEdgesType.baredgesType 参数指定应用于修剪器边缘(左右)的样式
double edgesSizeedgesSize 参数指定图标后面边缘的大小
Color iconColor = Colors.blackiconColor 参数指定修剪区域边缘图标的颜色
double iconSize = 25iconSize 参数指定修剪区域边缘图标的大小
IconData? leftIcon = Icons.arrow_leftleftIcon 参数指定修剪区域左边缘显示的图标
IconData? rightIcon = Icons.arrow_rightrightIcon 参数指定修剪区域右边缘显示的图标

3. CoverStyle

你可以创建自己的 CoverStyle 类来自定义 CoverSelection 的外观。

参数描述
Color selectedBorderColor = Colors.whiteselectedBorderColor 参数指定所选封面缩略图周围边框的颜色
double borderWidth = 2borderWidth 参数指定每个封面缩略图周围边框的宽度
double borderRadius = 5.0borderRadius 参数指定每个封面缩略图的边框半径

导出

1. FFmpegVideoEditorConfig

参数描述
String? namename 参数指定生成文件的文件名
String? outputDirectoryoutputDirectory 参数指定文件应该生成的位置,默认为临时目录
double scale = 1scale 参数用于增加或减少生成文件的尺寸
bool isFiltersEnabled = trueisFiltersEnabled 参数指定是否应用编辑器参数

2. VideoFFmpegVideoEditorConfig

包含所有 FFmpegVideoEditorConfig 参数。

参数描述
VideoExportFormat format = VideoExportFormat.mp4format 参数指定生成视频的扩展名
String Function? commandBuildercommandBuilder 参数可用于生成带有自定义选项的命令

3. CoverFFmpegVideoEditorConfig

包含所有 FFmpegVideoEditorConfig 参数。

参数描述
CoverExportFormat format = CoverExportFormat.jpgformat 参数指定生成封面的扩展名
int quality = 100quality 参数指定生成缩略图的质量,范围从 0 到 100(更多信息
String Function? commandBuildercommandBuilder 参数可用于生成带有自定义选项的命令

💭 常见问题

1. 为什么从这个包中移除了 FFmpeg?

从 3.0.0 版本开始,video_editor 包不再包含 ffmpeg_kit_flutter

  • 在这个包中包含 ffmpeg_kit_flutter 二进制文件导致了许多用户在同一项目中意图使用不同 FFmpeg 实例时遇到的问题(#37、#129、#153)。
  • 此外,我注意到 video_editor 包可能从 1.2.3 版本开始就被错误许可,并可能受 GPL v3.0 许可的约束,因为它开始使用 ffmpeg_kit_flutter_min_kit 二进制文件。
  • 最后,FFmpeg 包相当大,显著增加了应用程序的大小,这对于希望以不同方式处理导出的开发者来说并不理想。

✨ 致谢

非常感谢 seel-channel,他是这个库的原始创建者。

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号