使用OpenSL ES開(kāi)發(fā)音頻播放功能

HarmonyOS上的OpenSL ES

OpenSL ES中提供了以下的接口，HarmonyOS當(dāng)前僅實(shí)現(xiàn)了部分OpenSL ES接口，可以實(shí)現(xiàn)音頻播放的基礎(chǔ)功能。

調(diào)用未實(shí)現(xiàn)接口后會(huì)返回SL_RESULT_FEATURE_UNSUPPORTED，當(dāng)前沒(méi)有相關(guān)擴(kuò)展可以使用。

以下列表列舉了HarmonyOS上已實(shí)現(xiàn)的OpenSL ES的接口，具體說(shuō)明請(qǐng)參考OpenSL ES規(guī)范：

• HarmonyOS上支持的Engine接口：
  • SLresult (*CreateAudioPlayer) (SLEngineItf self, SLObjectItf * pPlayer, SLDataSource *pAudioSrc, SLDataSink *pAudioSnk, SLuint32 numInterfaces, const SLInterfaceID * pInterfaceIds, const SLboolean * pInterfaceRequired)
  • SLresult (*CreateAudioRecorder) (SLEngineItf self, SLObjectItf * pRecorder, SLDataSource *pAudioSrc, SLDataSink *pAudioSnk, SLuint32 numInterfaces, const SLInterfaceID * pInterfaceIds, const SLboolean * pInterfaceRequired)
  • SLresult (*CreateOutputMix) (SLEngineItf self, SLObjectItf * pMix, SLuint32 numInterfaces, const SLInterfaceID * pInterfaceIds, const SLboolean * pInterfaceRequired)
• HarmonyOS上支持的Object接口：
  • SLresult (*Realize) (SLObjectItf self, SLboolean async)
  • SLresult (*GetState) (SLObjectItf self, SLuint32 * pState)
  • SLresult (*GetInterface) (SLObjectItf self, const SLInterfaceID iid, void * pInterface)
  • void (*Destroy) (SLObjectItf self)
• HarmonyOS上支持的Playback接口：
  • SLresult (*SetPlayState) (SLPlayItf self, SLuint32 state)
  • SLresult (*GetPlayState) (SLPlayItf self, SLuint32 *pState)
• HarmonyOS上支持的Volume控制接口：
  • SLresult (*SetVolumeLevel) (SLVolumeItf self, SLmillibel level)
  • SLresult (*GetVolumeLevel) (SLVolumeItf self, SLmillibel *pLevel)
  • SLresult (*GetMaxVolumeLevel) (SLVolumeItf self, SLmillibel *pMaxLevel)
• HarmonyOS上支持的BufferQueue接口：
  以下接口需引入<OpenSLES_OpenHarmony.h>使用。

  接口	說(shuō)明
  SLresult (*Enqueue) (SLOHBufferQueueItf self, const void *buffer, SLuint32 size)	根據(jù)情況將buffer加到相應(yīng)隊(duì)列中。 如果是播放操作，則將帶有音頻數(shù)據(jù)的buffer插入到filledBufferQ_隊(duì)列中；如果是錄音操作，則將錄音使用后的空閑buffer插入到freeBufferQ_隊(duì)列中。 self：表示調(diào)用該函數(shù)的BufferQueue接口對(duì)象。 buffer：播放時(shí)表示帶有音頻數(shù)據(jù)的buffer，錄音時(shí)表示已存儲(chǔ)完錄音數(shù)據(jù)后的空閑buffer。 size：表示buffer的大小。
  SLresult (*Clear) (SLOHBufferQueueItf self)	釋放BufferQueue接口對(duì)象。 self：表示調(diào)用該函數(shù)的BufferQueue接口對(duì)象將被釋放。
  SLresult (*GetState) (SLOHBufferQueueItf self, SLOHBufferQueueState *state)	獲取BufferQueue接口對(duì)象狀態(tài)。 self：表示調(diào)用該函數(shù)的BufferQueue接口對(duì)象。 state：BufferQueue的當(dāng)前狀態(tài)。
  SLresult (*RegisterCallback) (SLOHBufferQueueItf self, SlOHBufferQueueCallback callback, void* pContext)	注冊(cè)回調(diào)函數(shù)。 self：表示調(diào)用該函數(shù)的BufferQueue接口對(duì)象。 callback：播放/錄音時(shí)注冊(cè)的回調(diào)函數(shù)。 pContext：播放時(shí)傳入待播放音頻文件，錄音時(shí)傳入將要錄制的音頻文件。
  SLresult (*GetBuffer) (SLOHBufferQueueItf self, SLuint8** buffer, SLuint32* size)	根據(jù)情況獲取相應(yīng)的buffer。 如果是播放操作，則從freeBufferQ_隊(duì)列中獲取空閑buffer；如果是錄音操作，則從filledBufferQ_隊(duì)列中獲取攜帶錄音數(shù)據(jù)的buffer。 self：表示調(diào)用該函數(shù)的BufferQueue接口對(duì)象。 buffer：播放時(shí)表示空閑的buffer，錄音時(shí)表示攜帶錄音數(shù)據(jù)的buffer。 size：表示buffer的大小。

