树叶云鸿蒙OS教程:鸿蒙OS 音频采集开发指导

场景介绍

音频采集的主要工作是通过输入设备将声音采集并转码为音频数据,同时对采集任务进行管理。

接口说明

接口名描述
AudioCapturer(AudioCapturerInfo audioCapturerInfo) throws IllegalArgumentException构造函数,设置录音相关音频参数,使用默认录音设备。
AudioCapturer(AudioCapturerInfo audioCapturerInfo, AudioDeviceDescriptor devInfo) throws IllegalArgumentException构造函数,设置录音相关音频参数并指定录音设备。
static int getMinBufferSize(int sampleRate, int channelCount, int audioFormat)获取指定参数条件下所需的最小缓冲区大小。
boolean addSoundEffect(UUID type, String packageName)增加录音的音频音效。
boolean start()开始录音。
int read(byte[] data, int offset, int size)读取音频数据。
int read(byte[] data, int offset, int size, boolean isBlocking)读取音频数据并写入传入的 byte 数组中。
int read(float[] data, int offsetInFloats, int sizeInFloats)阻塞式读取音频数据并写入传入的 float 数组中。
int read(float[] data, int offsetInFloats, int sizeInFloats, boolean isBlocking)读取音频数据并写入传入的 float 数组中。
int read(short[] data, int offsetInShorts, int sizeInShorts)阻塞式读取音频数据并写入传入的 short 数组中。
int read(short[] data, int offsetInShorts, int sizeInShorts, boolean isBlocking)读取音频数据并写入传入的 short 数组中。
int read(java.nio.ByteBuffer buffer, int sizeInBytes)阻塞式读取音频数据并写入传入的 ByteBuffer 对象中。
int read(java.nio.ByteBuffer buffer, int sizeInBytes, boolean isBlocking)读取音频数据并写入传入的 ByteBuffer 对象中。
boolean stop()停止录音。
boolean release()释放录音资源。
AudioDeviceDescriptor getSelectedDevice()获取输入设备信息。
AudioDeviceDescriptor getCurrentDevice()获取当前正在录制音频的设备信息。
int getCapturerSessionId()获取录音的 session ID。
Set<SoundEffect> getSoundEffects()获取已经激活的音频音效列表。
AudioCapturer.State getState()获取音频采集状态。
int getSampleRate()获取采样率。
int getAudioInputSource()获取录音的输入设备信息。
int getBufferFrameCount()获取以帧为单位的缓冲区大小。
int getChannelCount()获取音频采集通道数。
AudioStreamInfo.EncodingFormat getEncodingFormat()获取音频采集的音频编码格式。
boolean getAudioTime(Timestamp timestamp, Timestamp.Timebase timebase)获取一个即时的捕获时间戳。

开发步骤

  1. 构造音频流参数的数据结构 AudioStreamInfo,推荐使用 AudioStreamInfo.Builder 类来构造,模板如下,模板中设置的均为 AudioStreamInfo.Builder 类的默认值,根据音频流的具体规格来设置具体参数。
   AudioStreamInfo audioStreamInfo = new AudioStreamInfo.Builder().sampleRate(
       AudioStreamInfo.SAMPLE_RATE_UNSPECIFIED)
       .audioStreamFlag(AudioStreamInfo.AudioStreamFlag.AUDIO_STREAM_FLAG_NONE)
       .encodingFormat(AudioStreamInfo.EncodingFormat.ENCODING_INVALID)
       .channelMask(AudioStreamInfo.ChannelMask.CHANNEL_INVALID)
       .streamUsage(AudioStreamInfo.StreamUsage.STREAM_USAGE_UNKNOWN)
       .build();

  1. (可选)通过采集的采样率、声道数和数据格式,调用 getMinBufferSize 方法获取采集任务所需的最小 buffer,参照该 buffer 值设置步骤3中 AudioCapturerInfo的bufferSizeInBytes。
  1. 使用步骤 1 创建的音频流构建音频播放的参数结构 AudioCapturerInfo,推荐使用 AudioCapturerInfo.Builder类来构造,根据音频采集的具体规格来设置具体参数。以真实的录制 pcm 流为例:
   AudioStreamInfo audioStreamInfo = new AudioStreamInfo.Builder().encodingFormat(
       AudioStreamInfo.EncodingFormat.ENCODING_PCM_16BIT) // 16-bit PCM
       .channelMask(AudioStreamInfo.ChannelMask.CHANNEL_IN_STEREO) // 双声道
       .sampleRate(44100) // 44.1kHz
       .build();
   AudioCapturerInfo audioCapturerInfo = new AudioCapturerInfo.Builder().audioStreamInfo(audioStreamInfo)
       .build();

  1. (可选)设置采集设备,如麦克风、耳机等。通过 AudioManager.getDevices(AudioDeviceDescriptor.DeviceFlag.INPUT_DEVICES_FLAG) 获取到设备支持的输入设备,然后依照 AudioDeviceDescriptor.DeviceType 选择要选用的输入设备类型。
  1. 通过构造方法获取 AudioCapturer 类的实例化对象,其中步骤 3 的参数为必选参数,通过步骤 4 获取的指定录音设备为可选参数。
  1. (可选)设置采集音效,如降噪、回声消除等。使用 addSoundEffect(UUID type, String packageName)进行音效设置,其中 UUID 参考类 SoundEffect 中提供的静态变量。
  1. (可选)构造音频采集回调,首先继承抽象类 AudioCapturerCallback,并实现抽象方法 onCapturerConfigChanged(List<AudioCapturerConfig> configs),然后调用 AudioManager 类的 registerAudioCapturerCallback(AudioCapturerCallback cb )方法进行音频采集回调注册。代码示例如下:
   private AudioManager audioManager = new AudioManager();

    
   public void main() {
       AudioCapturerCallback cb = new AudioCapturerCallback() {
           @Override
           public void onCapturerConfigChanged(List<AudioCapturerConfig> configs) {
               configs.forEach(config -> doSomething(config));
           }
       };
       audioManager.registerAudioCapturerCallback(cb);
   }

    
   private void doSomething(AudioCapturerConfig config) {
       ...
   }

  1. 调用 AudioCapturer 实例化对象的 start() 方法启动采集任务。
  1. 采集的音频数据读取为 byte 流,循环调用 read 方法进行数据读取。
  1. 调用 AudioCapturer 实例化对象的 stop() 方法停止采集。
  1. 播放任务结束后,调用 AudioCapturer 实例化对象的release() 释放资源。

