HarmonyOS 音频开发指导:使用 OpenSL ES 开发音频播放功能

OpenSL ES 全称为 Open Sound Library for Embedded Systems,是一个嵌入式、跨平台、免费的音频处理库。为嵌入式移动多媒体设备上的应用开发者提供标准化、高性能、低延迟的 API。HarmonyOS 的 Native API 基于Khronos Group开发的OpenSL ES 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 的接口,具体说明请参考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);

相关推荐
yilylong15 分钟前
鸿蒙(Harmony)实现滑块验证码
华为·harmonyos·鸿蒙
baby_hua15 分钟前
HarmonyOS第一课——DevEco Studio的使用
华为·harmonyos
HarmonyOS_SDK42 分钟前
融合虚拟与现实,AR Engine为用户提供沉浸式交互体验
harmonyos
- 羊羊不超越 -2 小时前
App渠道来源追踪方案全面分析(iOS/Android/鸿蒙)
android·ios·harmonyos
XuanRanDev2 小时前
【每日一题】LeetCode - 三数之和
数据结构·算法·leetcode·1024程序员节
长弓三石4 小时前
鸿蒙网络编程系列44-仓颉版HttpRequest上传文件示例
前端·网络·华为·harmonyos·鸿蒙
SameX6 小时前
鸿蒙 Next 电商应用安全支付与密码保护实践
前端·harmonyos
SuperHeroWu76 小时前
【HarmonyOS】键盘遮挡输入框UI布局处理
华为·harmonyos·压缩·keyboard·键盘遮挡·抬起
鹏大师运维8 小时前
【功能介绍】信创终端系统上各WPS版本的授权差异
linux·wps·授权·麒麟·国产操作系统·1024程序员节·统信uos
亦枫Leonlew9 小时前
微积分复习笔记 Calculus Volume 1 - 4.7 Applied Optimization Problems
笔记·数学·微积分·1024程序员节