基于 fluent-ffmpeg 实现 HLS 视频切片：从完整视频到 .ts + .m3u8 流媒体传输

引言

随着在线视频需求的激增，HTTP Live Streaming（HLS）因其广泛的设备兼容性（尤其在 iOS 和现代浏览器中）和自适应码率能力，已成为主流的流媒体传输协议。HLS 的核心在于将一个完整的视频文件切分为一系列小的 .ts（MPEG-TS）片段，并生成对应的 .m3u8 播放列表文件。

在 Node.js 生态中，fluent-ffmpeg 作为对 FFmpeg 命令行工具的优雅封装，极大简化了音视频处理流程。本文将详细介绍如何使用 fluent-ffmpeg 将任意格式的视频文件（如 MP4、AVI、MOV）高效转码并切片为符合 HLS 标准的 .ts 片段与 .m3u8 索引文件，为构建自定义流媒体服务奠定基础。

一、前置准备

1. 安装依赖

确保系统已安装 FFmpeg（建议 4.0+ 版本），并安装 Node.js 依赖：

复制代码

npm install fluent-ffmpeg

💡 提示：可通过 ffmpeg -version 验证 FFmpeg 是否可用。若未安装，请参考 FFmpeg 官网或使用包管理器（如 brew install ffmpeg / apt install ffmpeg）。

2. 目录结构规划

建议创建清晰的输出目录，例如：

复制代码

/output/
  ├── master.m3u8          # 主播放列表（可选）
  ├── stream_720p/         # 720p 分辨率子流
  │   ├── index.m3u8
  │   └── segment_0.ts, segment_1.ts, ...
  └── stream_480p/         # 480p 子流（多码率场景）

二、基础 HLS 切片实现

以下代码将单个输入视频转码为固定分辨率的 HLS 流：

复制代码

const ffmpeg = require('fluent-ffmpeg');
const path = require('path');

// 输入与输出配置
const inputPath = './input.mp4';
const outputDir = './output/stream_720p';
const playlistName = 'index.m3u8';

// 确保输出目录存在（可使用 fs.mkdirSync 或 mkdirp）

ffmpeg(inputPath)
  .addOption('-profile:v', 'baseline')        // 兼容性最佳的 H.264 profile
  .addOption('-level', '3.0')
  .addOption('-start_number', 0)
  .addOption('-hls_time', 10)                 // 每个 ts 片段时长（秒）
  .addOption('-hls_list_size', 0)             // 0 表示保留所有片段（点播）
  .addOption('-f', 'hls')                     // 输出格式为 HLS
  .addOption('-hls_segment_filename', path.join(outputDir, 'segment_%03d.ts'))
  .output(path.join(outputDir, playlistName))
  .on('end', () => {
    console.log('✅ HLS 转码与切片完成！');
  })
  .on('error', (err) => {
    console.error('❌ 转码失败:', err.message);
  })
  .run();

关键参数说明：

-hls_time 10：每个 .ts 文件约 10 秒（实际可能略长，FFmpeg 会在关键帧处切割）；
-hls_list_size 0：生成完整播放列表（适用于点播）；若为直播可设为正整数（如 5）仅保留最近 N 个片段；
-hls_segment_filename：指定片段命名模板，%03d 表示三位数字序号（000, 001...）；
-profile:v baseline -level 3.0：确保最大设备兼容性（尤其移动端）。

三、进阶：多码率自适应 HLS（ABR）

为支持不同网络环境下的流畅播放，可生成多个分辨率/码率的子流，并创建主播放列表（master playlist）：

复制代码

const resolutions = [
  { name: '480p', width: 854, bitrate: '800k' },
  { name: '720p', width: 1280, bitrate: '2000k' },
  { name: '1080p', width: 1920, bitrate: '4000k' }
];

const generateVariant = (input, res) => {
  const dir = `./output/stream_${res.name}`;
  return new Promise((resolve, reject) => {
    ffmpeg(input)
      .videoCodec('libx264')
      .audioCodec('aac')
      .size(`${res.width}x?`)               // 高度自动保持比例
      .videoBitrate(res.bitrate)
      .audioBitrate('128k')
      .addOption('-profile:v', 'main')
      .addOption('-preset', 'fast')
      .addOption('-hls_time', 6)
      .addOption('-hls_list_size', 0)
      .addOption('-f', 'hls')
      .addOption('-hls_segment_filename', `${dir}/segment_%03d.ts`)
      .output(`${dir}/index.m3u8`)
      .on('end', resolve)
      .on('error', reject)
      .run();
  });
};

// 并行生成所有变体
Promise.all(resolutions.map(r => generateVariant('./input.mp4', r)))
  .then(() => {
    // 生成主播放列表 master.m3u8
    const masterPath = './output/master.m3u8';
    let masterContent = '#EXTM3U\n#EXT-X-VERSION:3\n';
    
    resolutions.forEach(r => {
      masterContent += `#EXT-X-STREAM-INF:BANDWIDTH=${parseInt(r.bitrate)*1000},RESOLUTION=${r.width}x${Math.round(r.width * 9 / 16)}\n`;
      masterContent += `stream_${r.name}/index.m3u8\n`;
    });

    require('fs').writeFileSync(masterPath, masterContent);
    console.log('✅ 多码率 HLS 流生成完成！');
  })
  .catch(console.error);

📌 注意：主播放列表中的 BANDWIDTH 单位为 bps（比特/秒），需将 '800k' 转换为 800000。

四、优化与注意事项

关键帧对齐：为确保多码率流切换平滑，各变体应使用相同的关键帧间隔（GOP）。可添加：
复制代码
```
.addOption('-g', 60)  // GOP = 60 帧（假设 30fps，则每 2 秒一个关键帧）
```
音频统一处理：避免每个变体重复编码音频，可先提取 AAC 音频，再复用。
CDN 与缓存 ：.m3u8 文件应设置短缓存（如 Cache-Control: max-age=2），而 .ts 文件可长期缓存。
错误处理：生产环境中需监控 FFmpeg 进程、磁盘空间及输入文件有效性。
性能考量：高分辨率视频转码消耗大量 CPU，建议使用工作队列或云函数异步处理。

五、验证与播放

生成完成后，可通过以下方式测试：

本地 HTTP 服务 （因 HLS 需通过 HTTP 加载）：
复制代码
```
npx http-server ./output -p 8080
```
播放地址 ：http://localhost:8080/master.m3u8
播放器 ：使用 hls.js（浏览器）或原生 Safari / iOS AVPlayer。

结语

借助 fluent-ffmpeg，开发者可以高效、灵活地将任意视频资产转化为标准 HLS 流，无需深入 FFmpeg 命令细节。无论是构建点播平台、直播回看系统，还是为移动应用提供自适应视频服务，这一方案都提供了坚实的技术基础。未来还可结合对象存储（如 S3）、边缘计算与实时转码服务，打造端到端的云原生流媒体架构。

让视频流动起来，从一行代码开始。