1# 使用OpenSL ES开发音频播放功能 2 3OpenSL ES全称为Open Sound Library for Embedded Systems，是一个嵌入式、跨平台、免费的音频处理库。为嵌入式移动多媒体设备上的应用开发者提供标准化、高性能、低延迟的API。OpenHarmony的Native API基于[Khronos Group](https://www.khronos.org/)开发的[OpenSL ES](https://www.khronos.org/opensles/) 1.0.1 API 规范实现，开发者可以通过<OpenSLES.h>和<OpenSLES_OpenHarmony.h>在OpenHarmony上使用相关API。 4 5## OpenHarmony上的OpenSL ES 6 7OpenSL ES中提供了以下的接口，OpenHarmony当前仅实现了部分[接口](https://gitee.com/openharmony/third_party_opensles/blob/master/api/1.0.1/OpenSLES.h)，可以实现音频播放的基础功能。 8 9调用未实现接口后会返回**SL_RESULT_FEATURE_UNSUPPORTED，**当前没有相关扩展可以使用。 10 11以下列表列举了OpenHarmony上已实现的OpenSL ES的接口，具体说明请参考[OpenSL ES](https://www.khronos.org/opensles/)规范： 12 13- **OpenHarmony上支持的Engine接口：** 14 - SLresult (\*CreateAudioPlayer) (SLEngineItf self, SLObjectItf \* pPlayer, SLDataSource \*pAudioSrc, SLDataSink \*pAudioSnk, SLuint32 numInterfaces, const SLInterfaceID \* pInterfaceIds, const SLboolean \* pInterfaceRequired) 15 - SLresult (\*CreateAudioRecorder) (SLEngineItf self, SLObjectItf \* pRecorder, SLDataSource \*pAudioSrc, SLDataSink \*pAudioSnk, SLuint32 numInterfaces, const SLInterfaceID \* pInterfaceIds, const SLboolean \* pInterfaceRequired) 16 - SLresult (\*CreateOutputMix) (SLEngineItf self, SLObjectItf \* pMix, SLuint32 numInterfaces, const SLInterfaceID \* pInterfaceIds, const SLboolean \* pInterfaceRequired) 17 18- **OpenHarmony上支持的Object接口：** 19 - SLresult (\*Realize) (SLObjectItf self, SLboolean async) 20 - SLresult (\*GetState) (SLObjectItf self, SLuint32 \* pState) 21 - SLresult (\*GetInterface) (SLObjectItf self, const SLInterfaceID iid, void \* pInterface) 22 - void (\*Destroy) (SLObjectItf self) 23 24- **OpenHarmony上支持的Playback接口：** 25 - SLresult (\*SetPlayState) (SLPlayItf self, SLuint32 state) 26 - SLresult (\*GetPlayState) (SLPlayItf self, SLuint32 \*pState) 27 28- **OpenHarmony上支持的Volume控制接口**： 29 - SLresult (\*SetVolumeLevel) (SLVolumeItf self, SLmillibel level) 30 - SLresult (\*GetVolumeLevel) (SLVolumeItf self, SLmillibel \*pLevel) 31 - SLresult (\*GetMaxVolumeLevel) (SLVolumeItf self, SLmillibel \*pMaxLevel) 32 33- **OpenHarmony上支持的BufferQueue接口**： 34 35 以下接口需引入<OpenSLES_OpenHarmony.h>使用。 36 | 接口 | 说明 | 37 | -------- | -------- | 38 | SLresult (\*Enqueue) (SLOHBufferQueueItf self, const void \*buffer, SLuint32 size) | 根据情况将buffer加到相应队列中。<br/>如果是播放操作，则将带有音频数据的buffer插入到filledBufferQ_队列中；如果是录音操作，则将录音使用后的空闲buffer插入到freeBufferQ_队列中。<br/>self：表示调用该函数的BufferQueue接口对象。<br/>buffer：播放时表示带有音频数据的buffer，录音时表示已存储完录音数据后的空闲buffer。<br/>size：表示buffer的大小。 | 39 | SLresult (\*Clear) (SLOHBufferQueueItf self) | 释放BufferQueue接口对象。<br/>self：表示调用该函数的BufferQueue接口对象将被释放。 | 40 | SLresult (\*GetState) (SLOHBufferQueueItf self, SLOHBufferQueueState \*state) | 获取BufferQueue接口对象状态。<br/>self：表示调用该函数的BufferQueue接口对象。<br/>state：BufferQueue的当前状态。 | 41 | SLresult (\*RegisterCallback) (SLOHBufferQueueItf self, SlOHBufferQueueCallback callback, void\* pContext) | 注册回调函数。<br/>self：表示调用该函数的BufferQueue接口对象。<br/>callback：播放/录音时注册的回调函数。<br/>pContext：播放时传入待播放音频文件，录音时传入将要录制的音频文件。 | 42 | SLresult (\*GetBuffer) (SLOHBufferQueueItf self, SLuint8\*\* buffer, SLuint32\* size) | 根据情况获取相应的buffer。<br/>如果是播放操作，则从freeBufferQ_队列中获取空闲buffer；如果是录音操作，则从filledBufferQ_队列中获取携带录音数据的buffer。<br/>self：表示调用该函数的BufferQueue接口对象。<br/>buffer：播放时表示空闲的buffer，录音时表示携带录音数据的buffer。<br/>size：表示buffer的大小。 | 43 44## 完整示例 45 46参考以下示例代码，播放一个音频文件。 47 481. 添加头文件。 49 50 ```c++ 51 #include <OpenSLES.h> 52 #include <OpenSLES_OpenHarmony.h> 53 #include <OpenSLES_Platform.h> 54 ``` 55 562. 使用slCreateEngine接口和获取engine实例。 57 58 ```c++ 59 SLObjectItf engineObject = nullptr; 60 slCreateEngine(&engineObject, 0, nullptr, 0, nullptr, nullptr); 61 (*engineObject)->Realize(engineObject, SL_BOOLEAN_FALSE); 62 ``` 63 643. 获取接口SL_IID_ENGINE的engineEngine实例。 65 66 ```c++ 67 SLEngineItf engineEngine = nullptr; 68 (*engineObject)->GetInterface(engineObject, SL_IID_ENGINE, &engineEngine); 69 ``` 70 714. 配置播放器信息，创建AudioPlayer。 72 73 ```c++ 74 SLDataLocator_BufferQueue slBufferQueue = { 75 SL_DATALOCATOR_BUFFERQUEUE, 76 0 77 }; 78 79 // 具体参数需要根据音频文件格式进行适配 80 SLDataFormat_PCM pcmFormat = { 81 SL_DATAFORMAT_PCM, 82 2, // 通道数 83 SL_SAMPLINGRATE_48, // 采样率 84 SL_PCMSAMPLEFORMAT_FIXED_16, // 音频采样格式 85 0, 86 0, 87 0 88 }; 89 SLDataSource slSource = {&slBufferQueue, &pcmFormat}; 90 SLObjectItf pcmPlayerObject = nullptr; 91 (*engineEngine)->CreateAudioPlayer(engineEngine, &pcmPlayerObject, &slSource, null, 0, nullptr, nullptr); 92 (*pcmPlayerObject)->Realize(pcmPlayerObject, SL_BOOLEAN_FALSE); 93 ``` 94 955. 获取接口SL_IID_OH_BUFFERQUEUE的bufferQueueItf实例。 96 97 ```c++ 98 SLOHBufferQueueItf bufferQueueItf; 99 (*pcmPlayerObject)->GetInterface(pcmPlayerObject, SL_IID_OH_BUFFERQUEUE, &bufferQueueItf); 100 ``` 101 1026. 打开音频文件，注册BufferQueueCallback回调。 103 104 ```c++ 105 static void BufferQueueCallback (SLOHBufferQueueItf bufferQueueItf, void *pContext, SLuint32 size) 106 { 107 SLuint8 *buffer = nullptr; 108 SLuint32 pSize; 109 (*bufferQueueItf)->GetBuffer(bufferQueueItf, &buffer, &pSize); 110 // 将待播放音频数据写入buffer 111 (*bufferQueueItf)->Enqueue(bufferQueueItf, buffer, size); 112 } 113 void *pContext; // 可传入自定义的上下文信息，会在Callback内收到 114 (*bufferQueueItf)->RegisterCallback(bufferQueueItf, BufferQueueCallback, pContext); 115 ``` 116 1177. 获取接口SL_PLAYSTATE_PLAYING的playItf实例，开始播放。 118 119 ```c++ 120 SLPlayItf playItf = nullptr; 121 (*pcmPlayerObject)->GetInterface(pcmPlayerObject, SL_IID_PLAY, &playItf); 122 (*playItf)->SetPlayState(playItf, SL_PLAYSTATE_PLAYING); 123 ``` 124 1258. 结束音频播放。 126 127 ```c++ 128 (*playItf)->SetPlayState(playItf, SL_PLAYSTATE_STOPPED); 129 (*pcmPlayerObject)->Destroy(pcmPlayerObject); 130 (*engineObject)->Destroy(engineObject); 131 ``` 132