HarmonyOS 錄音與音頻播放

作者：天生要墻 2021-07-09 09:24:41

系統 OpenHarmony

錄音和音頻播放在app中是一個很常見的功能，本文將介紹在HarmonyOS 如何使用錄音和音頻播放功能。

[[410205]]

想了解更多內容，請訪問：

51CTO和華為官方合作共建的鴻蒙技術社區

https://harmonyos.51cto.com

引言

錄音和音頻播放在app中是一個很常見的功能，本文將介紹在HarmonyOS 如何使用錄音和音頻播放功能。

功能介紹

1.錄音

1.1 使用錄音前需要先申請錄音權限

在 config.json文件中添加權限聲明

"reqPermissions": [     
     { 
       "name": "ohos.permission.MICROPHONE", 
       "reason": "the app need microphone", 
       "usedScene": { 
         "ability": [ 
           "com.iflytek.demo.MainAbility" 
         ], 
         "when": "always" 
       } 
     } 
   ]

然后在MainAbility中動態申請麥克風權限

private void requestPermission() { 
        if (verifySelfPermission("ohos.permission.MICROPHONE") != IBundleManager.PERMISSION_GRANTED) { 
            // 應用未被授予權限 
            if (canRequestPermission("ohos.permission.MICROPHONE")) { 
                // 是否可以申請彈框授權(首次申請或者用戶未選擇禁止且不再提示) 
                requestPermissionsFromUser(new String[]{"ohos.permission.MICROPHONE"}, REQUEST_MICROPHONE); 
            } else { 
                // 顯示應用需要權限的理由，提示用戶進入設置授權 
            } 
        } else { 
            // 權限已被授予 
        } 
    } 
 
    /** 
     * 權限回調 
     */ 
    @Override 
    public void onRequestPermissionsFromUserResult(int requestCode, 
                                                   String[] permissions, 
                                                   int[] grantResults) { 
        switch (requestCode) { 
            case REQUEST_MICROPHONE: { 
                // 匹配requestPermissions的requestCode 
                if (grantResults.length > 0 && grantResults[0] == IBundleManager.PERMISSION_GRANTED) { 
                    // 權限被授予 
                    // 注意：因時間差導致接口權限檢查時有無權限，所以對那些因無權限而拋異常的接口進行異常捕獲處理 
                    AppLog.e("MainAbility", "已經獲取到錄音權限"); 
                } else { 
                    // 權限被拒絕 
                    AppLog.e("MainAbility", "錄音權限被拒絕"); 
                } 
            } 
        } 
    }

1.2 錄音功能使用的是 AudioCapturer類，主要接口如下：

初始化AudioCapturer，先通過 AudioStreamInfo設置錄音音頻基本參數，再通過AudioCapturerInfo設置錄音源等信息。

/** 
    * 創建默認的錄音對象 
    */ 
   public void initConfig() { 
 
       if (audioCapturer != null && audioCapturer.getState() != AudioCapturer.State.STATE_STOPPED) { 
           audioCapturer.release(); 
       } 
       audioCapturer = null; 
       AudioStreamInfo audioStreamInfo = new AudioStreamInfo.Builder() 
               // 音頻采樣率 16000 
               .sampleRate(AUDIO_SAMPLE_RATE) 
               // 錄音數據格式 16-bit PCM 
               .encodingFormat(AudioStreamInfo.EncodingFormat.ENCODING_PCM_16BIT) 
               // 聲道設置 單聲道 
               .channelMask(AudioStreamInfo.ChannelMask.CHANNEL_IN_MONO) 
               .build(); 
       AudioCapturerInfo audioCapturerInfo = new AudioCapturerInfo.Builder() 
               .audioStreamInfo(audioStreamInfo) 
               // 錄音源 
               .audioInputSource(AudioCapturerInfo.AudioInputSource.AUDIO_INPUT_SOURCE_MIC) 
               .build(); 
       audioCapturer = new AudioCapturer(audioCapturerInfo); 
       bufferSizeInBytes = AudioCapturer.getMinBufferSize(AUDIO_SAMPLE_RATE, 1, 2); 
   }

開始錄音，通過 audioCapturer.read() 獲取音頻。

