从API版本26.0.0开始,OHAudioSuite给开发者提供PCM(Pulse Code Modulation)音频格式转换能力,在纯音频转码等场景下支持开发者使用格式转换接口将PCM音频数据从一种格式转换为另一种格式,包括采样率、声道布局、采样格式(位深)的转换。
开发者通过引入头文件<native_audio_converter.h>,使用音频格式转换相关API。
#include <ohaudiosuite/native_audio_converter.h>
音频格式转换相关接口返回值请参考:OH_AudioConverter_Result。
详细的API说明请参考:OHAudioSuite。
功能特性
格式转换器提供的核心功能如下所示:
使用限制
数据流处理流程
格式转换器采用流式数据处理模式,完整的数据处理流程如下所示:
初始化阶段。
数据输入阶段。
数据转换阶段。
数据输出阶段。
清理阶段。
支持的音频格式
格式转换接口支持以下PCM音频格式:
采样率:SAMPLE_RATE_8000、SAMPLE_RATE_11025、SAMPLE_RATE_12000、SAMPLE_RATE_16000、SAMPLE_RATE_22050、SAMPLE_RATE_24000、SAMPLE_RATE_32000、SAMPLE_RATE_44100、SAMPLE_RATE_48000、SAMPLE_RATE_64000、SAMPLE_RATE_88200、SAMPLE_RATE_96000、SAMPLE_RATE_176400、SAMPLE_RATE_192000。
声道布局:CH_LAYOUT_MONO、CH_LAYOUT_STEREO、CH_LAYOUT_STEREO_DOWNMIX、CH_LAYOUT_2POINT1、CH_LAYOUT_3POINT0、CH_LAYOUT_SURROUND、CH_LAYOUT_3POINT1、CH_LAYOUT_4POINT0、CH_LAYOUT_QUAD_SIDE、CH_LAYOUT_QUAD、CH_LAYOUT_2POINT0POINT2、CH_LAYOUT_4POINT1、CH_LAYOUT_5POINT0、CH_LAYOUT_5POINT0_BACK、CH_LAYOUT_2POINT1POINT2、CH_LAYOUT_3POINT0POINT2、CH_LAYOUT_5POINT1、CH_LAYOUT_5POINT1_BACK、CH_LAYOUT_6POINT0、CH_LAYOUT_3POINT1POINT2、CH_LAYOUT_6POINT0_FRONT、CH_LAYOUT_HEXAGONAL、CH_LAYOUT_6POINT1、CH_LAYOUT_6POINT1_BACK、CH_LAYOUT_6POINT1_FRONT、CH_LAYOUT_7POINT0、CH_LAYOUT_7POINT0_FRONT、CH_LAYOUT_7POINT1、CH_LAYOUT_OCTAGONAL、CH_LAYOUT_5POINT1POINT2、CH_LAYOUT_7POINT1_WIDE、CH_LAYOUT_7POINT1_WIDE_BACK。
采样格式:AUDIO_SAMPLE_U8、AUDIO_SAMPLE_S16LE、AUDIO_SAMPLE_S24LE、AUDIO_SAMPLE_S32LE、AUDIO_SAMPLE_F32LE。
// 用户需按照实际情况设置输入格式。
OH_AudioConverter_Format inputFormat = {
.encodingType = OH_Audio_EncodingType::AUDIO_ENCODING_TYPE_RAW,
.samplingRate = OH_Audio_SampleRate::SAMPLE_RATE_48000,
.channelLayout = OH_AudioChannelLayout::CH_LAYOUT_STEREO,
.sampleFormat = OH_Audio_SampleFormat::AUDIO_SAMPLE_S16LE
};
// 用户需按照实际情况设置输出格式。
OH_AudioConverter_Format outputFormat = {
.encodingType = OH_Audio_EncodingType::AUDIO_ENCODING_TYPE_RAW,
.samplingRate = OH_Audio_SampleRate::SAMPLE_RATE_192000,
.channelLayout = OH_AudioChannelLayout::CH_LAYOUT_6POINT0_FRONT,
.sampleFormat = OH_Audio_SampleFormat::AUDIO_SAMPLE_S24LE
};
// 创建转换器。
OH_AudioConverter_Result result = OH_AudioConverter_Create(&inputFormat, &outputFormat, &converter);
if (result != AUDIOCONVERTER_SUCCESS) {
OH_LOG_Print(LOG_APP, LOG_ERROR, GLOBAL_RESMGR, TAG, "Failed to create converter: %{public}d", result);
return false;
} 创建输入数据回调函数RequestDataCallback,函数类型为OH_AudioConverter_RequestDataCallback(),调用OH_AudioConverter_SetInputCallback()接口设置回调函数。
输入数据回调函数。
// 设置输入数据指针。
// 注意:数据指针的值并不一定要从userData中获取,也可以是存储数据的缓存地址。
// 例如:从文件中读取数据放入缓存,然后将该缓存地址赋值给输出数据指针。
// 只要确保数据指针在OH_AudioConverter_Process()返回前保持有效即可。
*outInputData = dataInfo->buffer + dataInfo->readDataOffset;
// 计算本次可提供的数据大小(单次回调最多返回400KB)。
// bufferSize:文件的总字节数。
// readDataOffset:已读取的字节数偏移量。
int32_t remainingSize = dataInfo->bufferSize - dataInfo->readDataOffset;
if (remainingSize < 0) {
return -1;
}
int32_t actualDataSize = (remainingSize < MAX_DATA_SIZE) ? remainingSize : MAX_DATA_SIZE;
// 更新已读取位置。
dataInfo->readDataOffset += actualDataSize;
// 设置输入数据状态。
if (dataInfo->readDataOffset >= dataInfo->bufferSize) {
*outStatus = OH_AudioConverter_InputStatus::AUDIOCONVERTER_INPUT_DATA_FINISHED;
dataInfo->readDataFinish = true;
} else {
*outStatus = OH_AudioConverter_InputStatus::AUDIOCONVERTER_INPUT_HAVE_DATA;
} 设置输入数据回调。
// 设置输入回调。
result = OH_AudioConverter_SetInputCallback(converter, AudioConverterRequestDataCallback, dataInfo);
if (result != AUDIOCONVERTER_SUCCESS) {
OH_LOG_Print(LOG_APP, LOG_ERROR, GLOBAL_RESMGR, TAG, "Failed to set input callback: %{public}d", result);
OH_AudioConverter_Destroy(converter);
return false;
} 调用OH_AudioConverter_Process()接口执行格式转换。
// 分配处理缓冲区。
const int32_t processBufferSize = 4096 * 4; // 16KB。
uint8_t *processBuffer = new uint8_t[processBufferSize];
int32_t outputSize = 0;
int32_t totalOutputSize = 0;
OH_AudioConverter_Result result;
do {
result = OH_AudioConverter_Process(converter, processBuffer, processBufferSize, &outputSize);
if (result != AUDIOCONVERTER_SUCCESS) {
OH_LOG_Print(LOG_APP, LOG_ERROR, GLOBAL_RESMGR, TAG, "Audio data processing failed: %{public}d", result);
delete[] processBuffer;
SafeCloseConverterFile(outputFile, outputFilePath);
return false;
}
if (outputSize > 0) {
// 用户可以根据自己的业务要求做相应的处理。
size_t written = fwrite(processBuffer, 1, outputSize, outputFile);
if (written != static_cast<size_t>(outputSize)) {
OH_LOG_Print(LOG_APP, LOG_ERROR, GLOBAL_RESMGR, TAG, "Failed to write output data");
delete[] processBuffer;
SafeCloseConverterFile(outputFile, outputFilePath);
return false;
}
totalOutputSize += outputSize;
}
// outputSize返回0,且用户写入数据完成。
} while (outputSize > 0 || !dataInfo->readDataFinish);
delete[] processBuffer;
processBuffer = nullptr;
SafeCloseConverterFile(outputFile, outputFilePath);