鸿蒙（API 12 Beta2版）媒体开发【利用OHAudio开发音频播放功能(C/C++)】 ...

OHAudio是体系在API version 10中引入的一套C API，此API在计划上实现归一，同时支持普通音频通路和低时延通路。仅支持PCM格式，适用于依赖Native层实现音频输出功能的场景。
利用入门

开发者要利用OHAudio提供的播放大概录制本领，需要添加对应的头文件。
在 CMake 脚本中链接动态库

1. target_link_libraries(sample PUBLIC libohaudio.so)

复制代码

添加头文件

开发者通过引入<[native_audiostreambuilder.h]>和<[native_audiorenderer.h]>头文件，利用音频播放干系API。

1. #include <ohaudio/native_audiorenderer.h>
2. #include <ohaudio/native_audiostreambuilder.h>

复制代码

音频流构造器

OHAudio提供OH_AudioStreamBuilder接口，遵照构造器计划模式，用于构建音频流。开发者需要根据业务场景，指定对应的[OH_AudioStream_Type] 。
OH_AudioStream_Type包罗两种范例：

• AUDIOSTREAM_TYPE_RENDERER
  
• AUDIOSTREAM_TYPE_CAPTURER
  

利用[OH_AudioStreamBuilder_Create]创建构造器示例：

1. OH_AudioStreamBuilder* builder;
2. OH_AudioStreamBuilder_Create(&builder, streamType);

复制代码

在音频业务竣事之后，开发者应该实行[OH_AudioStreamBuilder_Destroy]接口来烧毁构造器。

1. OH_AudioStreamBuilder_Destroy(builder);

复制代码

开发步骤及注意事项

详细的API说明请参考[OHAudio API参考]
开发者可以通过以下几个步骤来实现一个简朴的播放功能。

• 创建构造器
  

1. OH_AudioStreamBuilder* builder;
2. OH_AudioStreamBuilder_Create(&builder, AUDIOSTREAM_TYPE_RENDERER);

复制代码

• 配置音频流参数
  创建音频播放构造器后，可以设置音频流所需要的参数，可以参考下面的案例。
  

1. // 设置音频采样率
2. OH_AudioStreamBuilder_SetSamplingRate(builder, 48000);
3. // 设置音频声道
4. OH_AudioStreamBuilder_SetChannelCount(builder, 2);
5. // 设置音频采样格式
6. OH_AudioStreamBuilder_SetSampleFormat(builder, AUDIOSTREAM_SAMPLE_S16LE);
7. // 设置音频流的编码类型
8. OH_AudioStreamBuilder_SetEncodingType(builder, AUDIOSTREAM_ENCODING_TYPE_RAW);
9. // 设置输出音频流的工作场景
10. OH_AudioStreamBuilder_SetRendererInfo(builder, AUDIOSTREAM_USAGE_MUSIC);

复制代码

注意，播放的音频数据要通过回调接口写入，开发者要实现回调接口，利用OH_AudioStreamBuilder_SetRendererCallback设置回调函数。回调函数的声明请查看[OH_AudioRenderer_Callbacks]) 。

• 设置音频回调函数
  多音频并发处理可参考[多音频播放的并发策略]，仅接口语言差异。
  

1. // 自定义写入数据函数
2. int32_t MyOnWriteData(
3.     OH_AudioRenderer* renderer,
4.     void* userData,
5.     void* buffer,
6.     int32_t length)
7. {
8.     // 将待播放的数据，按length长度写入buffer
9.     return 0;
10. }
11. // 自定义音频流事件函数
12. int32_t MyOnStreamEvent(
13.     OH_AudioRenderer* renderer,
14.     void* userData,
15.     OH_AudioStream_Event event)
16. {
17.     // 根据event表示的音频流事件信息，更新播放器状态和界面
18.     return 0;
19. }
20. // 自定义音频中断事件函数
21. int32_t MyOnInterruptEvent(
22.     OH_AudioRenderer* renderer,
23.     void* userData,
24.     OH_AudioInterrupt_ForceType type,
25.     OH_AudioInterrupt_Hint hint)
26. {
27.     // 根据type和hint表示的音频中断信息，更新播放器状态和界面
28.     return 0;
29. }
30. // 自定义异常回调函数
31. int32_t MyOnError(
32.     OH_AudioRenderer* renderer,
33.     void* userData,
34.     OH_AudioStream_Result error)
35. {
36.     // 根据error表示的音频异常信息，做出相应的处理
37.     return 0;
38. }
40. OH_AudioRenderer_Callbacks callbacks;
41. // 配置回调函数
42. callbacks.OH_AudioRenderer_OnWriteData = MyOnWriteData;
43. callbacks.OH_AudioRenderer_OnStreamEvent = MyOnStreamEvent;
44. callbacks.OH_AudioRenderer_OnInterruptEvent = MyOnInterruptEvent;
45. callbacks.OH_AudioRenderer_OnError = MyOnError;
47. //设置输出音频流的回调
48. OH_AudioStreamBuilder_SetRendererCallback(builder, callbacks, nullptr);

复制代码

为了避免不可预期的活动，在设置音频回调函数时，请确保[OH_AudioRenderer_Callbacks]的每一个回调都被自界说的回调方法或空指针初始化。

