Flutter视频处理插件ffipeg的使用

ffipeg 是一个用于在项目中轻松生成 Dart FFI 绑定到 FFmpeg 的插件。通过以下三个步骤即可完成配置和使用：

1. 添加库注解；
2. 运行 build_runner；
3. 导入生成的文件并开始使用。

示例

以下是一个简单的示例代码，展示了如何使用 ffipeg 处理视频文件。

ffmpeg.dart

@FFmpegGen(
  versionSpec: '>=7.1 <8.0',
  excludeAllByDefault: true,
  functions: FFInclude({
    'av_compare_ts',
    'av_interleaved_write_frame',
    'av_log_set_level',
    'av_packet_alloc',
    // ...
    'avio_open',
  }),
  structs: FFInclude({'AVFormatContext', 'AVIOContext', 'AVPacket'}),
  enums: FFInclude({'AVMediaType'}),
  macros: FFInclude({'AVIO_FLAG_WRITE', 'AV_NOPTS_VALUE', 'AV_LOG_.*'}),
)
library;

import 'dart:ffi';
import 'dart:io';
import 'package:ffi/ffi.dart';
import 'package:ffipeg/ffipeg.dart'; // 导入 `@FFmpegGen` 注解
import 'ffmpeg.ffipeg.dart'; // 导入生成的 FFI 绑定文件

void main() {
  // 打开 FFmpeg 动态库
  final dylib = DynamicLibrary.open('/path/to/ffmpeg');
  final ffmpeg = FFmpeg(dylib);

  // 设置日志级别
  ffmpeg.av_log_set_level(AV_LOG_DEBUG);

  // 分配指针
  final videoInputCtx = calloc<Pointer<AVFormatContext>>();
  final videoPkt = ffmpeg.av_packet_alloc();
  final videoPktPtr = calloc<Pointer<AVPacket>>();

  // 视频文件路径
  final videoFile = "/path/to/video/file.mp4";

  // 打开视频文件
  if (0 != ffmpeg.avformat_open_input(
      videoInputCtx, videoFile.toNativeUtf8().cast(), nullptr, nullptr)) {
    throw Exception('Failed to open video file: $videoFile');
  }
  print('Video file opened successfully.');

  // 关闭资源
  ffmpeg
    ..avformat_close_input(videoInputCtx)
    ..av_packet_free(videoPktPtr);

  if (videoPktPtr != nullptr) {
    calloc.free(videoPktPtr);
  }
  if (videoInputCtx != nullptr) {
    calloc.free(videoInputCtx);
  }
}

特性

• 易于使用：ffipeg 是 FfiGen() 的封装，通过 build_runner 提供更易用的接口。
• 默认支持 FFmpeg：提供了合理的默认值，方便快速集成。
• 自定义头文件路径：可以指定 FFmpeg 头文件路径，支持多平台构建。
• 灵活的包含/排除选项：通过强类型选项控制函数、结构体、宏和枚举的包含或排除。
• 自定义类名：可以自定义生成的函数类名，默认为 FFmpeg。
• 可选 LLVM 路径：支持传递自定义 LLVM 路径。

使用步骤

前提条件

• Flutter 不是必需的：仅需 Dart 和包依赖即可进行代码生成。
• 运行 FFI 代码：需要一个 FFmpeg 二进制文件（可执行文件或动态库）。
• 无需 fvp 或其 mdk-sdk：任何与目标系统兼容的 FFmpeg 二进制文件均可使用。

安装

添加以下四个包：

dart pub add ffipeg
dart pub add ffi
dart pub add --dev ffipeg_builder
dart pub add --dev build_runner

使用方法

确保 FFmpeg 二进制文件在构建后的 Flutter 应用或 Dart 可执行文件路径中可用。可能需要特定的 Platform 切换来指定传递给 DynamicLibrary() 构造函数的路径/名称。

更多详细信息请参考 <code>FFmpegGen</code> 类的源码文档，或者查看 <code>ffipeg_muxer</code> 包中的示例代码，了解如何不转码地混流音频和视频文件。

示例代码说明

上述代码展示了如何使用 ffipeg 打开视频文件并读取其基本信息。以下是关键部分的解释：

1. 导入必要的包：

   import 'dart:ffi';
   import 'dart:io';
   import 'package:ffi/ffi.dart';
   import 'package:ffipeg/ffipeg.dart';
   import 'ffmpeg.ffipeg.dart';
   

2. 打开 FFmpeg 动态库：

   final dylib = DynamicLibrary.open('/path/to/ffmpeg');
   final ffmpeg = FFmpeg(dylib);
   

3. 设置日志级别：

   ffmpeg.av_log_set_level(AV_LOG_DEBUG);
   

4. 分配指针：

   final videoInputCtx = calloc<Pointer<AVFormatContext>>();
   final videoPkt = ffmpeg.av_packet_alloc();
   final videoPktPtr = calloc<Pointer<AVPacket>>();
   

5. 打开视频文件：

   if (0 != ffmpeg.avformat_open_input(
       videoInputCtx, videoFile.toNativeUtf8().cast(), nullptr, nullptr)) {
     throw Exception('Failed to open video file: $videoFile');
   }
   

6. 关闭资源：

   ffmpeg
     ..avformat_close_input(videoInputCtx)
     ..av_packet_free(videoPktPtr);
   
   if (videoPktPtr != nullptr) {
     calloc.free(videoPktPtr);
   }
   if (videoInputCtx != nullptr) {
     calloc.free(videoInputCtx);
   }