当前位置：首页 > article >正文

fluent-ffmpeg 依赖详解

article 2025/3/6 17:42:37

fluent-ffmpeg 是一个用于在 Node.js 环境中与 FFmpeg 进行交互的强大库，它提供了流畅的 API 来执行各种音视频处理任务，如转码、剪辑、合并等。

一、安装

npm install fluent-ffmpeg

二、基本使用

要使用 fluent-ffmpeg，首先需要确保系统中已经安装了 FFmpeg，或者使用 ffmpeg-static 等库提供静态的 FFmpeg 二进制文件。如下，展示如何将视频文件转换为另一种格式

const ffmpeg = require("fluent-ffmpeg");
// 设置 FFmpeg 可执行文件的路径（如果需要）
// ffmpeg.setFfmpegPath('/path/to/ffmpeg');
// 创建一个 FFmpeg 命令
ffmpeg("input.mp4")
  .output("output.avi")
  .on("end", () => {
    console.log("转换完成");
  })
  .on("error", (err) => {
    console.error("转换出错:", err.message);
  })
  .run();

三、常见功能及用法

1. 转码

可以指定不同的编码器、分辨率、码率等参数进行转码

ffmpeg("input.mp4")
  .videoCodec("libx264") // 指定视频编码器
  .audioCodec("aac") // 指定音频编码器
  .size("640x480") // 指定视频分辨率
  .videoBitrate("1000k") // 指定视频码率
  .output("output.mp4")
  .run();

2. 剪辑

可以指定开始时间和持续时间来剪辑视频

ffmpeg("input.mp4")
  .setStartTime("00:01:00") // 从第 1 分钟开始
  .setDuration("00:00:30") // 剪辑 30 秒
  .output("output.mp4")
  .run();

3. 合并多个视频文件

可以将多个视频文件合并为一个

const command = ffmpeg();
// 添加多个输入文件
command.input("input1.mp4");
command.input("input2.mp4");
// 合并文件
command.mergeToFile("output.mp4", __dirname);

4. 生成缩略图

可以从视频中提取缩略图

ffmpeg("input.mp4").screenshots({
  count: 1, // 生成 1 张缩略图
  folder: "thumbnails", // 缩略图保存的文件夹
  size: "320x240", // 缩略图的尺寸
  filename: "thumbnail-%b.jpg", // 缩略图的文件名
});

5. 事件监听

fluent-ffmpeg 提供了多个事件，可以用于监控命令的执行状态

start：命令开始执行时触发。
progress：处理进度更新时触发，可以获取当前的处理进度信息。
end：命令执行完成时触发。
error：命令执行出错时触发。

ffmpeg("input.mp4")
  .output("output.mp4")
  .on("start", (commandLine) => {
    console.log("开始执行命令:", commandLine);
  })
  .on("progress", (progress) => {
    console.log("处理进度:", progress.percent + "%");
  })
  .on("end", () => {
    console.log("处理完成");
  })
  .on("error", (err) => {
    console.error("处理出错:", err.message);
  })
  .run();