树叶云鸿蒙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

相关推荐

  • 个人主题怎么制作?

    制作个人主题是一个将个人风格、兴趣或专业领域转化为视觉化或结构化内容的过程,无论是用于个人博客、作品集、社交媒体账号还是品牌形象,核心都是围绕“个人特色”展开,以下从定位、内容规划、视觉设计、技术实现四个维度,详细拆解制作个人主题的完整流程,明确主题定位:找到个人特色的核心主题定位是所有工作的起点,需要先回答……

    2025-11-20
    0
  • 社群营销管理关键是什么?

    社群营销的核心在于通过建立有温度、有价值、有归属感的社群,实现用户留存、转化和品牌传播,其管理需贯穿“目标定位-内容运营-用户互动-数据驱动-风险控制”全流程,以下从五个维度展开详细说明:明确社群定位与目标社群管理的首要任务是精准定位,需明确社群的核心价值(如行业交流、产品使用指导、兴趣分享等)、目标用户画像……

    2025-11-20
    0
  • 香港公司网站备案需要什么材料?

    香港公司进行网站备案是一个涉及多部门协调、流程相对严谨的过程,尤其需兼顾中国内地与香港两地的监管要求,由于香港公司注册地与中国内地不同,其网站若主要服务内地用户或使用内地服务器,需根据服务器位置、网站内容性质等,选择对应的备案路径(如工信部ICP备案或公安备案),以下从备案主体资格、流程步骤、材料准备、注意事项……

    2025-11-20
    0
  • 如何企业上云推广

    企业上云已成为数字化转型的核心战略,但推广过程中需结合行业特性、企业痛点与市场需求,构建系统性、多维度的推广体系,以下从市场定位、策略设计、执行落地及效果优化四个维度,详细拆解企业上云推广的实践路径,精准定位:明确目标企业与核心价值企业上云并非“一刀切”的方案,需先锁定目标客户群体,提炼差异化价值主张,客户分层……

    2025-11-20
    0
  • PS设计搜索框的实用技巧有哪些?

    在PS中设计一个美观且功能性的搜索框需要结合创意构思、视觉设计和用户体验考量,以下从设计思路、制作步骤、细节优化及交互预览等方面详细说明,帮助打造符合需求的搜索框,设计前的规划明确使用场景:根据网站或APP的整体风格确定搜索框的调性,例如极简风适合细线条和纯色,科技感适合渐变和发光效果,电商类则可能需要突出搜索……

    2025-11-20
    0

发表回复

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