输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
指南
指南媒体Audio Kit（音频服务）音频录制推荐使用OHAudio开发音频录制功能(C/C++)

推荐使用OHAudio开发音频录制功能(C/C++)

更新时间: 2026-06-17 08:22
本文导读
展开章节

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

当音频流处于工作状态（非released状态）时，会占用系统的音频流资源。由于系统对音频流数量有限制，所以当客户端暂时不使用音频流时，调用OH_AudioCapturer_Release()回收音频资源，做好资源利用，避免后续创建音频流失败。

OHAudio音频录制状态变化示意图：

使用入门

开发者要使用OHAudio提供的录制能力，需要添加对应的头文件。

以下各步骤示例为片段代码，可通过示例代码右下方链接获取完整示例。

在 CMake 脚本中链接动态库

收起
自动换行
深色代码主题
复制
  1. target_link_libraries(sample PUBLIC libohaudio.so)

添加头文件

开发者通过引入<native_audiostreambuilder.h>和<native_audiocapturer.h>头文件，使用音频录制相关API。

收起
自动换行
深色代码主题
复制
  1. #include <ohaudio/native_audiocapturer.h>
  2. #include <ohaudio/native_audiostreambuilder.h>
AudioCapture.cpp

开发步骤

详细的API说明请参考OHAudio。

音频流构造器

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);
AudioCapture.cpp

在音频业务结束之后，开发者应该执行OH_AudioStreamBuilder_Destroy接口来销毁构造器。

收起
自动换行
深色代码主题
复制
  1. OH_AudioStreamBuilder_Destroy(builder);
AudioCapture.cpp

开发者可以通过以下几个步骤来实现一个简单的录制功能。

实现音频录制

  1. 创建构造器。

    收起
    自动换行
    深色代码主题
    复制
    1. OH_AudioStreamBuilder* builder;
    2. OH_AudioStreamBuilder_Create(&builder, AUDIOSTREAM_TYPE_CAPTURER);
    AudioCapture.cpp

  2. 配置音频流参数。

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

    收起
    自动换行
    深色代码主题
    复制
    1. // 设置音频采样率。
    2. const int SAMPLING_RATE_48K = 48000;
    3. OH_AudioStreamBuilder_SetSamplingRate(builder, SAMPLING_RATE_48K);
    4. // 设置音频声道。
    5. const int channelCount = 2;
    6. OH_AudioStreamBuilder_SetChannelCount(builder, channelCount);
    7. // 设置音频采样格式。
    8. OH_AudioStreamBuilder_SetSampleFormat(builder, AUDIOSTREAM_SAMPLE_S16LE);
    9. // 设置音频流的编码类型。
    10. OH_AudioStreamBuilder_SetEncodingType(builder, AUDIOSTREAM_ENCODING_TYPE_RAW);
    11. // 设置输入音频流的工作场景。
    12. OH_AudioStreamBuilder_SetCapturerInfo(builder, AUDIOSTREAM_SOURCE_TYPE_MIC);
    AudioCapture.cpp

    注意，音频录制的音频数据需要通过回调接口读入，开发者要实现回调接口，从API version 12开始支持使用OH_AudioStreamBuilder_SetCapturerReadDataCallback设置回调函数。回调函数的声明请查看OH_AudioCapturer_OnReadDataCallback。

  3. 设置音频回调函数。

    多音频并发处理可参考文档处理音频焦点事件，仅接口语言差异。

    收起
    自动换行
    深色代码主题
    复制
    1. void MyOnReadData_NewAPI(
    2.     OH_AudioCapturer* capturer,
    3.     void* userData,
    4.     void* audioData,
    5.     int32_t audioDataSize)
    6. {
    7.     // 从buffer中取出length长度的录音数据。
    8. }
    9. 

    10. void MyOnInterruptEvent_NewAPI(
    11.     OH_AudioCapturer* capturer,
    12.     void* userData,
    13.     OH_AudioInterrupt_ForceType type,
    14.     OH_AudioInterrupt_Hint hint)
    15. {
    16.     // 根据type和hint表示的音频中断信息，更新录制器状态和界面。
    17. }
    18. 

    19. void MyOnError_NewAPI(
    20.     OH_AudioCapturer* capturer,
    21.     void* userData,
    22.     OH_AudioStream_Result error)
    23. {
    24.     // 根据error表示的音频异常信息，做出相应的处理。
    25. }
    26. // ...
    27.     // 配置音频中断事件回调函数。
    28.     OH_AudioCapturer_OnInterruptCallback OnInterruptCb = MyOnInterruptEvent_NewAPI;
    29.     OH_AudioStreamBuilder_SetCapturerInterruptCallback(builder, OnInterruptCb, nullptr);
    30. 

    31.     // 配置音频异常回调函数。
    32.     OH_AudioCapturer_OnErrorCallback OnErrorCb = MyOnError_NewAPI;
    33.     OH_AudioStreamBuilder_SetCapturerErrorCallback(builder, OnErrorCb, nullptr);
    34. 

    35.     // 配置音频输入流的回调。
    36.     OH_AudioCapturer_OnReadDataCallback OnReadDataCb = MyOnReadData_NewAPI;
    37.     OH_AudioStreamBuilder_SetCapturerReadDataCallback(builder, OnReadDataCb, nullptr);
    AudioCapture.cpp

  4. 构造录制音频流。

    收起
    自动换行
    深色代码主题
    复制
    1. OH_AudioCapturer* audioCapturer;
    2. OH_AudioStreamBuilder_GenerateCapturer(builder, &audioCapturer);
    AudioCapture.cpp

  5. 使用音频流。

    录制音频流中包含以下接口，用来实现对音频流的控制。

    展开
    接口 说明
    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），应避免在主线程中直接调用，以免造成界面显示卡顿。

  6. 释放构造器。

    构造器不再使用时，需要释放相关资源。

    收起
    自动换行
    深色代码主题
    复制
    1. OH_AudioStreamBuilder_Destroy(builder);
    AudioCapture.cpp

