AudioTrack与OpenSL ES

Android的SDK提供了MediaPlayer、SoundPool和AudioTrack 三套音频播放的 API。其中AudioTrack适合低延迟的播放,是更加底层的API,提供了非常强大的控制能力,适合流媒体的播放等场景,由于其属于底层API,需要结合解码器来使用。

OpenSL ES全称为Open Sound Library for Embedded Systems,即嵌入式音频加速标准。OpenSL ES是无授权费、跨平台、针对嵌入式系统精心优化的硬件音频加速API。它为嵌入式移动多媒体设备上的本地应用程序开发者提供了标准化、高性能、低响应时间的音频功能实现方法,同时还实现了软/硬件音频性能的直接跨平台部署。本次要介绍的就是AudioTrack与OpenSL ES。

AudioTrack简介

MediaPlayer适合在后台长时间播放本地音乐文件或者在线的流式媒体文件,它的封装度高,且使用简单。

SoundPool适合播放比较短的音频片段,比如按键声、铃声片段、闹钟片段等,它可以同时播放多个音频。

AudioTrack适合低延迟的播放,是更加底层的API,提供了非常强大的控制能力,适合流媒体的播放等场景,由于其属于底层API,需要结合解码器来使用。

AudioTrack工作流程

由于AudioTrack是Android的最底层的音频播放API,只允许输入裸数据。所以它需要自行实现解码操作和缓冲区控制。因为这里只涉及AudioTrack的音频渲染端,那么如何使用AudioTrack渲染音频PCM数据呢?

首先来看一下AudioTrack的工作流程,具体如下。 1、根据音频参数信息,配置出一个AudioTrack的实例。 2、调用play方法,将AudioTrack切换到播放状态。 3、启动播放线程,循环向AudioTrack的缓冲区中写入音频数据。 4、当数据写完或者停止播放的时候,停止播放线程,并且释放所有资源。

 1public class AudioTrackDemo {
 2
 3    private AudioTrack audioTrack;
 4
 5    // 缓冲区大小
 6    private int minBufferSize;
 7
 8    // 是否停止
 9    private boolean isStop = true;
10
11    // 播放线程
12    private Thread playerThread;
13
14    // 1、初始化AudioTrack
15    private void initAudioTrack(){
16        // 音频管理策略、采样率、声道数、采样格式(数据位宽)、缓冲区大小、播放模式
17
18        // 计算缓冲区大小
19        minBufferSize = AudioTrack.getMinBufferSize(48000, 2, AudioFormat.ENCODING_PCM_16BIT);
20
21        audioTrack = new AudioTrack(
22                AudioManager.STREAM_SYSTEM,
23                48000,
24                2,
25                AudioFormat.ENCODING_PCM_16BIT,
26                minBufferSize,
27                AudioTrack.MODE_STREAM
28        );
29    }
30
31    // 2、将AudioTrack切换到播放状态
32    private void playerMode(){
33        if(audioTrack != null && audioTrack.getState() != AudioTrack.STATE_UNINITIALIZED){
34            audioTrack.play();
35        }
36    }
37
38
39    // 3、开启播放线程
40    public void startPlayThread(){
41        playerThread = new Thread(()->{
42            short[] samples = new short[minBufferSize];
43            while(!isStop) {
44                int actualSize = decoder.readSamples(samples);
45                audioTrack.write(samples, actualSize);
46            }
47        }, "playerThread");
48
49        playerThread.start(); // byte、int short long char 
50    }
51
52    // 4、停止AudioTrack
53    private void stopAudioTrack() throws InterruptedException {
54        if (null != audioTrack && audioTrack.getState() != AudioTrack.STATE_UNINITIALIZED) {
55            audioTrack.stop();
56        }
57
58        // 停止线程
59        isStop = true;
60        if (null != playerThread) {
61            playerThread.join();
62            playerThread = null;
63        }
64
65        // 释放AudioTrack
66        if(audioTrack != null) {
67            audioTrack.release();
68        }
69    }
70}

注意:上述代码中的decoder是一个解码器,此处并未实现,假设已经初始化成功,最后将调用write方法把从解码器中获得的PCM采样数据写入AudioTrack的缓冲区中,注意此方法是阻塞的方法,比如:一般要写入200ms的音频数据需要执行接近200ms的时间。

