返回

用 Java + FFmpeg 实现 MP4 转 m3u8:初学者友好指南 🎓

原创
admin的头像admin·发布于 2025-07-16 12:30·阅读 95

🧭 一、HLS & m3u8 简介:适合学生初学者理解

  • **HLS(HTTP Live Streaming)**是一种由苹果提出的流媒体协议,会将视频切成多个 TS 片段,并通过 .m3u8 播放列表管理这些片段 ([funvisiontutorials.com][1])。
  • 适用于网络环境不佳的场景,能动态切换视频清晰度,保证用户稳定观看体验。

常用 FFmpeg 命令行示例:

bash 复制代码
ffmpeg -i input.mp4 \
  -codec: copy \
  -hls_time 10 \
  -hls_list_size 0 \
  -start_number 0 \
  -f hls output.m3u8
  • -codec: copy:无损复制音视频流
  • -hls_time:每片段长度(秒)
  • -hls_list_size 0:输出完整播放列表 ([funvisiontutorials.com][1], [mux.com][2])

二、环境准备:安装 FFmpeg

  1. 下载:访问 FFmpeg 官网或你的系统包管理器安装 ([funvisiontutorials.com][1])。

三、用 Java 调用 FFmpeg 转码

方法一:使用 ProcessBuilder

java 复制代码
String cmd = String.join(" ", Arrays.asList(
  "ffmpeg -i", inputMp4,
  "-codec: copy",
  "-hls_time 10",
  "-hls_list_size 0",
  "-start_number 0",
  "-f hls", outputM3u8
));
ProcessBuilder pb = new ProcessBuilder(cmd.split(" "));
pb.redirectErrorStream(true);
Process process = pb.start();
// 读取 process.getInputStream(),并等待结束
  • 完整示例可参考 2 个月前更新的教程 ([comate.baidu.com][3])
  • 注意捕获输出,并确保 ffmpegPATH 中。

方法二:使用 JavaCV

  • JavaCV 提供对 FFmpeg 的封装,可在 Java 中直接调用,更适合集成。最近有文章介绍其将 FFmpeg 功能封装在 Java 中调用 。

四、常见问题 & 优化技巧

✅ TS 片段时长不生效?

  • 若加了 -codec: copy,FFmpeg 不一定按 -hls_time 切分。
  • 解决方案:remove -copy,或加 -force_key_frames "expr:gte(t,n_forced*10)" 强制关键帧切分 ([Gist][4])。

✅ 自定义切片时间

bash 复制代码
ffmpeg -i input.mp4 \
  -force_key_frames "expr:gte(t,n_forced*4)" \
  -hls_time 4 \
  ...

强制每 4 秒生成关键帧,有助于精确切片。

✅ 批量转换 & 监控

  • 可用脚本循环调用 FFmpeg。
  • 使用 process.waitFor() 来统计耗时 ([comate.baidu.com][3])。

五、完整示例:Java + FFmpeg 端到端

java 复制代码
public boolean convertMp4ToM3u8(String mp4, String outDir) throws IOException, InterruptedException {
    Files.createDirectories(Paths.get(outDir));
    String m3u8Path = outDir + "/video.m3u8";
    List<String> cmd = Arrays.asList(
      "ffmpeg", "-i", mp4,
      "-codec: copy",
      "-force_key_frames", "expr:gte(t,n_forced*6)",
      "-hls_time", "6",
      "-hls_list_size", "0",
      "-start_number", "0",
      "-f", "hls", m3u8Path
    );
    ProcessBuilder pb = new ProcessBuilder(cmd);
    Process process = pb.inheritIO().start();
    int code = process.waitFor();
    return code == 0;
}

六、在浏览器和 CDN 部署

  • 转好 m3u8 + TS 后,可用任何 HTTP 服务器(如 Nginx)发布。
  • 前端通过 <video src="path/video.m3u8"> 或 Video.js 播放。
  • 若要支持多清晰度、自适应码率,建议打包 VOD/HLS 多清晰版本并生成 master.m3u8 ([腾讯云][5], [博客园][6], [OTTVerse][7])。

🔚 小结

步骤 内容
1 理解 HLS 原理及使用场景
2 安装并验证 FFmpeg 环境
3 用 Java 调用 FFmpeg 命令行完成转码
4 修复切片时长问题,添加 key frame
5 部署输出至服务器,完成前端播放

这篇文章帮你从零开始构建一个完整的 MP4 → m3u8 转码链条,适合学生初学者理解和实操。欢迎你后续加上并发优化、自动化脚本等高级功能,加深理解与应用!