1. // 自定义写入数据函数
2. int32_t MyOnWriteData(
3.     OH_AudioRenderer* renderer,
4.     void* userData,
5.     void* buffer,
6.     int32_t length)
7. {
8.     // 将待播放的数据，按length长度写入buffer
9.     return 0;
10. }
11. // 自定义音频中断事件函数
12. int32_t MyOnInterruptEvent(
13.     OH_AudioRenderer* renderer,
14.     void* userData,
15.     OH_AudioInterrupt_ForceType type,
16.     OH_AudioInterrupt_Hint hint)
17. {
18.     // 根据type和hint表示的音频中断信息，更新播放器状态和界面
19.     return 0;
20. }
21. OH_AudioRenderer_Callbacks callbacks;
23. // 配置回调函数，如果需要监听，则赋值
24. callbacks.OH_AudioRenderer_OnWriteData = MyOnWriteData;
25. callbacks.OH_AudioRenderer_OnInterruptEvent = MyOnInterruptEvent;
27. // （必选）如果不需要监听，使用空指针初始化
28. callbacks.OH_AudioRenderer_OnStreamEvent = nullptr;
29. callbacks.OH_AudioRenderer_OnError = nullptr;

复制代码

• 构造播放音频流
  

1. OH_AudioRenderer* audioRenderer;
2. 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)释放播放实例
  
• 释放构造器
  构造器不再利用时，需要释放干系资源。
  
  1. OH_AudioStreamBuilder_Destroy(builder);

  复制代码

设置低时延模式

当设备支持低时延通路时，开发者可以利用低时延模式创建播放器，得到更高质量的音频体验。
开发流程与普通播放场景划一，仅需要在创建音频流构造器时，调用[OH_AudioStreamBuilder_SetLatencyMode()]设置低时延模式。
开发示例

1. OH_AudioStreamBuilder_SetLatencyMode(builder, AUDIOSTREAM_LATENCY_MODE_FAST);

复制代码

设置音频声道结构

播放音频文件时，可以通过设置音频的声道结构信息，指定渲染或播放时的扬声器摆位，使得渲染和播放效果更佳，得到更高质量的音频体验。
开发流程与普通播放场景划一，仅需要在创建音频流构造器时，调用[OH_AudioStreamBuilder_SetChannelLayout()]设置声道结构信息。
当声道结构与声道数不匹配时，创建音频流会失败。发起在设置声道结构时，确认下发的声道结构信息是正确的。
假如不知道准确的声道结构信息，大概开发者需要利用默认声道结构，可以不调用设置声道结构接口，大概下发CH_LAYOUT_UNKNOWN，以利用基于声道数的默认声道结构。
对于HOA格式的音频，想要得到正确的渲染和播放效果，必须指定声道结构信息。
开发示例

1. OH_AudioStreamBuilder_SetChannelLayout(builder, CH_LAYOUT_STEREO);

复制代码

播放AudioVivid格式音源

播放AudioVivid格式音频文件时，需要利用与普通播放不同的数据写入回调函数，该回调可以同时写入PCM数据与元数据。
开发流程与普通播放场景划一，仅需要在创建音频流构造器时，调用[OH_AudioStreamBuilder_SetWriteDataWithMetadataCallback()]设置PCM数据与元数据同时写入的回调函数，同时调用[OH_AudioStreamBuilder_SetEncodingType()]设置编码范例为AUDIOSTREAM_ENCODING_TYPE_AUDIOVIVID。
在播放AudioVivid时，帧长是固定的，不可通过[OH_AudioStreamBuilder_SetFrameSizeInCallback()]设置回调帧长。同时，在设置播放声道数和声道结构时，需要将写入音源的声床数和对象数相加后举行设置。
开发示例

1. // 自定义同时写入PCM数据和元数据函数
2. int32_t MyOnWriteDataWithMetadata(
3.     OH_AudioRenderer* renderer,
4.     void* userData,
5.     void* audioData,
6.     int32_t audioDataSize,
7.     void* metadata,
8.     int32_t metadataSize)
9. {
10.     // 将待播放的PCM数据和元数据，分别按audioDataSize和metadataSize写入buffer
11.     return 0;
12. }
14. // 设置编码类型
15. OH_AudioStreamBuilder_SetEncodingType(builder, AUDIOSTREAM_ENCODING_TYPE_AUDIOVIVID);
16. // 配置回调函数
17. OH_AudioRenderer_WriteDataWithMetadataCallback metadataCallback = MyOnWriteDataWithMetadata;
18. // 设置同时写入PCM数据和元数据的回调
19. OH_AudioStreamBuilder_SetWriteDataWithMetadataCallback(builder, metadataCallback, nullptr);

复制代码

末了呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要体系性的举行。
而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与体系底层开发。你可以参考这份资料，少走很多弯路，节省没须要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包罗了（ArkTS、ArkUI开发组件、Stage模型、多端摆设、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点
假如你是一名Android、Java、前端等等开发职员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习门路图。

针对鸿蒙成长门路打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门视频，资助大家在技术的道路上更进一步。

• 《鸿蒙 (OpenHarmony)开发学习视频》
  
• 《鸿蒙生态应用开发V2.0白皮书》
  
• 《鸿蒙 (OpenHarmony)开发基础到实战手册》
  
• OpenHarmony北向、南向开发情况搭建
  
• 《鸿蒙开发基础》
  
• 《鸿蒙开发进阶》
  
• 《鸿蒙开发实战》
  

总结

鸿蒙—作为国家主力推送的国产操纵体系。部门的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。
并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来发作式的增长，学习鸿蒙势在必行！ 自↓↓↓拿

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。