harmony 鸿蒙使用OHAudio开发音频播放功能
使用OHAudio开发音频播放功能
OHAudio是OpenHarmony在API version 10中引入的一套全新Native API,此API在设计上实现归一,同时支持普通音频通路和低时延通路。
使用入门
开发者要使用OHAudio提供的播放或者录制能力,需要添加对应的头文件。
开发者通过引入<native_audiostreambuilder.h>和<native_audiorenderer.h>头文件,使用音频播放相关API。
音频流构造器
OHAudio提供OH_AudioStreamBuilder接口,遵循构造器设计模式,用于构建音频流。开发者需要根据业务场景,指定对应的OH_AudioStream_Type 。
OH_AudioStream_Type
包含两种类型:
- AUDIOSTREAM_TYPE_RENDERER
- AUDIOSTREAM_TYPE_CAPTURER
使用OH_AudioStreamBuilder_Create创建构造器示例:
OH_AudioStreamBuilder* builder;
OH_AudioStreamBuilder_Create(&builder, streamType);
在音频业务结束之后,开发者应该执行OH_AudioStreamBuilder_Destroy接口来销毁构造器。
OH_AudioStreamBuilder_Destroy(builder);
开发步骤及注意事项
详细的API说明请参考OHAudio API参考。
开发者可以通过以下几个步骤来实现一个简单的播放功能。
创建构造器
OH_AudioStreamBuilder* builder; OH_AudioStreamBuilder_Create(&builder, AUDIOSTREAM_TYPE_RENDERER);
配置音频流参数
创建音频播放构造器后,可以设置音频流所需要的参数,可以参考下面的案例。
OH_AudioStreamBuilder_SetSamplingRate(builder, rate); OH_AudioStreamBuilder_SetChannelCount(builder, channelCount); OH_AudioStreamBuilder_SetSampleFormat(builder, format); OH_AudioStreamBuilder_SetEncodingType(builder, encodingType); OH_AudioStreamBuilder_SetRendererInfo(builder, usage);
注意,播放的音频数据要通过回调接口写入,开发者要实现回调接口,使用
OH_AudioStreamBuilder_SetRendererCallback
设置回调函数。回调函数的声明请查看OH_AudioRenderer_Callbacks 。设置回调函数
OH_AudioStreamBuilder_SetRendererCallback(builder, callbacks, nullptr);
构造播放音频流
OH_AudioRenderer* audioRenderer; OH_AudioStreamBuilder_GenerateRenderer(builder, &audioRenderer);
使用音频流
音频流包含下面接口,用来实现对音频流的控制。
|接口 |说明 | |————————————————————|————| |OH_AudioStream_Result OH_AudioRenderer_Start(OH_AudioRenderer* renderer)|开始播放 | |OH_AudioStream_Result OH_AudioRenderer_Pause(OH_AudioRenderer* renderer)|暂停播放 | |OH_AudioStream_Result OH_AudioRenderer_Stop(OH_AudioRenderer* renderer)|停止播放 | |OH_AudioStream_Result OH_AudioRenderer_Flush(OH_AudioRenderer* renderer)|释放缓存数据| |OH_AudioStream_Result OH_AudioRenderer_Release(OH_AudioRenderer* renderer)|释放播放实例|
释放构造器
构造器不再使用时,需要释放相关资源。
OH_AudioStreamBuilder_Destroy(builder);
设置低时延模式
当设备支持低时延通路时,开发者可以使用低时延模式创建播放器,获得更高质量的音频体验。
开发流程与普通播放场景一致,仅需要在创建音频流构造器时,调用OH_AudioStreamBuilder_SetLatencyMode()设置低时延模式。
开发示例
OH_AudioStream_LatencyMode latencyMode = AUDIOSTREAM_LATENCY_MODE_FAST;
OH_AudioStreamBuilder_SetLatencyMode(builder, latencyMode);
你可能感兴趣的鸿蒙文章
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