现在对上面的部分参数进行解释:

音频管理策略:

 1// 电话铃声
 2AudioSystem.STREAM_VOICE_CALL;
 3// 系统铃声
 4AudioSystem.STREAM_SYSTEM;
 5// 铃声
 6AudioSystem.STREAM_RING;
 7// 音乐声
 8AudioSystem.STREAM_MUSIC;
 9// 警告声
10AudioSystem.STREAM_ALARM;
11// 通知声
12AudioSystem.STREAM_NOTIFICATION;

sampleRateInHz:采样率,即播放的音频每秒钟会有没少次采样,可选用的采样频率列表为: 8000 , 16000 , 22050 , 24000 ,32000 , 44100 , 48000 等,大家可以根据自己的应用场景进行合理的选择。

channelConfig: 声道数的配置,可选值以常量的形式配置在类 AudioFormat 中,常用的是 CHANNEL_IN_MONO (单声道)、CHANNEL_IN_STEREO (双声道) ,因为现在大多数手机的麦克风都是伪立体声采集,为了性能考虑,建议使用单声道进行采集。

audioFormat: 该参数是用来配置 “数据位宽” 的,即采样格式,可选值以常量的形式定义在类 AudioFormat 中,分别为 ENCODING_PCM_16BIT (兼容所有手机)、ENCODING_PCM_8BIT。

bufferSizeInBytes: 配置内部的音频缓冲区的大小, AudioTrack 类提供了一个帮助开发者确定的bufferSizeInBytes 的函数,AudioTrack.getMinBufferSize()。建议使用此函数进行计算,而非手动计算。

mode: AudioTrack 提供了两种播放模式,可选的值以常量的形式定义在类 AudioTrack 中,一个是 MODE_STATIC , 需要一次性将所有的数据都写入播放缓冲区中,简单高效,通常用于播放铃声、系统提醒的音频片段;另一个是 MODE_STREAM ,需要按照一定的时间间隔不断地写入音频数据,理论上它可以应用于任何音频播放的场景。

OpenSL ES简介

OpenSL ES定义了一套适用于嵌入式系统、跨平台、且免费的音频处理的API。Android的OpenSL ES库是在NDK的platforms文件夹对应android平台先相应cpu类型里面,如:

下图中描述了 OpenSL ES 的架构,在 Android 中,OpenSL ES则是底层的API,属于C语言API 。在开发中,一般会直接使用高级API , 除非遇到性能瓶颈,如语音实时聊天、3D Audio 、某些 Effects等,开发者可以直接通过 C/C++开发基于OpenSL ES 音频的应用。

OpenSL ES开发流程

在OpenSL ES中,对象是对一组资源及其状态的抽象,每个对象都有一个在其创建时指定的类型,类型决定了对象可以执行的任务集,对象有点类似于C++中类的概念。接口是对象提供的一组特征的抽象,这些抽象会为开发者 提供一组方法以及每个接口的类型功能,在代码中,接口的类型由接口ID来标识(这和FFmpeg的实现是一致的思想,FFmpeg是如何实现面向对象的思想呢?后面我也会举例说明)。

所以一个对象在代码中其实是没有实际的表示形式的,可以通过接口来改变对象的状态以及使用对象提供的功能。对象可以有一个或者多个接口的实例,但是接口实例肯定只属于一个对象。这确实属于如何用C语言实现面向对象的范围了。下面是开发流程:

1、 创建接口对象 2、设置混音器 3、创建播放器(录音器) 4、设置缓冲队列和回调函数 5、设置播放状态 6、启动回调函数

下面这个代码示例用于播放SDCard上的test.pcm文件:

CMakeList.txt

1cmake_minimum_required(VERSION 3.10.2)
2
3project("opensles")
4
5add_library(native-lib SHARED native-lib.cpp)
6
7find_library(log-lib log)
8
9target_link_libraries(native-lib OpenSLES ${log-lib})

