从API version 22开始，OHAudioSuite给开发者提供音频离线编辑能力，允许在非实时预览场景下对音频数据进行处理，开发者可以组合多个音频节点实现复杂的音频处理流程。
[h2]添加头文件
开发者通过引入头文件<native_audio_suite_base.h>和<native_audio_suite_engine.h>，使用音频编创相关API。
#include <ohaudiosuite/native_audio_suite_base.h> #include <ohaudiosuite/native_audio_suite_engine.h>
[h2]指定音频节点格式
开发者需要根据业务场景，调用OH_AudioSuiteNodeBuilder_SetFormat()或者OH_AudioSuiteEngine_SetAudioFormat()接口，设置音频格式（位深（OH_Audio_SampleFormat）、采样率（OH_Audio_SampleRate）、声道数（OH_AudioChannelLayout）等）。
[h2]基础离线编辑
使用效果节点（如均衡器效果节点）处理输入的PCM（Pulse Code Modulation）音频数据，输出带有该音效的PCM音频数据。此处以均衡器效果为例演示离线编辑流程，其他效果节点的详细说明请参考音频效果(C/C++)。
图1：基础离线编辑示意图
-
创建引擎和管线。
// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 创建引擎。 OH_AudioSuiteEngine *audioSuiteEngine = nullptr; OH_AudioSuiteEngine_Create(&audioSuiteEngine); // 创建管线。 OH_AudioSuitePipeline *audioSuitePipeline = nullptr; OH_AudioSuiteEngine_CreatePipeline(audioSuiteEngine, &audioSuitePipeline, OH_AudioSuite_PipelineWorkMode::AUDIOSUITE_PIPELINE_EDIT_MODE); -
创建输入、输出、均衡器节点并连接组网。
创建输入节点需要实现自定义回调函数InputNodeWriteDataCallBack，函数类型为OH_InputNode_RequestDataCallback()，调用OH_AudioSuiteNodeBuilder_SetRequestDataCallback()接口设置回调函数。
struct AudioDataInfo { uint8_t *buffer = nullptr; // 音频数据。 int32_t bufferSize = 0; // 音频数据总大小。 int32_t totalWriteSize = 0; // 处理过的音频数据总大小。 int32_t totalReadSize = 0; // 已读取的音频数据总大小。 };// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 输入节点请求数据的回调函数。 static int32_t InputNodeWriteDataCallBack(OH_AudioNode *audioNode, void *userData, void *audioData, int32_t audioDataSize, bool *finished) { if ((audioNode == nullptr) || (userData == nullptr) || (audioData == nullptr) || (audioDataSize <= 0) || (finished == nullptr)) { return -1; } struct AudioDataInfo *info = static_cast<struct AudioDataInfo *>(userData); // 要处理的音频大小。 int32_t actualDataSize = std::min(audioDataSize, info->bufferSize - info->totalWriteSize); // 将PCM音频数据写入audioData。 if (actualDataSize > 0) { std::copy(info->buffer + info->totalWriteSize, info->buffer + info->totalWriteSize + actualDataSize, static_cast<uint8_t *>(audioData)); } info->totalWriteSize += actualDataSize; // 音频数据全部处理完。 if (info->totalWriteSize >= info->bufferSize) { *finished = true; } return actualDataSize; }// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 创建节点构造器。 OH_AudioNodeBuilder *nodeBuilder = nullptr; OH_AudioSuiteNodeBuilder_Create(&nodeBuilder); OH_AudioSuiteNodeBuilder_SetNodeType(nodeBuilder, OH_AudioNode_Type::INPUT_NODE_TYPE_DEFAULT); // 配置音频数据格式，开发者根据要处理的音频数据格式设置采样率、声道分布、声道数、位深、编码格式参数。 OH_AudioFormat audioFormatInput; audioFormatInput.samplingRate = OH_Audio_SampleRate::SAMPLE_RATE_48000; audioFormatInput.channelLayout = OH_AudioChannelLayout::CH_LAYOUT_STEREO; audioFormatInput.channelCount = CHANNEL_COUNT; audioFormatInput.sampleFormat = OH_Audio_SampleFormat::AUDIO_SAMPLE_S16LE; audioFormatInput.encodingType = OH_Audio_EncodingType::AUDIO_ENCODING_TYPE_RAW; OH_AudioSuiteNodeBuilder_SetFormat(nodeBuilder, audioFormatInput); // 设置音频流的回调。 void *userData = static_cast<void *>(audioInfo); OH_AudioSuiteNodeBuilder_SetRequestDataCallback(nodeBuilder, InputNodeWriteDataCallBack, userData); // 创建输入节点。 OH_AudioSuiteEngine_CreateNode(audioSuitePipeline, nodeBuilder, &nodes.inputNode); // 重置构造器配置，创建效果节点。 OH_AudioSuiteNodeBuilder_Reset(nodeBuilder); // 可根据需要设置不同的效果节点类型。
设置均衡器效果。
// 设置为均衡器节点类型。 OH_AudioSuiteNodeBuilder_SetNodeType(builder, OH_AudioNode_Type::EFFECT_NODE_TYPE_EQUALIZER); // 创建均衡器节点。 OH_AudioSuiteEngine_CreateNode(pipeline, builder, node); // ... // 设置均衡器节点效果。 OH_AudioSuiteEngine_SetEqualizerFrequencyBandGains(*node, gains);
// 重置构造器配置并设置为输出节点类型。 OH_AudioSuiteNodeBuilder_Reset(nodeBuilder); OH_AudioSuiteNodeBuilder_SetNodeType(nodeBuilder, OH_AudioNode_Type::OUTPUT_NODE_TYPE_DEFAULT); // 配置音频数据格式，开发者根据预期输出的音频格式设置采样率、声道分布、声道数、位深、编码格式参数。 OH_AudioFormat audioFormatOutput; audioFormatOutput.samplingRate = OH_Audio_SampleRate::SAMPLE_RATE_48000; audioFormatOutput.channelLayout = OH_AudioChannelLayout::CH_LAYOUT_STEREO; audioFormatOutput.channelCount = CHANNEL_COUNT; audioFormatOutput.sampleFormat = OH_Audio_SampleFormat::AUDIO_SAMPLE_S16LE; audioFormatOutput.encodingType = OH_Audio_EncodingType::AUDIO_ENCODING_TYPE_RAW; OH_AudioSuiteNodeBuilder_SetFormat(nodeBuilder, audioFormatOutput); // 创建输出节点。 OH_AudioSuiteEngine_CreateNode(audioSuitePipeline, nodeBuilder, &nodes.outputNode); // 销毁节点构造器。 OH_AudioSuiteNodeBuilder_Destroy(nodeBuilder); // 连接各个节点组成组网。 OH_AudioSuiteEngine_ConnectNodes(nodes.inputNode, nodes.eqNode); OH_AudioSuiteEngine_ConnectNodes(nodes.eqNode, nodes.outputNode);
-
渲染音频数据。
开发者调用OH_AudioSuiteEngine_RenderFrame()接口渲染并获取PCM音频数据。
// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 根据输出节点的格式计算单帧处理数据大小。如果samplingRate为11025请使用40ms来计算。 int32_t frameSize = RENDER_FRAME_DURATION_MS * OH_Audio_SampleRate::SAMPLE_RATE_48000 * CHANNEL_COUNT * SAMPLE_FORMAT_S16LE_BYTE_SIZE / MS_PER_SECOND; // 用于接收渲染后的输出音频数据。 uint8_t *audioData = (uint8_t *)malloc(frameSize); int32_t responseSize = 0; bool finished = false; // 渲染。 OH_AudioSuiteEngine_StartPipeline(audioSuitePipeline); // ... do { OH_AudioSuite_Result result = OH_AudioSuiteEngine_RenderFrame( audioSuitePipeline, static_cast<void *>(audioData), frameSize, &responseSize, &finished); if ((result != OH_AudioSuite_Result::AUDIOSUITE_SUCCESS) || (responseSize <= 0)) { // 本次音频编创渲染失败。 break; } else { // audioData是渲染过后的音频数据，音频数据长度为responseSize，开发者根据业务场景自行使用或者保存。 // ... } } while (!finished); // ... OH_AudioSuiteEngine_StopPipeline(audioSuitePipeline); free(audioData); audioData = nullptr; -
资源销毁。
// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 销毁节点。 OH_AudioSuiteEngine_DestroyNode(nodes.inputNode); OH_AudioSuiteEngine_DestroyNode(nodes.eqNode); OH_AudioSuiteEngine_DestroyNode(nodes.outputNode); // 销毁管线。 OH_AudioSuiteEngine_DestroyPipeline(audioSuitePipeline); // 销毁引擎。 OH_AudioSuiteEngine_Destroy(audioSuiteEngine);
[h2]音源分离场景
使用音源分离节点分离输入的PCM音频数据为人声和背景声，然后通过输出节点分别输出这两路数据。
创建音源分离节点前需要调用OH_AudioSuiteEngine_IsNodeTypeSupported()检查是否支持该节点类型，避免创建节点失败。
图2：音源分离编辑示意图
示例代码如下：
-
创建引擎和管线。
// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 创建引擎。 OH_AudioSuiteEngine *audioSuiteEngine = nullptr; OH_AudioSuiteEngine_Create(&audioSuiteEngine); // 创建管线。 OH_AudioSuitePipeline *audioSuitePipeline = nullptr; OH_AudioSuiteEngine_CreatePipeline(audioSuiteEngine, &audioSuitePipeline, OH_AudioSuite_PipelineWorkMode::AUDIOSUITE_PIPELINE_EDIT_MODE); -
创建输入、输出、音源分离节点并连接。
创建输入节点需要实现自定义回调函数InputNodeWriteDataCallBack，函数类型为OH_InputNode_RequestDataCallback()，调用OH_AudioSuiteNodeBuilder_SetRequestDataCallback()接口设置回调函数。
struct AudioDataInfo { uint8_t *buffer = nullptr; // 音频数据。 int32_t bufferSize = 0; // 音频数据总大小。 int32_t totalWriteSize = 0; // 处理过的音频数据总大小。 int32_t totalReadSize = 0; // 已读取的音频数据总大小。 };// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 输入节点请求数据的回调函数。 static int32_t InputNodeWriteDataCallBack(OH_AudioNode *audioNode, void *userData, void *audioData, int32_t audioDataSize, bool *finished) { if ((audioNode == nullptr) || (userData == nullptr) || (audioData == nullptr) || (audioDataSize <= 0) || (finished == nullptr)) { return -1; } struct AudioDataInfo *info = static_cast<struct AudioDataInfo *>(userData); // 要处理的音频大小。 int32_t actualDataSize = std::min(audioDataSize, info->bufferSize - info->totalWriteSize); // 将PCM音频数据写入audioData。 if (actualDataSize > 0) { std::copy(info->buffer + info->totalWriteSize, info->buffer + info->totalWriteSize + actualDataSize, static_cast<uint8_t *>(audioData)); } info->totalWriteSize += actualDataSize; // 音频数据全部处理完。 if (info->totalWriteSize >= info->bufferSize) { *finished = true; } return actualDataSize; }// 判断是否支持音源分离节点。 bool isSupported = false; OH_AudioSuiteEngine_IsNodeTypeSupported(OH_AudioNode_Type::EFFECT_MULTII_OUTPUT_NODE_TYPE_AUDIO_SEPARATION, &isSupported); if (!isSupported) { OH_LOG_Print(LOG_APP, LOG_ERROR, GLOBAL_RESMGR, TAG, "Audio separation node is not supported on this device."); nodes.isNodeSupported = false; return nodes; }// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 创建节点构造器。 OH_AudioNodeBuilder *nodeBuilder = nullptr; OH_AudioSuiteNodeBuilder_Create(&nodeBuilder); OH_AudioSuiteNodeBuilder_SetNodeType(nodeBuilder, OH_AudioNode_Type::INPUT_NODE_TYPE_DEFAULT); // 配置音频数据格式，开发者根据要处理的音频数据格式设置采样率、声道分布、声道数、位深、编码格式参数。 OH_AudioFormat audioFormatInput; audioFormatInput.samplingRate = OH_Audio_SampleRate::SAMPLE_RATE_48000; audioFormatInput.channelLayout = OH_AudioChannelLayout::CH_LAYOUT_STEREO; audioFormatInput.channelCount = CHANNEL_COUNT; audioFormatInput.sampleFormat = OH_Audio_SampleFormat::AUDIO_SAMPLE_S16LE; audioFormatInput.encodingType = OH_Audio_EncodingType::AUDIO_ENCODING_TYPE_RAW; OH_AudioSuiteNodeBuilder_SetFormat(nodeBuilder, audioFormatInput); void *userData = static_cast<void *>(audioInfo); // 设置音频流的回调。 OH_AudioSuiteNodeBuilder_SetRequestDataCallback(nodeBuilder, InputNodeWriteDataCallBack, userData); // 创建输入节点。 OH_AudioSuiteEngine_CreateNode(audioSuitePipeline, nodeBuilder, &nodes.inputNode); // 重置构造器配置并设置为音源分离节点类型。 OH_AudioSuiteNodeBuilder_Reset(nodeBuilder); OH_AudioSuiteNodeBuilder_SetNodeType(nodeBuilder, OH_AudioNode_Type::EFFECT_MULTII_OUTPUT_NODE_TYPE_AUDIO_SEPARATION); // 创建音源分离节点。 OH_AudioSuiteEngine_CreateNode(audioSuitePipeline, nodeBuilder, &nodes.aissNode); // 重置构造器配置并设置为输出节点类型。 OH_AudioSuiteNodeBuilder_Reset(nodeBuilder); OH_AudioSuiteNodeBuilder_SetNodeType(nodeBuilder, OH_AudioNode_Type::OUTPUT_NODE_TYPE_DEFAULT); // 配置音频数据格式，开发者根据预期输出的音频格式设置采样率、声道分布、声道数、位深、编码格式参数。 OH_AudioFormat audioFormatOutput; audioFormatOutput.samplingRate = OH_Audio_SampleRate::SAMPLE_RATE_48000; audioFormatOutput.channelLayout = OH_AudioChannelLayout::CH_LAYOUT_STEREO; audioFormatOutput.channelCount = CHANNEL_COUNT; audioFormatOutput.sampleFormat = OH_Audio_SampleFormat::AUDIO_SAMPLE_S16LE; audioFormatOutput.encodingType = OH_Audio_EncodingType::AUDIO_ENCODING_TYPE_RAW; OH_AudioSuiteNodeBuilder_SetFormat(nodeBuilder, audioFormatOutput); // 创建输出节点。 OH_AudioSuiteEngine_CreateNode(audioSuitePipeline, nodeBuilder, &nodes.outputNode); // 销毁节点构造器。 OH_AudioSuiteNodeBuilder_Destroy(nodeBuilder); // 连接各个节点组成组网。 OH_AudioSuiteEngine_ConnectNodes(nodes.inputNode, nodes.aissNode); OH_AudioSuiteEngine_ConnectNodes(nodes.aissNode, nodes.outputNode); -
渲染音频数据。
包含音源分离节点的管线使用OH_AudioSuiteEngine_MultiRenderFrame()接口渲染并获取两路PCM音频数据。
// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 根据输出节点的格式计算单帧处理数据大小。如果samplingRate为11025请使用40ms来计算。 int32_t frameSize = RENDER_FRAME_DURATION_MS * OH_Audio_SampleRate::SAMPLE_RATE_48000 * CHANNEL_COUNT * SAMPLE_FORMAT_S16LE_BYTE_SIZE / MS_PER_SECOND; // 用于接收渲染后的输出音频数据。 OH_AudioDataArray audioDataArray; int32_t outputNum = 2; audioDataArray.audioDataArray = (void **)malloc(outputNum * sizeof(void *)); for (int32_t i = 0; i < outputNum; i++) { audioDataArray.audioDataArray[i] = (void *)malloc(frameSize); } audioDataArray.arraySize = outputNum; audioDataArray.requestFrameSize = frameSize; int32_t responseSize = 0; bool finished = false; // 渲染。 OH_AudioSuiteEngine_StartPipeline(audioSuitePipeline); // ... do { OH_AudioSuite_Result result = OH_AudioSuiteEngine_MultiRenderFrame(audioSuitePipeline, &audioDataArray, &responseSize, &finished); if ((result != OH_AudioSuite_Result::AUDIOSUITE_SUCCESS) || (responseSize <= 0)) { // 本次音频编创渲染失败。 break; } else { // audioDataArray.audioDataArray[0]是提取的人声。 // audioDataArray.audioDataArray[1]是提取的背景声。 // 音频数据长度为responseSize，开发者根据业务场景自行使用或者保存。 // ... } } while (!finished); // ... OH_AudioSuiteEngine_StopPipeline(audioSuitePipeline); for (int32_t i = 0; i < outputNum; i++) { free(audioDataArray.audioDataArray[i]); audioDataArray.audioDataArray[i] = nullptr; } free(audioDataArray.audioDataArray); audioDataArray.audioDataArray = nullptr; -
资源销毁。
// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 销毁节点。 OH_AudioSuiteEngine_DestroyNode(nodes.inputNode); OH_AudioSuiteEngine_DestroyNode(nodes.aissNode); OH_AudioSuiteEngine_DestroyNode(nodes.outputNode); // 销毁管线。 OH_AudioSuiteEngine_DestroyPipeline(audioSuitePipeline); // 销毁引擎。 OH_AudioSuiteEngine_Destroy(audioSuiteEngine);
[h2]混音与级联
输入多路PCM音频数据，使用混音节点进行混音，输出混音后的PCM音频数据。
图3：级联编辑示意图
示例代码如下：
-
创建引擎和管线。
// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 创建引擎。 OH_AudioSuiteEngine *audioSuiteEngine = nullptr; OH_AudioSuiteEngine_Create(&audioSuiteEngine); // 创建管线。 OH_AudioSuitePipeline *audioSuitePipeline = nullptr; OH_AudioSuiteEngine_CreatePipeline(audioSuiteEngine, &audioSuitePipeline, OH_AudioSuite_PipelineWorkMode::AUDIOSUITE_PIPELINE_EDIT_MODE); -
创建输入、输出、效果类节点并连接。
由于混音功能有多个输入节点，需单独设置回调函数InputNodeWriteDataCallBack中的userData参数来区分多个输入节点，从而实现多个PCM音频数据的输入。InputNodeWriteDataCallBack函数类型为OH_InputNode_RequestDataCallback()。
struct AudioDataInfo { uint8_t *buffer = nullptr; // 音频数据。 int32_t bufferSize = 0; // 音频数据总大小。 int32_t totalWriteSize = 0; // 处理过的音频数据总大小。 int32_t totalReadSize = 0; // 已读取的音频数据总大小。 };// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 输入节点请求数据的回调函数。 static int32_t InputNodeWriteDataCallBack(OH_AudioNode *audioNode, void *userData, void *audioData, int32_t audioDataSize, bool *finished) { if ((audioNode == nullptr) || (userData == nullptr) || (audioData == nullptr) || (audioDataSize <= 0) || (finished == nullptr)) { return -1; } struct AudioDataInfo *info = static_cast<struct AudioDataInfo *>(userData); // 要处理的音频大小。 int32_t actualDataSize = std::min(audioDataSize, info->bufferSize - info->totalWriteSize); // 将PCM音频数据写入audioData。 if (actualDataSize > 0) { std::copy(info->buffer + info->totalWriteSize, info->buffer + info->totalWriteSize + actualDataSize, static_cast<uint8_t *>(audioData)); } info->totalWriteSize += actualDataSize; // 音频数据全部处理完。 if (info->totalWriteSize >= info->bufferSize) { *finished = true; } return actualDataSize; }// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 创建节点构造器。 OH_AudioNodeBuilder *nodeBuilder = nullptr; OH_AudioSuiteNodeBuilder_Create(&nodeBuilder); OH_AudioSuiteNodeBuilder_SetNodeType(nodeBuilder, OH_AudioNode_Type::INPUT_NODE_TYPE_DEFAULT); // 配置音频数据格式，开发者根据要处理的音频数据格式设置采样率、声道分布、声道数、位深、编码格式参数。 OH_AudioFormat audioFormatInput; audioFormatInput.samplingRate = OH_Audio_SampleRate::SAMPLE_RATE_48000; audioFormatInput.channelLayout = OH_AudioChannelLayout::CH_LAYOUT_STEREO; audioFormatInput.channelCount = CHANNEL_COUNT; audioFormatInput.sampleFormat = OH_Audio_SampleFormat::AUDIO_SAMPLE_S16LE; audioFormatInput.encodingType = OH_Audio_EncodingType::AUDIO_ENCODING_TYPE_RAW; OH_AudioSuiteNodeBuilder_SetFormat(nodeBuilder, audioFormatInput); // 设置第一个音频流的回调。 void *userData = static_cast<void *>(audioInfoForField); OH_AudioSuiteNodeBuilder_SetRequestDataCallback(nodeBuilder, InputNodeWriteDataCallBack, userData); // 创建第一个输入节点。 OH_AudioSuiteEngine_CreateNode(audioSuitePipeline, nodeBuilder, &nodes.inputNodeForField); // 重置构造器配置并设置为输入节点类型。 OH_AudioSuiteNodeBuilder_Reset(nodeBuilder); OH_AudioSuiteNodeBuilder_SetNodeType(nodeBuilder, OH_AudioNode_Type::INPUT_NODE_TYPE_DEFAULT); OH_AudioSuiteNodeBuilder_SetFormat(nodeBuilder, audioFormatInput); // 设置第二个音频流的回调。 userData = static_cast<void *>(audioInfoForMix); OH_AudioSuiteNodeBuilder_SetRequestDataCallback(nodeBuilder, InputNodeWriteDataCallBack, userData); // 创建第二个输入节点。 OH_AudioSuiteEngine_CreateNode(audioSuitePipeline, nodeBuilder, &nodes.inputNodeForMix); // 重置构造器配置并设置为声场节点类型。 OH_AudioSuiteNodeBuilder_Reset(nodeBuilder); OH_AudioSuiteNodeBuilder_SetNodeType(nodeBuilder, OH_AudioNode_Type::EFFECT_NODE_TYPE_SOUND_FIELD); // 创建声场节点并设置声场模式为前置。 OH_AudioSuiteEngine_CreateNode(audioSuitePipeline, nodeBuilder, &nodes.fieldNode); OH_AudioSuiteEngine_SetSoundFieldType(nodes.fieldNode, SOUND_FIELD_FRONT_FACING); // 重置构造器配置并设置为混音节点类型。 OH_AudioSuiteNodeBuilder_Reset(nodeBuilder); OH_AudioSuiteNodeBuilder_SetNodeType(nodeBuilder, OH_AudioNode_Type::EFFECT_NODE_TYPE_AUDIO_MIXER); // 创建混音节点。 OH_AudioSuiteEngine_CreateNode(audioSuitePipeline, nodeBuilder, &nodes.mixerNode); // 重置构造器配置并设置为输出节点类型。 OH_AudioSuiteNodeBuilder_Reset(nodeBuilder); OH_AudioSuiteNodeBuilder_SetNodeType(nodeBuilder, OH_AudioNode_Type::OUTPUT_NODE_TYPE_DEFAULT); // 配置音频数据格式，开发者根据预期输出的音频格式设置采样率、声道分布、声道数、位深、编码格式参数。 OH_AudioFormat audioFormatOutput; audioFormatOutput.samplingRate = OH_Audio_SampleRate::SAMPLE_RATE_48000; audioFormatOutput.channelLayout = OH_AudioChannelLayout::CH_LAYOUT_STEREO; audioFormatOutput.channelCount = CHANNEL_COUNT; audioFormatOutput.sampleFormat = OH_Audio_SampleFormat::AUDIO_SAMPLE_S16LE; audioFormatOutput.encodingType = OH_Audio_EncodingType::AUDIO_ENCODING_TYPE_RAW; OH_AudioSuiteNodeBuilder_SetFormat(nodeBuilder, audioFormatOutput); // 创建输出节点。 OH_AudioSuiteEngine_CreateNode(audioSuitePipeline, nodeBuilder, &nodes.outputNode); // 销毁输出节点构造器。 OH_AudioSuiteNodeBuilder_Destroy(nodeBuilder); // 连接各个节点组成组网。 OH_AudioSuiteEngine_ConnectNodes(nodes.inputNodeForField, nodes.fieldNode); OH_AudioSuiteEngine_ConnectNodes(nodes.fieldNode, nodes.mixerNode); OH_AudioSuiteEngine_ConnectNodes(nodes.inputNodeForMix, nodes.mixerNode); OH_AudioSuiteEngine_ConnectNodes(nodes.mixerNode, nodes.outputNode);
-
渲染音频数据。
开发者调用OH_AudioSuiteEngine_RenderFrame()接口渲染并获取PCM音频数据。
// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 根据输出节点的格式计算单帧处理数据大小。如果samplingRate为11025请使用40ms来计算。 int32_t frameSize = RENDER_FRAME_DURATION_MS * OH_Audio_SampleRate::SAMPLE_RATE_48000 * CHANNEL_COUNT * SAMPLE_FORMAT_S16LE_BYTE_SIZE / MS_PER_SECOND; // 用于接收渲染后的输出音频数据。 uint8_t *audioData = (uint8_t *)malloc(frameSize); int32_t responseSize = 0; bool finished = false; // 渲染。 OH_AudioSuiteEngine_StartPipeline(audioSuitePipeline); // ... do { OH_AudioSuite_Result result = OH_AudioSuiteEngine_RenderFrame( audioSuitePipeline, static_cast<void *>(audioData), frameSize, &responseSize, &finished); if ((result != OH_AudioSuite_Result::AUDIOSUITE_SUCCESS) || (responseSize <= 0)) { // 本次音频编创渲染失败。 break; } else { // audioData是渲染过后的音频数据，音频数据长度为responseSize，开发者根据业务场景自行使用或者保存。 // ... } } while (!finished); // ... OH_AudioSuiteEngine_StopPipeline(audioSuitePipeline); free(audioData); audioData = nullptr; -
资源销毁。
// 示例接口未包含返回值校验，实际使用时请务必添加校验逻辑。 // 销毁节点。 OH_AudioSuiteEngine_DestroyNode(nodes.inputNodeForMix); OH_AudioSuiteEngine_DestroyNode(nodes.inputNodeForField); OH_AudioSuiteEngine_DestroyNode(nodes.fieldNode); OH_AudioSuiteEngine_DestroyNode(nodes.mixerNode); OH_AudioSuiteEngine_DestroyNode(nodes.outputNode); // 销毁管线。 OH_AudioSuiteEngine_DestroyPipeline(audioSuitePipeline); // 销毁引擎。 OH_AudioSuiteEngine_Destroy(audioSuiteEngine);