1# 使用OHAudio开发音频播放功能 2 3OHAudio是OpenHarmony在API version 10中引入的一套全新Native API，此API在设计上实现归一，同时支持普通音频通路和低时延通路。 4 5## 使用入门 6 7开发者要使用OHAudio提供的播放或者录制能力，需要添加对应的头文件。 8 9开发者通过引入<[native_audiostreambuilder.h](../reference/native-apis/native__audiostreambuilder_8h.md)>和<[native_audiorenderer.h](../reference/native-apis/native__audiorenderer_8h.md)>头文件，使用音频播放相关API。 10 11## 音频流构造器 12 13OHAudio提供OH_AudioStreamBuilder接口，遵循构造器设计模式，用于构建音频流。开发者需要根据业务场景，指定对应的[OH_AudioStream_Type](../reference/native-apis/_o_h_audio.md#oh_audiostream_type) 。 14 15`OH_AudioStream_Type`包含两种类型： 16 17- AUDIOSTREAM_TYPE_RENDERER 18- AUDIOSTREAM_TYPE_CAPTURER 19 20使用[OH_AudioStreamBuilder_Create](../reference/native-apis/_o_h_audio.md#oh_audiostreambuilder_create)创建构造器示例： 21 22``` 23OH_AudioStreamBuilder* builder; 24OH_AudioStreamBuilder_Create(&builder, streamType); 25``` 26 27在音频业务结束之后，开发者应该执行[OH_AudioStreamBuilder_Destroy](../reference/native-apis/_o_h_audio.md#oh_audiostreambuilder_destroy)接口来销毁构造器。 28 29``` 30OH_AudioStreamBuilder_Destroy(builder); 31``` 32 33## 开发步骤及注意事项 34 35详细的API说明请参考[OHAudio API参考](../reference/native-apis/_o_h_audio.md)。 36 37开发者可以通过以下几个步骤来实现一个简单的播放功能。 38 391. 创建构造器 40 41 ```c++ 42 OH_AudioStreamBuilder* builder; 43 OH_AudioStreamBuilder_Create(&builder, AUDIOSTREAM_TYPE_RENDERER); 44 ``` 45 462. 配置音频流参数 47 48 创建音频播放构造器后，可以设置音频流所需要的参数，可以参考下面的案例。 49 50 ```c++ 51 OH_AudioStreamBuilder_SetSamplingRate(builder, rate); 52 OH_AudioStreamBuilder_SetChannelCount(builder, channelCount); 53 OH_AudioStreamBuilder_SetSampleFormat(builder, format); 54 OH_AudioStreamBuilder_SetEncodingType(builder, encodingType); 55 OH_AudioStreamBuilder_SetRendererInfo(builder, usage); 56 ``` 57 58 注意，播放的音频数据要通过回调接口写入，开发者要实现回调接口，使用`OH_AudioStreamBuilder_SetRendererCallback`设置回调函数。回调函数的声明请查看[OH_AudioRenderer_Callbacks](../reference/native-apis/_o_h_audio.md#oh_audiorenderer_callbacks) 。 59 60 613. 设置回调函数 62 63 ```c++ 64 OH_AudioStreamBuilder_SetRendererCallback(builder, callbacks, nullptr); 65 ``` 66 674. 构造播放音频流 68 69 ```c++ 70 OH_AudioRenderer* audioRenderer; 71 OH_AudioStreamBuilder_GenerateRenderer(builder, &audioRenderer); 72 ``` 73 745. 使用音频流 75 76 音频流包含下面接口，用来实现对音频流的控制。 77 78 | 接口 | 说明 | 79 | ------------------------------------------------------------ | ------------ | 80 | OH_AudioStream_Result OH_AudioRenderer_Start(OH_AudioRenderer* renderer) | 开始播放 | 81 | OH_AudioStream_Result OH_AudioRenderer_Pause(OH_AudioRenderer* renderer) | 暂停播放 | 82 | OH_AudioStream_Result OH_AudioRenderer_Stop(OH_AudioRenderer* renderer) | 停止播放 | 83 | OH_AudioStream_Result OH_AudioRenderer_Flush(OH_AudioRenderer* renderer) | 释放缓存数据 | 84 | OH_AudioStream_Result OH_AudioRenderer_Release(OH_AudioRenderer* renderer) | 释放播放实例 | 85 866. 释放构造器 87 88 构造器不再使用时，需要释放相关资源。 89 90 ```c++ 91 OH_AudioStreamBuilder_Destroy(builder); 92 ``` 93 94## 设置低时延模式 95 96当设备支持低时延通路时，开发者可以使用低时延模式创建播放器，获得更高质量的音频体验。 97 98开发流程与普通播放场景一致，仅需要在创建音频流构造器时，调用[OH_AudioStreamBuilder_SetLatencyMode()](../reference/native-apis/_o_h_audio.md#oh_audiostreambuilder_setlatencymode)设置低时延模式。 99 100开发示例 101 102```C 103OH_AudioStream_LatencyMode latencyMode = AUDIOSTREAM_LATENCY_MODE_FAST; 104OH_AudioStreamBuilder_SetLatencyMode(builder, latencyMode); 105``` 106