English

本工具主要用于将微信语音 amr 格式转换为 mp3 格式以便在 html5 的 audio 标签中进行播放。

支持 Linux/Windows/Mac 平台

因为是基于 JAVE 项目的修改，而 JAVE 是依赖 ffmpeg 所以可以适用于所有 ffmpeg 所支持的文件格式的转换。具体可以查看 JAVE 官方文档

使用示例

引入 maven 依赖

 <dependency>
    <groupId>com.github.dadiyang</groupId>
    <artifactId>jave</artifactId>
    <version>1.0.6</version>
 </dependency>

调用 AudioUtils.amrToMp3 方法

public void amrToMp3()  {
    File source = new File("target/test-classes/material/testAudio.amr");
    File target = new File("testAudio.mp3");
    AudioUtils.amrToMp3(source, target);
}

原理

1. 初始化时判断当前运行环境，将 bin 目录中对应的 ffmpeg 可执行文件拷贝到临时目录中
2. 根据文件类型及配置通过 Runtime.getRuntime().exec(cmd) 执行 ffmpeg 对应的转码命令

JAVE 项目的问题

ffmpeg 是依赖运行环境的，JAVE 项目封装了 ffmpeg，它通过上述的原理使 java 可以调用 ffmpeg 而且支持跨平台。

1. 项目老旧没再维护。官网最近版本是 2009 年发布的，其依赖的 ffmpeg 早已过时，很多情况下用不了。
2. 转码一直报异常 EncoderException: Stream mapping
3. 没有发布 maven 仓库，而且 JAVE 本身也不是一个 maven 项目
4. 不支持 mac

本项目特点

本项目为解决上述问题而生。

• 这是一个 maven 项目，而且已发布到中央仓库。
• 项目依赖的 ffmpeg 可执行文件经过验证可以使用（单元测试中提供了一个简单的检验方法）
• 解决了 amr 转 mp3 出现的 EncoderException: Stream mapping
• 支持 Linux/Windows/Mac 平台

扩展

如果程序无法通过拷贝资源文件的方式获取到 ffmpeg 的可执行文件或者内置的 ffmpeg 不支持你所使用的操作系统

你可以通过环境变量或者在 java 中设置 System.setProperty("ffmpeg.home", "ffmpeg 可执行文件所在的目录") 的方式指定你的系统中安装的可用的 ffmpeg 文件的目录

如 System.setProperty("ffmpeg.home", "/usr/local/bin/")

参考

本工具使用 JAVE 源码改造而来

借鉴 xiaoymin 的代码

参考 解決 linux AMR 轉 MP3 出現轉碼成功卻無法播放的問題

LICENSE

JAVE 项目是基于 GPL 协议的开源项目，本项目是在 JAVE 的基础上进行修改和增强，因此也采用 GPL 协议开源。

JAVE) is Free Software and it is licensed under GPL.