Android LAME原生音频

前言

我想大家都做过录音的功能吧，首先想到的是不是MediaRecorder？今天我们不用MediaRecorder，而是使用LAME库自己编译音频编码模块，很明显，这个需要用到NDK。凡是涉及到音视频编解码这块的，都需要用到Android NDK(Native Development Kit)，原生开发工具包。即使用C/C++代码实现音频的采样和编码，然后使用Java去调用原生模块实现录音功能。

音视频相关基础知识

我来简单过一下基础的音视频相关知识。

Audio Sample：音频采样，通常指录制音频采样文件PCM的过程，PCM（脉冲编码调制）是一种音频流，称为裸流。人耳听到的是模拟信号，PCM是把声音从模拟信号转化为数字信号的技术。

Audio Track：音轨，封装格式的音频文件通常由多个音轨组成，比如MP3文件就是一种封装格式的音频文件，与之相对的就是音频原始采样数据PCM。比如一首歌，歌声是一个音轨，吉他声、鼓声等一些混合在其中的声音各自也是一个音轨。

Audio Channel：声道，比如左声道、右声道和环绕立体声。

Bitrate：比特率，俗称码率。它直接决定声音的清晰度即声音特征的详细程度，SQ、HQ音质是通过它来判断的，码率越高，音频文件越大，质量也越高。

Sample Rate：采样率，大多数沿用国际通用的标准采样率，即44.100kHZ或者48.000kHZ，肯定是不能录制超声波和次声波的，因为人耳感知不到。

录音和播放声音的详细过程。

录音：音频采样编码->音频封装

播放声音：音频解封装->音频解码播放

录音首先采样并编码得到PCM文件，然后封装PCM文件为MP3、WAV、FLAC等文件，播放声音首先也要解封装成PCM文件，然后对PCM文件解码播放。

编译共享库so

编译共享库so的过程有两种方式，一种是使用ndk-build+Android.mk+Application.mk，一种是CMake+CMakeLists.txt。今天我们采用最原始的方式，mk文件。其实Android.mk和CMakeLists.txt很多东西是一一对应的。

C文件

Android.mk

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LAME_LIBMP3_DIR := lame-3.100_libmp3lame

LOCAL_MODULE    := mp3lame

LOCAL_SRC_FILES :=\
$(LAME_LIBMP3_DIR)/bitstream.c \
$(LAME_LIBMP3_DIR)/fft.c \
$(LAME_LIBMP3_DIR)/id3tag.c \
$(LAME_LIBMP3_DIR)/mpglib_interface.c \
$(LAME_LIBMP3_DIR)/presets.c \
$(LAME_LIBMP3_DIR)/quantize.c \
$(LAME_LIBMP3_DIR)/reservoir.c \
$(LAME_LIBMP3_DIR)/tables.c  \
$(LAME_LIBMP3_DIR)/util.c \
$(LAME_LIBMP3_DIR)/VbrTag.c \
$(LAME_LIBMP3_DIR)/encoder.c \
$(LAME_LIBMP3_DIR)/gain_analysis.c \
$(LAME_LIBMP3_DIR)/lame.c \
$(LAME_LIBMP3_DIR)/newmdct.c \
$(LAME_LIBMP3_DIR)/psymodel.c \
$(LAME_LIBMP3_DIR)/quantize_pvt.c \
$(LAME_LIBMP3_DIR)/set_get.c \
$(LAME_LIBMP3_DIR)/takehiro.c \
$(LAME_LIBMP3_DIR)/vbrquantize.c \
$(LAME_LIBMP3_DIR)/version.c \
MP3Encoder.c

include $(BUILD_SHARED_LIBRARY)

• LOCAL_PATH :=$(call my-dir)
  当前文件在系统中的路径，必须为Android.mk文件的第一行。
• include $(CLEAR_VARS)
  清除上一次构建中的全局变量，开始一次新的编译。
• LOCAL_MODULE
  生成的模块的名称，这里是动态库so文件的名称，so文件的名称拼接为lib「模块名」.so
  该模块的编译的目标名，用于区分各个模块，名字必须是唯一并不包含空格的，如果编译目标是 so 库，那么该 so 库的名称就是 lib 项目名 .so。
• LOCAL_SRC_FILES
  要编译的.c或.cpp文件，.h和.hpp文件可以不用出现在这里，系统会自动包含。
• include $(BUILD_SHARED_LIBRARY)
  include开头的是构建系统的内置变量，此行代码的意思是构建动态库，也称共享库，还有以下几种取值。
  BUILD_STATIC_LIBRARY: 构建静态库。
  PREBUILT_STATIC_LIBRARY: 将静态库包装成一个模块。
  PREBUILT_SHARED_LIBRARY: 将静态库包装成一个模块。
  BUILD_EXECUTABLE: 构建可执行文件。

Application.mk

APP_ABI := armeabi  armeabi-v7a  arm64-v8a  x86  x86_64  mips  mips64
APP_MODULES := mp3lame
APP_CFLAGS += -DSTDC_HEADERS
APP_PLATFORM := android-21