设置低时延模式

当设备支持低时延通路时，开发者可以使用低时延模式创建音频录制构造器，获得更低时延的音频体验。

开发流程与普通录制（实现音频录制）场景一致，仅需要在步骤1创建音频录制构造器时，调用OH_AudioStreamBuilder_SetLatencyMode()设置低时延模式。

注意
  • 当音频录制场景OH_AudioStream_SourceType为AUDIOSTREAM_SOURCE_TYPE_VOICE_COMMUNICATION时，不支持主动设置低时延模式，系统会根据设备的能力，决策输入的音频通路。
  • 部分场景（如通话来电）下系统能力受限会回落至普通音频通路模式，缓冲区大小也会发生变化，此时应同普通音频通路模式一样根据缓冲区大小将缓冲区中数据一次性全部取走，否则录制的数据会出现不连续，导致杂音。
收起
自动换行
深色代码主题
复制
  1. OH_AudioStream_LatencyMode latencyMode = AUDIOSTREAM_LATENCY_MODE_FAST;
  2. OH_AudioStreamBuilder_SetLatencyMode(builder, latencyMode);
AudioCapture.cpp

设置静音打断模式

静音打断模式提供将打断策略从停止录音切换为静音录制的功能，可以实现录音全程不被系统基于焦点并发规则打断的效果，并且录音过程中也不影响其他应用启动录音。开发者在创建音频录制构造器时，调用OH_AudioStreamBuilder_SetCapturerWillMuteWhenInterrupted接口设置是否开启静音打断模式。默认不开启，此时由音频焦点策略管理并发音频流的执行顺序。开启后，被其他应用打断导致停止或暂停录制时会进入静音录制状态，在此状态下录制的音频没有声音。

回声消除功能

回声消除功能可在支持的设备上有效消除录音过程中的回声干扰，提升音频采集质量。开发者可通过指定特定的音频输入源类型OH_AudioStream_SourceType（AUDIOSTREAM_SOURCE_TYPE_VOICE_COMMUNICATION、AUDIOSTREAM_SOURCE_TYPE_LIVE）来启用该功能，系统将会自动对采集的音频信号进行回声消除处理。

