HarmonyOS音訊開發指導：使用OpenSL ES開發音訊播放功能

OpenSL ES全稱為Open Sound Library for Embedded Systems，是一個嵌入式、跨平臺、免費的音訊處理庫。為嵌入式移動多媒體裝置上的應用開發者提供標準化、高效能、低延遲的API。HarmonyOS的Native API基於 開發的  1.0.1 API 規範實現，開發者可以透過<OpenSLES.h>和<OpenSLES_OpenHarmony.h>在HarmonyOS上使用相關API。

HarmonyOS上的OpenSL ES

OpenSL ES中提供了以下的介面，HarmonyOS當前僅實現了部分 OpenSL ES 介面，可以實現音訊播放的基礎功能。

呼叫未實現介面後會返回 SL_RESULT_FEATURE_UNSUPPORTED，當前沒有相關擴充套件可以使用。

以下列表列舉了HarmonyOS上已實現的OpenSL ES的介面，具體說明請參考 規範：

●  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>使用。

完整示例

參考以下示例程式碼，播放一個音訊檔案。

1.      新增標頭檔案。

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

2.      使用slCreateEngine介面和獲取engine例項。

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

3.      獲取介面SL_IID_ENGINE的engineEngine例項。

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

4.      配置播放器資訊，建立AudioPlayer。

SLDataLocator_BufferQueue slBufferQueue = {
    SL_DATALOCATOR_BUFFERQUEUE,
    0
};
// 具體引數需要根據音訊檔案格式進行適配
SLDataFormat_PCM pcmFormat = {
    SL_DATAFORMAT_PCM,
    2,                           // 通道數
    SL_SAMPLINGRATE_48,          // 取樣率
    SL_PCMSAMPLEFORMAT_FIXED_16, // 音訊取樣格式
    0,
    0,
    0
};
SLDataSource slSource = {&slBufferQueue, &pcmFormat};
SLObjectItf pcmPlayerObject = nullptr;
(*engineEngine)->CreateAudioPlayer(engineEngine, &pcmPlayerObject, &slSource, null, 0, nullptr, nullptr);
(*pcmPlayerObject)->Realize(pcmPlayerObject, SL_BOOLEAN_FALSE);

5.      獲取介面SL_IID_OH_BUFFERQUEUE的bufferQueueItf例項。

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

6.      開啟音訊檔案，註冊BufferQueueCallback回撥。

static void BufferQueueCallback (SLOHBufferQueueItf bufferQueueItf, void *pContext, SLuint32 size)
{
    SLuint8 *buffer = nullptr;
    SLuint32 pSize;
    (*bufferQueueItf)->GetBuffer(bufferQueueItf, &buffer, &pSize);
    // 將待播放音訊資料寫入buffer
    (*bufferQueueItf)->Enqueue(bufferQueueItf, buffer, size);
}
void *pContext; // 可傳入自定義的上下文資訊，會在Callback內收到
(*bufferQueueItf)->RegisterCallback(bufferQueueItf, BufferQueueCallback, pContext);

7.      獲取介面SL_PLAYSTATE_PLAYING的playItf例項，開始播放。

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

8.      結束音訊播放。

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