简介：面向Android开发者的Lame4Android源码与示例包，集成了著名的LAME MP3编码器与JNI本地调用能力，帮助开发者在移动端把PCM原始音频转换为高质量MP3，适合音乐分享、语音记录、语音备忘等常见移动开发场景。资源包共419个文件，压缩包约11.12MB，整体是一套可编译运行的Android工程；除lame.c、bitstream.c等核心C语言编码源码和配套头文件外，还包含so动态库、Java封装类、Eclipse与Android Studio工程配置、可直接安装的Lame4AndroidDemo.apk示例，以及用于跟踪编译链接过程的o、d等中间产物。目前已有528人浏览学习，适合正在做录音、音频处理或音乐类应用的Android工程师。通过源码与示例，既能快速理解可变比特率、平均比特率、恒定比特率等编码方式的适用场景，掌握JNI调用本地库的完整写法；也能从LAME核心算法中了解心理声学模型、量化与比特流封装等技术要点，并借鉴多设备兼容与性能优化经验，直接用于自己的二次开发。包内文件组织清晰，便于按源码、库、工程配置和演示应用分类查阅，也方便快速移植到现有项目。
1. 项目概述与核心思路
1.1 Lame4Android 是什么？为什么 Android 项目需要它
Lame4Android 是 LAME 编码器在 Android 平台上的 JNI 封装项目。后台服务或客户端应用需要把原始音频数据（PCM）转成 MP3 格式时，底层调用的几乎都是 LAME——这是一个由开源社区维护了二十多年的 C 语言 MP3 编码库。Lame4Android 所做的工作，就是按照 Android 的 JNI 规范把 LAME 的 C 接口暴露成 Java 可调用的方法，再通过 NDK 编译成 so 动态库供应用使用。
我在做录音类 App 时，需要在录音结束后把音频导出成 MP3 文件。Android 自带的 MediaRecorder 虽然也可以输出 MP3，但实现依赖硬件厂商，很多低端机走了 AAC 或者直接报错，代码很难统一。后来改成“AudioRecord 采集 PCM + Lame4Android 编码 MP3”的方案，全机型表现一致，导出的文件在 PC、手机、车载系统上都能正常播放。如果你也有类似的跨端播放需求，Lame4Android 就是目前最省事的路径。
1.2 为什么推荐源码集成而不是直接用第三方封装
GitHub 上有不少预编译好的 Lame4Android 库，直接加依赖就能用，但我不推荐在正式项目里这么干。首先是版本问题，很多预编译库还停留在老 NDK 时代，so 文件对高版本 Android 的兼容性、自带的 LAME 版本里的安全修复情况都不好评估。其次是灵活性，预编译库通常只开了默认编码参数，想要更高码率、开启 VBR、调整内部频率补偿等个性化设置时，几乎没法改。
源码集成听起来麻烦，其实只多花十几分钟配置。拉下 Lame4Android 源码后，把 libmp3lame 核心源码和 JNI 包装层一起放进 CMake 工程，编译出来的 so 完全受自己控制。比如我做短视频项目时，为了减少 APK 体积，在 CMake 里只编译了编码器需要的源文件，去掉了 LAME 自带的解码和分析工具，最终 so 比完整编译小了约 30%。这种裁剪能力，是任何预编译包都给不了你的。
2. 源码结构：把 Lame4Android 拆开看清楚
2.1 核心目录与文件职责
以 GitHub 上常见的 Lame4Android 仓库为例，核心目录通常包括：
- libmp3lame/：LAME 的原始 C 源码目录，这里有 lame.h、lame_enc.c、psymodel.c 等文件。真正的编码逻辑全在这一层。
- jni/：JNI 桥接层源码，包含 lame4android.c 或类似命名的文件，负责把 C 接口包装成 Java 能加载的 native 方法。同时还有 Android.mk 或 CMakeLists.txt，指定了如何把库和桥接层编译成 so。
- java/com/lame4android/：Java 侧封装类，比如 SimpleLame.java，定义了 init、encode、close 这几个静态 native 方法，并提供 PCM 数据编码的对外入口。
- 示例 Module：仓库里通常会带一个 Demo App，演示了录音、读取 PCM 文件、编码 MP3 的完整流程。
我建议你在看代码前先做一件事：把 libmp3lame/lame.h 打开，浏览一遍注释里的编码器选项结构体 lame_global_flags 和相关函数声明。整个 Lame4Android 的 JNI 层其实就是围绕这几个函数做转发的，理解了这层关系，后面所有配置参数的用途就一目了然。
2.2 JNI 桥接层到底做了什么
JNI 桥接层是理解 Lame4Android 的关键。以 SimpleLame.java 为例，它声明了三个 native 方法：
public static native void init(int sampleRate, int channels, int bitRate); public static native int encode(short[] pcm, int len); public static native void close();对应到 C 层，Java_com_lame4android_SimpleLame_init 函数会先调用 lame_init() 创建编码器句柄，再根据传入的采样率、声道数、码率设置编码参数。encode 走的是 lame_encode_buffer 或 lame_encode_buffer_interleaved，把 short 类型的 PCM 数据填进 LAME 内部缓冲区，编码完成后把 MP3 字节流写回 Java 层。close 则负责调用 lame_encode_flush 刷新尾部数据和 lame_close 释放内存。
新手最容易忽略的一层是：JNI 层和 Java 层之间传递的是 short[] 而不是 byte[]，因为 PCM 裸数据通常以 16bit 采样深度存储。我有一次用 jbyteArray 当作 short[] 传下去，编码出来全是刺耳的噪声，检查半天才发现是 JNI 类型签名写错了。所以阅读 JNI 源码时，重点关注数组类型签名是否和 Java 声明一致。
3. 环境准备与编译配置：NDK + CMake 一站式搞定
3.1 NDK 与 CMake 版本怎么选
Lame4Android 是 C 项目，编译必然涉及 NDK 工具链。从 Android Studio 4.2 起，NDK r23 把默认编译器从 GCC 换成了 Clang，LAME 官方源码因为是老项目，会有个别警告或与 Clang 不兼容的地方，但只要 NDK 版本不是太老，基本都能编译过。建议用 Android Studio 自带的 SDK Manager 安装 NDK 24 或 25，同时保持 CMake 版本在 3.22 以上。我实测过 NDK r25 + CMake 3.22 的组合，一次编译通过，没有遇到链接问题。
如果你之前装过老的 NDK r17 或更早版本，建议先卸载干净。老 NDK 的 sysroot 结构不同，很多开源项目在 r23 之后的编译方式会发生变化，混用容易产生 undefined reference 这类典型的链接错误。
3.2 完整 CMakeLists.txt 配置与 ABI 支持
我会把 Lame4Android 的源码直接放到 app/src/main/cpp 目录下，再写一份 CMakeLists：
cmake_minimum_required(VERSION 3.22.0) project("lame4android") set(CMAKE_C_STANDARD 99) set(CMAKE_CXX_STANDARD 17) include_directories(${CMAKE_CURRENT_SOURCE_DIR}/libmp3lame) add_library(lame4android SHARED jni/lame4android.c libmp3lame/bitstream.c libmp3lame/encode.c libmp3lame/gain_analysis.c libmp3lame/psymodel.c libmp3lame/quantize.c libmp3lame/quantize_pvt.c libmp3lame/reservoir.c libmp3lame/set_get.c libmp3lame/tables.c libmp3lame/takehiro.c libmp3lame/util.c libmp3lame/vbrquantize.c libmp3lame/VbrTag.c libmp3lame/version.c libmp3lame/mpglib_interface.c libmp3lame/fht.c libmp3lame/lame.c libmp3lame/newmdct.c )注意我特意没有把 libmp3lame 目录下全部 .c 文件都加进来，只加了编码器真正需要的部分。如果你拉到的源码版本里有 fft.c、id3tag.c 这类文件，大概率也要编译进去，具体看 Makefile.am 里编码器目标的 SOURCES 清单，一份份对照即可。这样既加快编译速度，也避免编译一些用不到的分析工具代码产生额外依赖。
Java 侧加载库的方式：
static { System.loadLibrary("lame4android"); }注意 loadLibrary 的名字要和 CMake 的 add_library 名字一致，大小写和前后缀都会影响加载。最常见的问题是写成 System.loadLibrary("liblame4android")，一加载就抛 UnsatisfiedLinkError，因为系统会自动补 lib 和 .so，不能手动加前缀。
4. 核心编码流程与关键参数设置
4.1 初始化编码器：采样率、声道、码率的正确姿势
初始化阶段做的事情，一句话总结就是：创建句柄、设置参数、调用 lame_init_params 让参数生效。对应到 JNI 封装里，init 方法通常长这样：
lame_t lame_global = NULL; JNIEXPORT void JNICALL Java_com_lame4android_SimpleLame_init( JNIEnv *env, jclass cls, jint sampleRate, jint channels, jint bitRate) { if (lame_global != NULL) { lame_close(lame_global); } lame_global = lame_init(); lame_set_num_channels(lame_global, channels); lame_set_in_samplerate(lame_global, sampleRate); lame_set_out_samplerate(lame_global, sampleRate); lame_set_brate(lame_global, bitRate); lame_set_quality(lame_global, 2); lame_set_VBR(lame_global, vbr_default); lame_init_params(lame_global); }几个关键参数具体说下我的设置。sampleRate 要和 PCM 数据的实际采样率完全一致，否则编码后音频会变速。常见组合是 44100Hz 或 48000Hz。channels 表示输入 PCM 的声道数，传入 2 时表示双声道交错存储，第 1 个 short 是左声道、第 2 个 short 是右声道。bitRate 是 MP3 的目标码率，128kbps 适合语音，192kbps 以上适合音乐。
vbr_default 表示开启可变码率，LAME 会按音频复杂度动态分配码率，同码率下音质上限更高。但要注意，VBR 文件在个别旧设备的音乐播放器上可能出现时长显示不准的问题，如果你的用户群体大量使用老设备，建议改成 vbr_off 并使用固定码率。
4.2 编码循环：缓冲区大小与返回值处理
MP3 编码不是一个“给一段 PCM 就立刻吐一段 MP3”的过程。LAME 内部有缓冲机制，只有在累积够一帧（通常 1152 个采样点）后才会开始编码。所以编码循环要写成这样：
JNIEXPORT jbyteArray JNICALL Java_com_lame4android_SimpleLame_encode( JNIEnv *env, jclass cls, jshortArray pcm, jint len) { jshort *pcm_buffer = (*env)->GetShortArrayElements(env, pcm, NULL); int buffer_size = (int) (1.25 * len + 7200); unsigned char *mp3_buffer = malloc(buffer_size); int recv_size = lame_encode_buffer(lame_global, pcm_buffer, NULL, len, mp3_buffer, buffer_size); // 把 mp3_buffer 转成 jbyteArray 返回给 Java ... }这里的 buffer_size 用 1.25 * len + 7200 计算，来自 LAME API 的官方建议，目的是保证编码后的 MP3 数据不会超出缓冲区。实际上一次编码产生的 MP3 字节数通常会少于 PCM 数据量，但这个上限估算公式在所有采样率下都足够安全，省去了动态长度判断。
编码循环里最需要关注的是 lame_encode_buffer 的返回值：返回正数表示编码出了多少字节的 MP3 数据，返回 0 表示 PCM 数据还不够攒满一帧、暂时没有输出，返回负数则代表出错。很多人把返回值当成错误码直接丢弃，结果输出文件缺失一段数据，播放时能明显听到断断续续的“咔哒”声。
4.3 收尾：flush 和 close 的顺序不能乱
编码循环结束后，必须调用 lame_encode_flush 让 LAME 把内部缓冲区剩余的数据全部输出。这步不调用，MP3 文件末尾会缺几十到几百毫秒的音频，播放时明显感觉“最后一句没说完”。
JNIEXPORT jbyteArray JNICALL Java_com_lame4android_SimpleLame_flush(JNIEnv *env, jclass cls) { unsigned char mp3_buffer[7200]; int recv_size = lame_encode_flush(lame_global, mp3_buffer, sizeof(mp3_buffer)); // 返回 jbyteArray }执行完 flush 之后，再调用 lame_close 释放句柄。顺序不能反，先 flush 再 close 是必须遵守的，因为 lame_close 会直接清空内部状态，
本文还有配套的精品资源，点击获取