/** 
    * 開始錄音 
    * 
    * @param listener 音頻流的監聽回調 
    */ 
   public void startRecord(final RecordListener listener) { 
       if (audioCapturer.getState() == AudioCapturer.State.STATE_UNINITIALIZED) { 
           throw new IllegalStateException("AudioCapturer need init first"); 
       } 
       if (isRecording()) { 
           throw new IllegalStateException("AudioCapturer is in recording now"); 
       } 
       // 開始錄音 
       audioCapturer.start(); 
       final byte[] audioData = new byte[bufferSizeInBytes]; 
       while (isRecording()) { 
           int size = audioCapturer.read(audioData, 0, bufferSizeInBytes); 
           if (size > 0 && listener != null) { 
               if (size == bufferSizeInBytes) { 
                   // 通過回掉回傳錄音數據 
                   listener.onRead(audioData); 
               } else { 
                   // 通過回掉回傳錄音數據 
                   final byte[] copy = new byte[size]; 
                   System.arraycopy(audioData, 0, copy, 0, size); 
                   listener.onRead(copy); 
               } 
           } 
       } 
       if (finishCallBack != null) { 
           finishCallBack.onFinish(); 
       } 
   }

停止錄音

/** 
    * 停止錄音 
    */ 
   public synchronized void stopRecord() { 
       if (isRecording()) { 
           audioCapturer.stop(); 
       } 
   } 
 
   /** 
    * 釋放資源 
    */ 
   public synchronized void release() { 
       if (audioCapturer != null) { 
           audioCapturer.release(); 
           audioCapturer = null; 
       } 
   }

2. 音頻播放

HarmonyOS 中，播放音頻主要有 AudioRenderer 、Player 、SoundPlayer 3個類

AudioRenderer 用于播放pcm音頻流

Player 主要用于播放mp3、m4a等格式的音頻

SoundPlayer 用于播放短音頻

2.1 AudioRenderer播放pcm音頻

/** 
    * 播放pcm 
    * 
    * @param file pcm文件 
    */ 
   private void playPcm(File file) { 
       if (file == null || !file.exists()) { 
           showToast("文件不存在"); 
           return; 
       } 
       AudioStreamInfo streamInfo = new AudioStreamInfo.Builder() 
               // 16kHz 
               .sampleRate(16000) 
               // 混音 
               .audioStreamFlag(AudioStreamInfo.AudioStreamFlag.AUDIO_STREAM_FLAG_MAY_DUCK) 
               // 16-bit PCM 
               .encodingFormat(AudioStreamInfo.EncodingFormat.ENCODING_PCM_16BIT) 
               // 單聲道輸出 
               .channelMask(AudioStreamInfo.ChannelMask.CHANNEL_OUT_MONO) 
               // 媒體類音頻 
               .streamUsage(AudioStreamInfo.StreamUsage.STREAM_USAGE_MEDIA) 
               .build(); 
 
       AudioRendererInfo audioRendererInfo = new AudioRendererInfo.Builder().audioStreamInfo(streamInfo) 
               // pcm格式的輸出流 
               .audioStreamOutputFlag(AudioRendererInfo.AudioStreamOutputFlag.AUDIO_STREAM_OUTPUT_FLAG_DIRECT_PCM) 
               .bufferSizeInBytes(1280) 
               // false表示分段傳輸buffer并播放，true表示整個音頻流一次性傳輸到HAL層播放 
               .isOffload(false) 
               .build(); 
 
       AudioRenderer renderer = new AudioRenderer(audioRendererInfo, AudioRenderer.PlayMode.MODE_STREAM); 
       renderer.start(); 
       try { 
           FileInputStream inputStream = new FileInputStream(file); 
           byte[] temp = new byte[1280]; 
           while (inputStream.available() > temp.length) { 
               int read = inputStream.read(temp); 
               // 寫入pcm到播放器 
               renderer.write(temp, 0, read); 
           } 
       } catch (Exception e) { 
           e.printStackTrace(); 
       } 
 
   }

2.2 Player 播放mp3

/** 
    * 播放音頻 
    * 
    * @param file 源文件位置 
    */ 
   private void playMp3(File file) { 
       try { 
           player = new Player(getContext()); 
           FileInputStream in = new FileInputStream(file); 
           // 從輸入流獲取FD對象 
           FileDescriptor fd = in.getFD(); 
           player.setSource(new Source(fd)); 
           player.prepare(); 
           player.play(); 
       } catch (Exception e) { 
           e.printStackTrace(); 
       } 
   }