native-lib.cpp

  1#include <jni.h>
  2#include <string>
  3
  4extern "C" {
  5#include <SLES/OpenSLES.h>
  6#include <SLES/OpenSLES_Android.h>
  7#include <android/log.h>
  8}
  9
 10// 定义输出的TAG
 11#define LOG_TAG "OpenSL-ES-Demo"
 12
 13#define LOGI(...) __android_log_print(ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__)
 14
 15void bufferQueueCallback(SLAndroidSimpleBufferQueueItf bufferQueue, void *pContext) {
 16    static FILE *fp = nullptr;
 17    static char *buf = nullptr;
 18    if (!buf) {
 19        buf = new char[1024 * 1024];
 20    }
 21    if (!fp) {
 22        fp = fopen("/sdcard/test.pcm", "rb");
 23    }
 24    if (!fp) return;
 25    if (feof(fp) == 0) {
 26        int len = fread(buf, 1, 1024, fp);
 27        if (len > 0) {
 28            (*bufferQueue)->Enqueue(bufferQueue, buf, len);
 29        }
 30    }
 31}
 32
 33extern "C" JNIEXPORT void JNICALL
 34Java_com_tal_opensles_MainActivity_stringFromJNI(        
 35        JNIEnv* env,
 36        jobject) {
 37    SLresult sLResult;
 38    SLObjectItf engineObject;
 39    SLEngineItf slAudioEngine;
 40
 41    // 1. 创建引擎并获取引擎接口
 42    sLResult = slCreateEngine(&engineObject, 0, nullptr, 0, nullptr, nullptr);
 43    if (sLResult != SL_RESULT_SUCCESS) {
 44        LOGI("引擎创建失败");
 45    }
 46    sLResult = (*engineObject)->Realize(engineObject, SL_BOOLEAN_FALSE);
 47    if (sLResult != SL_RESULT_SUCCESS) {
 48        LOGI("引擎初始化失败");
 49    }
 50    sLResult = (*engineObject)->GetInterface(engineObject, SL_IID_ENGINE, &slAudioEngine);
 51    if (sLResult != SL_RESULT_SUCCESS) {
 52        LOGI("获取引擎接口失败");
 53    }
 54
 55    // 2. 创建并初始化混音器
 56    SLObjectItf outputMix;
 57    sLResult = (*slAudioEngine)->CreateOutputMix(slAudioEngine, &outputMix, 0, nullptr, nullptr);
 58    if (sLResult != SL_RESULT_SUCCESS) {
 59        LOGI("创建混音器失败");
 60    }
 61    sLResult = (*outputMix)->Realize(outputMix, SL_BOOLEAN_FALSE);
 62    if (sLResult != SL_RESULT_SUCCESS) {
 63        LOGI("混音器初始化失败");
 64    }
 65
 66    // 3. 配置输入数据源参数
 67    SLDataLocator_AndroidSimpleBufferQueue inputBuffQueueLocator = {SL_DATALOCATOR_ANDROIDSIMPLEBUFFERQUEUE, 10};
 68    SLDataFormat_PCM input_format_pcm = {
 69            SL_DATAFORMAT_PCM,                                // <<< 输入的音频格式,PCM
 70            2,                                  // <<< 输入的声道数,2(立体声)
 71            SL_SAMPLINGRATE_44_1,                            // <<< 输入的采样率,44100hz
 72            SL_PCMSAMPLEFORMAT_FIXED_16,                     // <<< 输入的采样位数,16bit
 73            SL_PCMSAMPLEFORMAT_FIXED_16,                     // <<< 容器大小,同上
 74            SL_SPEAKER_FRONT_LEFT|SL_SPEAKER_FRONT_RIGHT,   // <<< 声道标记,这里使用左前声道和右前声道
 75            SL_BYTEORDER_LITTLEENDIAN                       // <<< 输入的字节序,小端
 76    };
 77    SLDataSource dataSource = {&inputBuffQueueLocator, &input_format_pcm};
 78
 79    SLDataLocator_OutputMix outputMixLocator = {SL_DATALOCATOR_OUTPUTMIX, outputMix};
 80    SLDataSink dataSink = {&outputMixLocator, nullptr};
 81
 82    // 4. 创建播放器
 83    SLObjectItf audioPlayer;
 84    SLAndroidSimpleBufferQueueItf pcmBufferQueue;
 85    SLPlayItf playInterface;
 86    SLInterfaceID audioPlayerInterfaceIDs[] = {SL_IID_ANDROIDSIMPLEBUFFERQUEUE};
 87    SLboolean audioPlayerInterfaceRequired[] = {SL_BOOLEAN_TRUE};
 88
 89    sLResult = (*slAudioEngine)->CreateAudioPlayer(slAudioEngine, &audioPlayer, &dataSource, &dataSink, 1, audioPlayerInterfaceIDs, audioPlayerInterfaceRequired);
 90    if (sLResult != SL_RESULT_SUCCESS) {
 91        LOGI("创建播放器失败");
 92    }
 93    sLResult = (*audioPlayer)->Realize(audioPlayer, SL_BOOLEAN_FALSE);
 94    if (sLResult != SL_RESULT_SUCCESS) {
 95        LOGI("播放器初始化失败");
 96    }
 97    sLResult = (*audioPlayer)->GetInterface(audioPlayer, SL_IID_PLAY, &playInterface);
 98    if (sLResult != SL_RESULT_SUCCESS) {
 99        LOGI("获取引擎接口失败 -> SL_IID_PLAY");
100    }
101    sLResult = (*audioPlayer)->GetInterface(audioPlayer, SL_IID_BUFFERQUEUE, &pcmBufferQueue);
102    if (sLResult != SL_RESULT_SUCCESS) {
103        LOGI("获取引擎接口失败 -> SL_IID_BUFFERQUEUE");
104    }
105
106    // 5. 设置播放回调函数
107    (*pcmBufferQueue)->RegisterCallback(pcmBufferQueue, bufferQueueCallback, nullptr);
108    (*playInterface)->SetPlayState(playInterface, SL_PLAYSTATE_PLAYING);
109
110    (*pcmBufferQueue)->Enqueue(pcmBufferQueue, "", 1);
111
112
113    // 6. 销毁对象以及相关的资源
114    (*audioPlayer)->Destroy(engineObject);
115    (*outputMix)->Destroy(engineObject);
116}