完整示例

參考以下示例代碼，播放一個(gè)音頻文件。

1. 添加頭文件。

   #include <OpenSLES.h>
   #include <OpenSLES_OpenHarmony.h>
   #include <OpenSLES_Platform.h>

2. 使用slCreateEngine接口和獲取engine實(shí)例。

   SLObjectItf engineObject = nullptr;
   slCreateEngine(&engineObject, 0, nullptr, 0, nullptr, nullptr);
   (*engineObject)->Realize(engineObject, SL_BOOLEAN_FALSE);

3. 獲取接口SL_IID_ENGINE的engineEngine實(shí)例。

   SLEngineItf engineEngine = nullptr;
   (*engineObject)->GetInterface(engineObject, SL_IID_ENGINE, &engineEngine);

4. 配置播放器信息，創(chuàng)建AudioPlayer。

   SLDataLocator_BufferQueue slBufferQueue = {
       SL_DATALOCATOR_BUFFERQUEUE,
       0
   };
   
   // 具體參數(shù)需要根據(jù)音頻文件格式進(jìn)行適配
   SLDataFormat_PCM pcmFormat = {
       SL_DATAFORMAT_PCM,
       2,                           // 通道數(shù)
       SL_SAMPLINGRATE_48,          // 采樣率
       SL_PCMSAMPLEFORMAT_FIXED_16, // 音頻采樣格式
       0,
       0,
       0
   };
   SLDataSource slSource = {&slBufferQueue, &pcmFormat};
   SLObjectItf pcmPlayerObject = nullptr;
   (*engineEngine)->CreateAudioPlayer(engineEngine, &pcmPlayerObject, &slSource, nullptr, 0, nullptr, nullptr);
   (*pcmPlayerObject)->Realize(pcmPlayerObject, SL_BOOLEAN_FALSE);

5. 獲取接口SL_IID_OH_BUFFERQUEUE的bufferQueueItf實(shí)例。

   SLOHBufferQueueItf bufferQueueItf;
   (*pcmPlayerObject)->GetInterface(pcmPlayerObject, SL_IID_OH_BUFFERQUEUE, &bufferQueueItf);

6. 打開(kāi)音頻文件，注冊(cè)BufferQueueCallback回調(diào)。

   static void BufferQueueCallback (SLOHBufferQueueItf bufferQueueItf, void *pContext, SLuint32 size)
   {
       SLuint8 *buffer = nullptr;
       SLuint32 pSize;
       (*bufferQueueItf)->GetBuffer(bufferQueueItf, &buffer, &pSize);
       // 將待播放音頻數(shù)據(jù)寫(xiě)入buffer
       (*bufferQueueItf)->Enqueue(bufferQueueItf, buffer, size);
   }
   void *pContext; // 可傳入自定義的上下文信息，會(huì)在Callback內(nèi)收到
   (*bufferQueueItf)->RegisterCallback(bufferQueueItf, BufferQueueCallback, pContext);

7. 獲取接口SL_PLAYSTATE_PLAYING的playItf實(shí)例，開(kāi)始播放。

   SLPlayItf playItf = nullptr;
   (*pcmPlayerObject)->GetInterface(pcmPlayerObject, SL_IID_PLAY, &playItf);
   (*playItf)->SetPlayState(playItf, SL_PLAYSTATE_PLAYING);

8. 結(jié)束音頻播放。

   (*playItf)->SetPlayState(playItf, SL_PLAYSTATE_STOPPED);
   (*pcmPlayerObject)->Destroy(pcmPlayerObject);
   (*engineObject)->Destroy(engineObject);