• APP_ABI ABI（Application Binary Interface）应用二级制接口，这是一种计算机科学中的概念，用于描述软件库或操作系统与应用程序之间的二进制通信方式。它跟CPU指令集对应。
• APP_MODULES 指定模块
• APP_FLAGS 指定编译过程的flag，“DSTDC_HEADERS” 是一个编程中常见的宏定义，通常用于检查标准库头文件是否已经包含。这个宏定义通常在C/C++代码中使用，用于确保标准库的头文件已经正确包含，以便程序可以正常编译和运行。如果没有正确包含标准库头文件，编译器可能会报错或者出现未定义的行为。
• APP_PLATFORM 指定创建的动态库的平台。

与JNI相关的文件

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>

#ifndef _Included_Mp3Encoder
#define _Included_Mp3Encoder
#ifdef __cplusplus
extern "C" {
#endif

JNIEXPORT void JNICALL Java_com_dorachat_dorachat_recorder_mp3_Mp3Encoder_init
  (JNIEnv *, jclass, jint, jint, jint, jint, jint);

JNIEXPORT jint JNICALL Java_com_dorachat_dorachat_recorder_mp3_Mp3Encoder_encode
  (JNIEnv *, jclass, jshortArray, jshortArray, jint, jbyteArray);

JNIEXPORT jint JNICALL Java_com_dorachat_dorachat_recorder_mp3_Mp3Encoder_flush
  (JNIEnv *, jclass, jbyteArray);

JNIEXPORT void JNICALL Java_com_dorachat_dorachat_recorder_mp3_Mp3Encoder_close
  (JNIEnv *, jclass);

#ifdef __cplusplus
}
#endif
#endif

lame的jni层主要定义4个方法init、encode、flush和close。

#include "lame-3.100_libmp3lame/lame.h"
#include "Mp3Encoder.h"

static lame_global_flags *glf = NULL;

JNIEXPORT void JNICALL Java_com_dorachat_dorachat_recorder_mp3_Mp3Encoder_init(
        JNIEnv *env, jclass cls, jint inSamplerate, jint outChannel,
        jint outSamplerate, jint outBitrate, jint quality) {
   
   
    if (glf != NULL) {
   
   
        lame_close(glf);
        glf = NULL;
    }
    glf = lame_init();
    lame_set_in_samplerate(glf, inSamplerate);
    lame_set_num_channels(glf, outChannel);
    lame_set_out_samplerate(glf, outSamplerate);
    lame_set_brate(glf, outBitrate);
    lame_set_quality(glf, quality);
    lame_init_params(glf);
}

JNIEXPORT jint JNICALL
Java_com_dorachat_dorachat_recorder_mp3_Mp3Encoder_encode(
        JNIEnv *env, jclass cls, jshortArray buffer_l, jshortArray buffer_r,
        jint samples, jbyteArray mp3buf) {
   
   
    jshort* j_buffer_l = (*env)->GetShortArrayElements(env, buffer_l, NULL);

    jshort* j_buffer_r = (*env)->GetShortArrayElements(env, buffer_r, NULL);

    const jsize mp3buf_size = (*env)->GetArrayLength(env, mp3buf);
    jbyte* j_mp3buf = (*env)->GetByteArrayElements(env, mp3buf, NULL);

    int result = lame_encode_buffer(glf, j_buffer_l, j_buffer_r,
            samples, j_mp3buf, mp3buf_size);

    (*env)->ReleaseShortArrayElements(env, buffer_l, j_buffer_l, 0);
    (*env)->ReleaseShortArrayElements(env, buffer_r, j_buffer_r, 0);
    (*env)->ReleaseByteArrayElements(env, mp3buf, j_mp3buf, 0);

    return result;
}

JNIEXPORT jint JNICALL
Java_com_dorachat_dorachat_recorder_mp3_Mp3Encoder_flush(
        JNIEnv *env, jclass cls, jbyteArray mp3buf) {
   
   
    const jsize mp3buf_size = (*env)->GetArrayLength(env, mp3buf);
    jbyte* j_mp3buf = (*env)->GetByteArrayElements(env, mp3buf, NULL);

    int result = lame_encode_flush(glf, j_mp3buf, mp3buf_size);

    (*env)->ReleaseByteArrayElements(env, mp3buf, j_mp3buf, 0);

    return result;
}

JNIEXPORT void JNICALL Java_com_dorachat_dorachat_recorder_mp3_Mp3Encoder_close(
        JNIEnv *env, jclass cls) {
   
   
    lame_close(glf);
    glf = NULL;
}

这个需要你会一点C语言的基础，然后就可以轻松调用lame库的函数了。

package com.dorachat.dorachat.recorder.mp3;

public class Mp3Encoder {
   
   

    static {
   
   
        System.loadLibrary("mp3lame");
    }

    public native static void close();

    public native static int encode(short[] buffer_l, short[] buffer_r, int samples, byte[] mp3buf);

    public native static int flush(byte[] mp3buf);

    public native static void init(int inSampleRate, int outChannel, int outSampleRate