鸿蒙HarmonyOS开发实战往期必看文章:(持续更新......)
HarmonyOS NEXT应用开发性能实践总结(持续更新......)
HarmonyOS NEXT应用开发案例实践总结合集(持续更新......)
一分钟了解”纯血版!鸿蒙HarmonyOS Next应用开发!
最新版!“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线!(从零基础入门到精通)
OHAudio是系统在API version 10中引入的一套C API,此API在设计上实现归一,同时支持普通音频通路和低时延通路。仅支持PCM格式,适用于依赖Native层实现音频输入功能的场景。
OHAudio音频频录状态变化示意图:
使用入门
开发者要使用OHAudio提供的播放或者录制能力,需要添加对应的头文件。
在 CMake 脚本中链接动态库
target_link_libraries(sample PUBLIC libohaudio.so)
添加头文件
开发者通过引入<native_audiostreambuilder.h>和<native_audiocapturer.h>头文件,使用音频录制相关API。
#include <ohaudio/native_audiocapturer.h>
#include <ohaudio/native_audiostreambuilder.h>
音频流构造器
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_CAPTURER);
-
配置音频流参数
创建音频录制构造器后,可以设置音频流所需要的参数,可以参考下面的案例。
// 设置音频采样率 OH_AudioStreamBuilder_SetSamplingRate(builder, 48000); // 设置音频声道 OH_AudioStreamBuilder_SetChannelCount(builder, 2); // 设置音频采样格式 OH_AudioStreamBuilder_SetSampleFormat(builder, AUDIOSTREAM_SAMPLE_S16LE); // 设置音频流的编码类型 OH_AudioStreamBuilder_SetEncodingType(builder, AUDIOSTREAM_ENCODING_TYPE_RAW); // 设置输入音频流的工作场景 OH_AudioStreamBuilder_SetCapturerInfo(builder, AUDIOSTREAM_SOURCE_TYPE_MIC);
同样,音频录制的音频数据要通过回调接口写入,开发者要实现回调接口,使用OH_AudioStreamBuilder_SetCapturerCallback设置回调函数。回调函数的声明请查看OH_AudioCapturer_Callbacks 。
-
设置音频回调函数
多音频并发处理可参考文档处理音频焦点事件,仅接口语言差异。
// 自定义写入数据函数 int32_t MyOnReadData( OH_AudioCapturer* capturer, void* userData, void* buffer, int32_t length) { // 从buffer中取出length长度的录音数据 return 0; } // 自定义音频流事件函数 int32_t MyOnStreamEvent( OH_AudioCapturer* capturer, void* userData, OH_AudioStream_Event event) { // 根据event表示的音频流事件信息,更新播放器状态和界面 return 0; } // 自定义音频中断事件函数 int32_t MyOnInterruptEvent( OH_AudioCapturer* capturer, void* userData, OH_AudioInterrupt_ForceType type, OH_AudioInterrupt_Hint hint) { // 根据type和hint表示的音频中断信息,更新录制器状态和界面 return 0; } // 自定义异常回调函数 int32_t MyOnError( OH_AudioCapturer* capturer, void* userData, OH_AudioStream_Result error) { // 根据error表示的音频异常信息,做出相应的处理 return 0; } OH_AudioCapturer_Callbacks callbacks; // 配置回调函数 callbacks.OH_AudioCapturer_OnReadData = MyOnReadData; callbacks.OH_AudioCapturer_OnStreamEvent = MyOnStreamEvent; callbacks.OH_AudioCapturer_OnInterruptEvent = MyOnInterruptEvent; callbacks.OH_AudioCapturer_OnError = MyOnError; // 设置音频输入流的回调 OH_AudioStreamBuilder_SetCapturerCallback(builder, callbacks, nullptr);
为了避免不可预期的行为,在设置音频回调函数时,请确保OH_AudioCapturer_Callbacks的每一个回调都被自定义的回调方法或空指针初始化。
// 自定义写入数据函数 int32_t MyOnReadData( OH_AudioCapturer* capturer, void* userData, void* buffer, int32_t length) { // 从buffer中取出length长度的录音数据 return 0; } // 自定义音频中断事件函数 int32_t MyOnInterruptEvent( OH_AudioCapturer* capturer, void* userData, OH_AudioInterrupt_ForceType type, OH_AudioInterrupt_Hint hint) { // 根据type和hint表示的音频中断信息,更新录制器状态和界面 return 0; } OH_AudioCapturer_Callbacks callbacks; // 配置回调函数,如果需要监听,则赋值 callbacks.OH_AudioCapturer_OnReadData = MyOnReadData; callbacks.OH_AudioCapturer_OnInterruptEvent = MyOnInterruptEvent; // (必选)如果不需要监听,使用空指针初始化 callbacks.OH_AudioCapturer_OnStreamEvent = nullptr; callbacks.OH_AudioCapturer_OnError = nullptr;
-
构造录制音频流
OH_AudioCapturer* audioCapturer; OH_AudioStreamBuilder_GenerateCapturer(builder, &audioCapturer);
-
使用音频流
录制音频流包含下面接口,用来实现对音频流的控制。
接口 说明 OH_AudioStream_Result OH_AudioCapturer_Start(OH_AudioCapturer* capturer) 开始录制 OH_AudioStream_Result OH_AudioCapturer_Pause(OH_AudioCapturer* capturer) 暂停录制 OH_AudioStream_Result OH_AudioCapturer_Stop(OH_AudioCapturer* capturer) 停止录制 OH_AudioStream_Result OH_AudioCapturer_Flush(OH_AudioCapturer* capturer) 释放缓存数据 OH_AudioStream_Result OH_AudioCapturer_Release(OH_AudioCapturer* capturer) 释放录制实例 -
释放构造器
构造器不再使用时,需要释放相关资源。
OH_AudioStreamBuilder_Destroy(builder);
设置低时延模式
当设备支持低时延通路时,开发者可以使用低时延模式创建音频录制构造器,获得更高质量的音频体验。
开发流程与普通录制场景一致,仅需要在创建音频录制构造器时,调用OH_AudioStreamBuilder_SetLatencyMode()设置低时延模式。
开发示例
OH_AudioStream_LatencyMode latencyMode = AUDIOSTREAM_LATENCY_MODE_FAST;
OH_AudioStreamBuilder_SetLatencyMode(builder, latencyMode);
最后
小编在之前的鸿蒙系统扫盲中,有很多朋友给我留言,有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)路线图、学习视频、文档用来跟着学习是非常有必要的。
如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员
鸿蒙 NEXT 全栈开发学习笔记 希望这一份鸿蒙学习文档能够给大家带来帮助~
这份鸿蒙(HarmonyOS NEXT)包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、(南向驱动、嵌入式等)鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
鸿蒙(HarmonyOS NEXT)最新学习路线
该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发,不仅补充了华为官网未涉及的解决方案
路线图适合人群:
IT开发人员:想要拓展职业边界
零基础小白:鸿蒙爱好者,希望从0到1学习,增加一项技能。
技术提升/进阶跳槽:发展瓶颈期,提升职场竞争力,快速掌握鸿蒙技术
2.视频学习教程+学习PDF文档
HarmonyOS Next 最新全套视频教程 全球开发者的开源社区,开源代码
纯血版鸿蒙全套学习文档(面试、文档、全套视频等) 全球开发者的开源社区,开源代码
《鸿蒙大厂面试真题》GitCode - 全球开发者的开源社区,开源代码
总结
参与鸿蒙开发,你要先认清适合你的方向,如果是想从事鸿蒙应用开发方向的话,可以参考本文的学习路径,简单来说就是:为了确保高效学习,建议规划清晰的学习路线