鴻蒙OS 音頻采集開發(fā)指導

場景介紹

音頻采集的主要工作是通過輸入設(shè)備將聲音采集并轉(zhuǎn)碼為音頻數(shù)據(jù)，同時對采集任務(wù)進行管理。

接口說明

開發(fā)步驟

1. 構(gòu)造音頻流參數(shù)的數(shù)據(jù)結(jié)構(gòu) AudioStreamInfo，推薦使用 AudioStreamInfo.Builder 類來構(gòu)造，模板如下，模板中設(shè)置的均為 AudioStreamInfo.Builder 類的默認值，根據(jù)音頻流的具體規(guī)格來設(shè)置具體參數(shù)。

   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. （可選）通過采集的采樣率、聲道數(shù)和數(shù)據(jù)格式，調(diào)用 getMinBufferSize 方法獲取采集任務(wù)所需的最小 buffer，參照該 buffer 值設(shè)置步驟3中 AudioCapturerInfo的bufferSizeInBytes。

1. 使用步驟 1 創(chuàng)建的音頻流構(gòu)建音頻播放的參數(shù)結(jié)構(gòu) AudioCapturerInfo，推薦使用 AudioCapturerInfo.Builder類來構(gòu)造，根據(jù)音頻采集的具體規(guī)格來設(shè)置具體參數(shù)。以真實的錄制 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. （可選）設(shè)置采集設(shè)備，如麥克風、耳機等。通過 AudioManager.getDevices(AudioDeviceDescriptor.DeviceFlag.INPUT_DEVICES_FLAG) 獲取到設(shè)備支持的輸入設(shè)備，然后依照 AudioDeviceDescriptor.DeviceType 選擇要選用的輸入設(shè)備類型。

1. 通過構(gòu)造方法獲取 AudioCapturer 類的實例化對象，其中步驟 3 的參數(shù)為必選參數(shù)，通過步驟 4 獲取的指定錄音設(shè)備為可選參數(shù)。

1. （可選）設(shè)置采集音效，如降噪、回聲消除等。使用 addSoundEffect(UUID type, String packageName)進行音效設(shè)置，其中 UUID 參考類 SoundEffect 中提供的靜態(tài)變量。

1. （可選）構(gòu)造音頻采集回調(diào)，首先繼承抽象類 AudioCapturerCallback，并實現(xiàn)抽象方法 onCapturerConfigChanged(List<AudioCapturerConfig> configs)，然后調(diào)用 AudioManager 類的 registerAudioCapturerCallback(AudioCapturerCallback cb )方法進行音頻采集回調(diào)注冊。代碼示例如下：

   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. 調(diào)用 AudioCapturer 實例化對象的 start() 方法啟動采集任務(wù)。

1. 采集的音頻數(shù)據(jù)讀取為 byte 流，循環(huán)調(diào)用 read 方法進行數(shù)據(jù)讀取。

1. 調(diào)用 AudioCapturer 實例化對象的 stop() 方法停止采集。

1. 播放任務(wù)結(jié)束后，調(diào)用 AudioCapturer 實例化對象的release() 釋放資源。