在启用前，建议先调用OH_AudioStreamManager_IsAcousticEchoCancelerSupported接口（从API version 20开始支持）查询当前设备对音频输入源类型OH_AudioStream_SourceType是否支持回声消除功能，以确保功能的可用性。若支持，则可在创建音频录制构造器时通过OH_AudioStreamBuilder_SetCapturerInfo 设置相应的音频输入源类型，从而激活回声消除处理流程。

注意事项

从API version 12开始不再推荐使用OH_AudioCapturer_Callbacks的方式设置音频回调函数。若必须使用，需要注意在设置音频回调函数时，通过下面两种方式中的任意一种来设置音频回调函数，避免不可预期的行为。

  • 方式1：请确保OH_AudioCapturer_Callbacks的每一个回调都被自定义的回调方法或空指针初始化。

    收起
    自动换行
    深色代码主题
    复制
    1. int32_t MyOnReadData_Legacy(
    2.     OH_AudioCapturer* capturer,
    3.     void* userData,
    4.     void* buffer,
    5.     int32_t length)
    6. {
    7.     // 从buffer中取出length长度的录音数据。
    8.     return 0;
    9. }
    10. int32_t MyOnInterruptEvent_Legacy(
    11.     OH_AudioCapturer* capturer,
    12.     void* userData,
    13.     OH_AudioInterrupt_ForceType type,
    14.     OH_AudioInterrupt_Hint hint)
    15. {
    16.     // 根据type和hint表示的音频中断信息，更新录制器状态和界面。
    17.     return 0;
    18. }
    19. // ...
    20.     // 配置回调函数，如果需要监听，则赋值。
    21.     callbacks.OH_AudioCapturer_OnReadData = MyOnReadData_Legacy;
    22.     callbacks.OH_AudioCapturer_OnInterruptEvent = MyOnInterruptEvent_Legacy;
    23.     
    24.     // （必选）如果不需要监听，使用空指针初始化。
    25.     callbacks.OH_AudioCapturer_OnStreamEvent = nullptr;
    26.     callbacks.OH_AudioCapturer_OnError = nullptr;
    AudioCapture.cpp

  • 方式2：使用前，初始化并清零结构体。

    收起
    自动换行
    深色代码主题
    复制
    1. int32_t MyOnReadData_Legacy(
    2.     OH_AudioCapturer* capturer,
    3.     void* userData,
    4.     void* buffer,
    5.     int32_t length)
    6. {
    7.     // 从buffer中取出length长度的录音数据。
    8.     return 0;
    9. }
    10. int32_t MyOnInterruptEvent_Legacy(
    11.     OH_AudioCapturer* capturer,
    12.     void* userData,
    13.     OH_AudioInterrupt_ForceType type,
    14.     OH_AudioInterrupt_Hint hint)
    15. {
    16.     // 根据type和hint表示的音频中断信息，更新录制器状态和界面。
    17.     return 0;
    18. }
    19. // ...
    20.     // 使用前，初始化并清零结构体。
    21.     OH_AudioCapturer_Callbacks callbacks = {0};
    22.     // 配置需要的回调函数。
    23.     callbacks.OH_AudioCapturer_OnReadData = MyOnReadData_Legacy;
    24.     callbacks.OH_AudioCapturer_OnInterruptEvent = MyOnInterruptEvent_Legacy;
    AudioCapture.cpp

示例代码

音频录制开发概述
使用AudioCapturer开发音频录制功能(ArkTS)
相关推荐
文档推荐使用OHAudio开发音频播放功能(C/C++)
文档基于OHAudio录制PCM音频（C++）
文档低时延音频录制(C/C++)
文档Audio Vivid播放
文档低时延音频播放(C/C++)
文档音频录制开发概述
文档使用AVRecorder录制音频(C/C++)
文档OH_AudioCapturer_Callbacks_Struct
文档基于AVScreenCapture录制音频
示例代码基于AudioCapturer录制音频(C++)
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词