文章来源网络,作者:管理,如若转载,请注明出处:https://shuyeidc.com/wp/191742.html<

(0)
管理的头像管理
上一篇2025-04-01 06:41
下一篇 2025-04-01 06:42

相关推荐

  • 云服务器和云虚拟主机怎么选?云服务器和虚拟主机区别

    云服务器适合业务增长快、需弹性扩展的场景,而云虚拟主机适合预算有限、技术门槛低的小型静态网站或测试环境,二者核心区别在于资源独享性与运维复杂度,核心差异解析:从底层架构到使用体验很多人容易混淆这两者,觉得它们都是“买空间建站”,它们的底层逻辑完全不同,云服务器(ECS)就像是你租了一整栋别墅,水电网络独立,你想……

    2026-06-29
    0
  • 赣州智慧旅游招聘是真的吗?赣州旅游人才招聘信息

    中级岗位(3-5年经验)月薪范围通常在6000-10000元,这类岗位需要独立负责项目模块,如独立运营一个抖音账号,或维护一个景区小程序的功能迭代,具备成功案例的候选人议价能力较强,高级岗位(5年以上经验)月薪范围通常在10000-20000元,部分核心管理岗可达更高,这类人才需要具备战略规划能力,如制定整个景……

    2026-06-29
    0
  • 赣州智能物联网车位锁如何管理?智能车位锁管理系统多少钱

    赣州智能物联网车位锁管理的核心在于通过云端平台实现远程控锁、状态实时监控及自动计费,彻底解决传统车位“被占难管”与“找位难”的痛点,在赣州这样的城市,随着机动车保有量的持续增长,老旧小区、商业综合体以及私人固定车位的资源矛盾日益凸显,传统的机械地锁或简易遥控锁,不仅操作繁琐,更无法实现数据化管理,引入智能物联网……

    2026-06-29
    0
  • 赣州智能消防栓好用吗,智能消防栓多少钱一个

    赣州智能消防栓通过物联网技术实现实时监测与远程报警,能显著降低火灾响应时间并提升城市消防安全管理水平,是目前智慧城市建设中不可或缺的基础设施,赣州智能消防栓的核心价值与应用场景传统消防栓往往存在“看不见、摸不着、用不了”的痛点,在赣州这样地形复杂、老城区与新城区并存的区域,传统设施的管理难度极大,智能消防栓的出……

    2026-06-29
    0
  • 云服务器和物理机到底有啥区别?

    云服务器本质上是虚拟化资源池中的弹性实例,而传统物理服务器是独占的硬件实体,前者胜在弹性与运维便捷,后者强在物理隔离与性能稳定,具体选择取决于业务对成本、扩展性及安全合规的权衡,很多人初次接触服务器时,容易把“云服务器”和“传统物理服务器”混为一谈,觉得它们都是用来跑网站或存数据的盒子,这两者的底层逻辑完全不同……

    2026-06-29
    0

发表回复

您的邮箱地址不会被公开。必填项已用 * 标注