结构体中的 numInterfaces , pInterfaceIds , pInterfaceRequired ,这里以创建播放器所调用的 CreateAudioPlayer 函数为例说明:

1SLresult (*CreateAudioPlayer) (
2    SLEngineItf self,
3    SLObjectItf * pPlayer,
4    SLDataSource *pAudioSrc,
5    SLDataSink *pAudioSnk,
6    SLuint32 numInterfaces,
7    const SLInterfaceID * pInterfaceIds,
8    const SLboolean * pInterfaceRequired
9);

各参数含义如下:

1、SLEngineItf C语言不像C++,没有this指针,所以只能通过每次调用SLEngineItf的方法的时候手动传入。

2、SLObjectItf 用于保存创建出来的AudioPlayerObject。

3、SLDataSource 输入数据源的信息。

4、SLDataSink 输出的信息。

5、numInterfaces 与下面的SLInterfaceID和SLboolean配合使用,用于标记SLInterfaceID数组和SLboolean数组的大小。

6、SLInterfaceID 这里需要传入一个数组,指定创建的AudioPlayerObject需要包含哪些Interface。

7、SLboolean 这里也是一个数组,用来标记每个需要包含的Interface在AudioPlayerObject不支持的情况下,是不是需要在创建AudioPlayerObject时返回失败。

最后的三个参数用于指定AudioPlayerObject需要包含哪些Interface,如果不包含是不是要直接创建失败。之前也提到过,并不是每个系统上都实现了 OpenSL ES 为 Object 定义的所有 Interface,所以在获取 Interface 的时候需要做一些选择和判断,如果创建成功的话我们就能使用AudioPlayerObject的GetInterface方法获取到这些Interface了。

DataSouce和DataSink在OpenSL ES里,这两个结构体均是作为创建 Media Object 对象时的参数而存在的,data source 代表着输入源的信息,即数据从哪儿来、输入的数据参数是怎样的;而 data sink 则代表着输出的信息,即数据输出到哪儿、以什么样的参数来输出。