从API version 10开始支持低时延音频录制。
低时延音频录制是一种通过软硬芯协同设计实现的音频采集方案。其核心机制是通过减少buffer大小、优化读写数据架构,使该模式下音频录制具有更低的时延。
为使用低时延模式,开发者需要参考推荐使用OHAudio开发音频录制功能(C/C++)进行音频开发。
当前OHAudio支持两种模式:普通模式(AUDIOSTREAM_LATENCY_MODE_NORMAL)和低时延模式(AUDIOSTREAM_LATENCY_MODE_FAST)。
开发者通过调用OH_AudioStreamBuilder_SetLatencyMode(),设置OH_AudioStream_LatencyMode来决定音频流使用的模式。
设置低时延模式开发示例:
OH_AudioStream_LatencyMode latencyMode = AUDIOSTREAM_LATENCY_MODE_FAST; OH_AudioStreamBuilder_SetLatencyMode(builder, latencyMode);
针对OHAudio开发音频录制,有以下相关实例可供参考:
在以下场景中,即使设置了低时延模式,系统仍会使用普通模式。
从API version 20开始,支持低时延相关查询接口。
音频录制的音频数据需要通过回调接口读入。开发者要实现回调接口,使用OH_AudioStreamBuilder_SetCapturerReadDataCallback设置回调函数,在设置音频回调函数时,回调函数OH_AudioCapturer_OnReadDataCallback(从API version 12开始支持)用于读取音频数据。
开发音频录制功能的示例代码请参考:推荐使用OHAudio开发音频录制功能(C/C++)。
设置数据回调函数示例:
int32_t MyOnReadData_Legacy(
OH_AudioCapturer* capturer,
void* userData,
void* buffer,
int32_t length)
{
// 从buffer中取出length长度的录音数据。
return 0;
}
// ...
// 配置读入音频数据回调函数。
OH_AudioCapturer_OnReadDataCallback readDataCb = MyOnReadData_NewAPI;
OH_AudioStreamBuilder_SetCapturerReadDataCallback(builder, readDataCb, nullptr); 为避免音频卡顿,禁止在回调方法OH_AudioCapturer_OnReadDataCallback中执行耗时操作。
为保证OH_AudioCapturer_OnReadDataCallback与流状态控制逻辑独立正常运行,禁止在OH_AudioCapturer_OnReadDataCallback回调方法中调用音频流控制接口。
| 音频流控制接口 | 说明 |
|---|---|
| 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_AudioCapturer_Stop接口单次执行普遍超过50ms),应避免在主线程中直接调用,以免造成界面显示卡顿。