fluent-ffmpeg依赖详解

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(); 四、注意事项 1. FFmpeg 依赖

fluent-ffmpeg 只是一个封装库，需要系统中安装有 FFmpeg 才能正常工作。可以使用 ffmpeg-static 来提供静态的 FFmpeg 二进制文件，避免手动安装的麻烦。

2. 错误处理

在实际应用中，要注意对 error 事件进行处理，以捕获和处理可能出现的错误，保证程序的健壮性。

3. 资源管理

音视频处理通常会消耗大量的系统资源，特别是在处理大文件或进行复杂操作时，要注意合理分配资源，避免程序崩溃。