harmony 鸿蒙使用OHAudio开发音频录制功能

  • 2023-10-30
  • 浏览 (730)

使用OHAudio开发音频录制功能

OHAudio是OpenHarmony在API version 10中引入的一套全新Naitve API,此API在设计上实现归一,同时支持普通音频通路和低时延通路。

使用入门

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

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

音频流构造器

OHAudio提供OH_AudioStreamBuilder接口,遵循构造器设计模式,用于构建音频流。开发者需要根据业务场景,指定对应的OH_AudioStream_Type

OH_AudioStream_Type包含两种类型:

  • AUDIOSTREAM_TYPE_RENDERER
  • AUDIOSTREAM_TYPE_CAPTURER

使用OH_AudioStreamBuilder_Create创建构造器示例:

OH_AudioStreamBuilder* builder;
OH_AudioStreamBuilder_Create(&builder, streamType);

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

OH_AudioStreamBuilder_Destroy(builder);

开发步骤及注意事项

详细的API说明请参考OHAudio API参考

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

  1. 创建构造器

    OH_AudioStreamBuilder* builder;
    OH_AudioStreamBuilder_Create(&builder, AUDIOSTREAM_TYPE_CAPTURER);
    
  2. 配置音频流参数

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

    OH_AudioStreamBuilder_SetSamplingRate(builder, rate);
    OH_AudioStreamBuilder_SetChannelCount(builder, channelCount);
    OH_AudioStreamBuilder_SetSampleFormat(builder, format);
    OH_AudioStreamBuilder_SetEncodingType(builder, encodingType);
    OH_AudioStreamBuilder_SetCapturerInfo(builder, sourceType);
    

    同样,音频录制的音频数据要通过回调接口写入,开发者要实现回调接口,使用OH_AudioStreamBuilder_SetCapturerCallback设置回调函数。回调函数的声明请查看OH_AudioCapturer_Callbacks

  3. 设置音频回调函数

    OH_AudioStreamBuilder_SetCapturerCallback(builder, callbacks, nullptr);
    
  4. 构造录制音频流

    OH_AudioCapturer* audioCapturer;
    OH_AudioStreamBuilder_GenerateCapturer(builder, &audioCapturer);
    
  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)|释放录制实例|

  1. 释放构造器

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

    OH_AudioStreamBuilder_Destroy(builder);
    

你可能感兴趣的鸿蒙文章

harmony 鸿蒙媒体

harmony 鸿蒙开发音频通话功能

harmony 鸿蒙音频通话开发概述

harmony 鸿蒙音频解码

harmony 鸿蒙音效管理

harmony 鸿蒙音频编码

harmony 鸿蒙音频输入设备管理

harmony 鸿蒙音频输出设备管理

harmony 鸿蒙多音频播放的并发策略

harmony 鸿蒙音频播放开发概述

1  赞