作者的其他文章
IP地址配置HTTPS 内网IP配置HTTPS保姆教程
本文介绍了在Nginx中配置HTTPS的完整流程:1)使用OpenSSL生成自签名证书和私钥;2)解密私钥以避免重启时输入密码;3)配置Nginx支持HTTPS,包括指定证书路径、设置安全协议和加密套件等。适用于开发、测试和内网环境,但需注意自签名证书会触发浏览器警告,生产环境建议使用CA签发的正式证书。通过简单的命令和配置即可实现基本的HTTPS加密保护。
IP地址配置HTTPS 内网IP配置HTTPS保姆教程
Docker 数据目录迁移完整指南:从 /var/lib/docker 迁移到自定义路径
本文介绍了将 Docker 数据目录从 /var/lib/docker 迁移到自定义路径 /data2/docker/data 的完整过程,包括停止 Docker 服务、复制数据、修改配置文件及验证数据完整性。提供了常见问题的解决方案,帮助用户在空间不足时顺利迁移 Docker 数据。
Docker 数据目录迁移完整指南:从 /var/lib/docker 迁移到自定义路径
2025年必备:让Nginx配置清晰如诗的工具推荐
文章浏览阅读464次,点赞4次,收藏4次。本文介绍了格式化Nginx配置文件的重要性,指出良好格式能提升可读性、团队协作效率和降低错误风险。文章推荐了2025年优秀的在线格式化工具,这类工具应具备操作简单、专业格式化效果、安全保障等特性。建议将格式化工具集成到开发流程中,并制定团队规范,以优雅管理Nginx配置。文末推荐了一个专业在线格式化工具,帮助开发者高效处理配置文件。
2025年必备:让Nginx配置清晰如诗的工具推荐
Claude 命令大全:从入门到精通的终端操作指南(2025 最新)
本教程全面整理 *Claude 命令行(CLI)使用指南*,从基础启动命令、项目管理、权限控制、模型切换到高级思考模式,全方位提升开发者在终端中使用 Claude 的效率。适合新手与资深开发者收藏参考。
Claude 命令大全:从入门到精通的终端操作指南(2025 最新)
屏幕检测专家 — 专业的在线屏幕测试工具
屏幕检测专家 — 专业的在线屏幕测试工具
屏幕检测专家 — 专业的在线屏幕测试工具
Keye-VL-1.5-8B(快手 Keye-VL)— 腾讯云两卡 32GB GPU **保姆级** 部署指南(Ubuntu 22.04 / CUDA 12.2 / Driver 535.216.01 / Python 3.10)
保姆级教程:在腾讯云两卡 32GB GPU(Ubuntu 22.04 / CUDA 12.2)上完整部署快手 Keye-VL-1.5-8B。包含驱动安装、conda 环境、PyTorch、bitsandbytes、vLLM、ModelScope 模型下载与 Gradio demo 运行步骤及常见排错。适合工程复现与上线优化。
Keye-VL-1.5-8B(快手 Keye-VL)— 腾讯云两卡 32GB GPU **保姆级** 部署指南(Ubuntu 22.04 / CUDA 12.2 / Driver 535.216.01 / Python 3.10)
Ubuntu系统ECS重启后“/etc/resolv.conf”被还原怎么办?
处理方法 在处理前,建议先禁用systemd-resolved服务。 方法一:手动修改/etc/resolv.conf文件。 以root用户登录ECS。 关闭并禁用systemd-resolved服务
共享打印机报错连不上怎么办?修复错误代码(0x000006d9/0x0000011b 等)最新Win10/11 共享打印机常见问题 + 解决教程,附工具!
Win11 打印机共享报错全面修复指南:涵盖 0x000006d9、0x0000011b、0x0000007e 等常见码,并提供一键 PowerShell 工具,十分钟内搞定老款惠普共享打印机。
共享打印机报错连不上怎么办?修复错误代码(0x000006d9/0x0000011b 等)最新Win10/11 共享打印机常见问题 + 解决教程,附工具!
实战Spring Boot + Vue 集成 Activiti 工作流引擎 | 双模式简单 & 自定义审批平台
基于 Spring Boot 与 Vue 的高效工作流平台,支持简单模式与自定义模式双引擎,在线流程建模、版本管理、审批节点灵活配置,多渠道消息通知,Docker/K8s 部署,高可用与可扩展。
2025 年国内 Docker/DockerHub 镜像源加速列表(7 月 28 日更新 · 长期维护)
2025 年最新国内 Docker Hub 镜像源加速列表,包含轩辕镜像、腾讯云、阿里云、DaoCloud、AtomHub 等多家稳定 CDN 服务,附详细配置教程与常见问题说明,适用于 Linux、macOS、Windows 平台。
2025 年国内 Docker/DockerHub 镜像源加速列表(7 月 28 日更新 · 长期维护)