feat(android): Add audio source config.

Author: llfbandit

record_android/android/src/main/kotlin/com/llfbandit/record/methodcall/MethodCallHandlerImpl.kt

@@ -2,10 +2,11 @@ package com.llfbandit.record.methodcall
 
 import android.app.Activity
 import android.content.Context
+import android.media.MediaRecorder
+import android.os.Build
 import com.llfbandit.record.Utils
 import com.llfbandit.record.permission.PermissionManager
 import com.llfbandit.record.record.RecordConfig
-import com.llfbandit.record.record.bluetooth.BluetoothReceiver
 import com.llfbandit.record.record.device.DeviceUtils
 import com.llfbandit.record.record.format.AudioFormats
 import io.flutter.plugin.common.BinaryMessenger
@@ -127,6 +128,30 @@ class MethodCallHandlerImpl(
     private fun getRecordConfig(call: MethodCall): RecordConfig {
         val androidConfig = call.argument("androidConfig") as Map<*, *>?
 
+        val audioSource: Int = when(androidConfig?.get("audioSource")) {
+            "defaultSource" -> MediaRecorder.AudioSource.DEFAULT
+            "mic" -> MediaRecorder.AudioSource.MIC
+            "voiceUplink" -> MediaRecorder.AudioSource.VOICE_UPLINK
+            "voiceDownlink" -> MediaRecorder.AudioSource.VOICE_DOWNLINK
+            "voiceCall" -> MediaRecorder.AudioSource.VOICE_CALL
+            "camcorder" -> MediaRecorder.AudioSource.CAMCORDER
+            "voiceRecognition" -> MediaRecorder.AudioSource.VOICE_RECOGNITION
+            "voiceCommunication" -> MediaRecorder.AudioSource.VOICE_COMMUNICATION
+            "remoteSubMix" -> MediaRecorder.AudioSource.REMOTE_SUBMIX
+            "unprocessed" -> if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+                MediaRecorder.AudioSource.UNPROCESSED
+            } else {
+                MediaRecorder.AudioSource.DEFAULT
+            }
+            "voicePerformance" -> if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+                MediaRecorder.AudioSource.VOICE_PERFORMANCE
+            } else {
+                MediaRecorder.AudioSource.DEFAULT
+            }
+
+            else -> MediaRecorder.AudioSource.DEFAULT
+        }
+
         return RecordConfig(
             call.argument("path"),
             Utils.firstNonNull(call.argument("encoder"), "aacLc"),
@@ -139,7 +164,8 @@ class MethodCallHandlerImpl(
             Utils.firstNonNull(call.argument("noiseSuppress"), false),
             Utils.firstNonNull(androidConfig?.get("useLegacy") as Boolean?, false),
             Utils.firstNonNull(androidConfig?.get("muteAudio") as Boolean?, false),
-            Utils.firstNonNull(androidConfig?.get("manageBluetoothAudio") as Boolean?, true),
+            Utils.firstNonNull(androidConfig?.get("manageBluetooth") as Boolean?, true),
+            audioSource
         )
     }
 }

record_android/android/src/main/kotlin/com/llfbandit/record/methodcall/RecorderWrapper.kt

@@ -148,7 +148,7 @@ internal class RecorderWrapper(
     }
 
     private fun createRecorder(config: RecordConfig): IRecorder {
-        if (config.manageBluetoothAudio) {
+        if (config.manageBluetooth) {
             maybeStartBluetooth(config)
         }
 

record_android/android/src/main/kotlin/com/llfbandit/record/record/PCMReader.kt

@@ -90,7 +90,7 @@ class PCMReader(
 
         val reader = try {
             AudioRecord(
-                MediaRecorder.AudioSource.VOICE_COMMUNICATION,
+                config.audioSource,
                 sampleRate,
                 channels,
                 audioFormat,

record_android/android/src/main/kotlin/com/llfbandit/record/record/RecordConfig.kt

@@ -1,6 +1,7 @@
 package com.llfbandit.record.record
 
 import android.media.AudioDeviceInfo
+import android.media.MediaRecorder
 
 class RecordConfig(
     val path: String?,
@@ -14,7 +15,8 @@ class RecordConfig(
     val noiseSuppress: Boolean = false,
     val useLegacy: Boolean = false,
     val muteAudio: Boolean = false,
-    val manageBluetoothAudio: Boolean = true,
+    val manageBluetooth: Boolean = true,
+    val audioSource: Int = MediaRecorder.AudioSource.DEFAULT
 ) {
     val numChannels: Int = 2.coerceAtMost(1.coerceAtLeast(numChannels))
 }

record_android/android/src/main/kotlin/com/llfbandit/record/record/recorder/MediaRecorder.kt

@@ -46,7 +46,7 @@ class MediaRecorder(
             MediaRecorder(context)
         }
 
-        recorder.setAudioSource(MediaRecorder.AudioSource.DEFAULT)
+        recorder.setAudioSource(config.audioSource)
         recorder.setAudioEncodingBitRate(config.bitRate)
         recorder.setAudioSamplingRate(config.sampleRate)
         recorder.setAudioChannels(2.coerceAtMost(1.coerceAtLeast(config.numChannels)))
@@ -184,8 +184,8 @@ class MediaRecorder(
     private fun updateState(state: RecordState) {
         when (state) {
             RecordState.PAUSE -> {
-                mIsRecording =true
-                mIsPaused =true
+                mIsRecording = true
+                mIsPaused = true
                 recorderStateStreamHandler.sendStateEvent(RecordState.PAUSE.id)
             }
 

record_platform_interface/lib/src/types/android_record_config.dart

@@ -0,0 +1,62 @@
+/// Android specific configuration for recording.
+class AndroidRecordConfig {
+  /// Uses Android MediaRecorder if [true].
+  ///
+  /// Uses advanced recorder with media codecs and additionnal features
+  /// by default.
+  final bool useLegacy;
+
+  /// If [true], this will mute all audio streams like alarms, music, ring, ...
+  ///
+  /// This is useful when you want to record audio without any background noise.
+  ///
+  /// The streams are restored to their previous state after recording is stopped
+  /// and will stay at current state on pause/resume.
+  ///
+  /// Use at your own risks!
+  final bool muteAudio;
+
+  /// Try to start a bluetooth audio connection to a headset (Bluetooth SCO).
+  /// Defaults to [true].
+  final bool manageBluetooth;
+
+  /// Defines the audio source.
+  /// An audio source defines both a default physical source of audio signal, and a recording configuration.
+  ///
+  /// Depending of the constructor some effects are available or not depending of this source.
+  ///
+  /// Most of the time, you should use [AndroidAudioSource.defaultSource] or [AndroidAudioSource.mic].
+  final AndroidAudioSource audioSource;
+
+  const AndroidRecordConfig({
+    this.useLegacy = false,
+    this.muteAudio = false,
+    this.manageBluetooth = true,
+    this.audioSource = AndroidAudioSource.defaultSource,
+  });
+
+  Map<String, dynamic> toMap() {
+    return {
+      'useLegacy': useLegacy,
+      'muteAudio': muteAudio,
+      'manageBluetooth': manageBluetooth,
+      'audioSource': audioSource.name,
+    };
+  }
+}
+
+// Constants for Android for setting specific audio source types
+// https://developer.android.com/reference/kotlin/android/media/MediaRecorder.AudioSource
+enum AndroidAudioSource {
+  defaultSource,
+  mic,
+  voiceUplink,
+  voiceDownlink,
+  voiceCall,
+  camcorder,
+  voiceRecognition,
+  voiceCommunication,
+  remoteSubMix,
+  unprocessed,
+  voicePerformance,
+}

record_platform_interface/lib/src/types/ios_audio_category_option.dart

@@ -0,0 +1,47 @@
+/// iOS specific configuration for recording.
+class IosRecordConfig {
+  /// Constants that specify optional audio behaviors.
+  /// https://developer.apple.com/documentation/avfaudio/avaudiosession/categoryoptions
+  final List<IosAudioCategoryOption> categoryOptions;
+
+  /// Manage the shared AVAudioSession (defaults to `true`).
+  /// Set this to false if another plugin is already managing the AVAudioSession.
+  /// If false, audioCategories config will have no effect.
+  final bool manageAudioSession;
+
+  const IosRecordConfig({
+    this.categoryOptions = const [
+      IosAudioCategoryOption.defaultToSpeaker,
+      IosAudioCategoryOption.allowBluetooth,
+      IosAudioCategoryOption.allowBluetoothA2DP,
+    ],
+    this.manageAudioSession = true,
+  });
+  Map<String, dynamic> toMap() {
+    return {
+      "categoryOptions": categoryOptions.map((e) => e.name).join(','),
+      "manageAudioSession": manageAudioSession,
+    };
+  }
+}
+
+/// Constants that specify optional audio behaviors.
+/// https://developer.apple.com/documentation/avfaudio/avaudiosession/categoryoptions
+enum IosAudioCategoryOption {
+  mixWithOthers,
+  duckOthers,
+  allowBluetooth,
+  defaultToSpeaker,
+
+  /// available from iOS 9.0
+  interruptSpokenAudioAndMixWithOthers,
+
+  /// available from iOS 10.0
+  allowBluetoothA2DP,
+
+  /// available from iOS 10.0
+  allowAirPlay,
+
+  /// available from iOS 14.5
+  overrideMutedMicrophoneInterruption
+}

record_platform_interface/lib/src/types/ios_record_config.dart

@@ -64,7 +64,7 @@ class RecordConfig {
     this.echoCancel = false,
     this.noiseSuppress = false,
     this.androidConfig = const AndroidRecordConfig(),
-    this.iosConfig = const IosRecordConfig(), 
+    this.iosConfig = const IosRecordConfig(),
   });
 
   Map<String, dynamic> toMap() {
@@ -82,67 +82,3 @@ class RecordConfig {
     };
   }
 }
-
-/// Android specific configuration for recording.
-class AndroidRecordConfig {
-  /// Uses Android MediaRecorder if [true].
-  ///
-  /// Uses advanced recorder with media codecs and additionnal features
-  /// by default.
-  final bool useLegacy;
-
-  /// If [true], this will mute all audio streams like alarms, music, ring, ...
-  ///
-  /// This is useful when you want to record audio without any background noise.
-  ///
-  /// The streams are restored to their previous state after recording is stopped
-  /// and will stay at current state on pause/resume.
-  ///
-  /// Use at your own risks!
-  final bool muteAudio;
-
-  /// Try to start a bluetooth audio connection to a headset.
-  /// Defaults to [true].
-  final bool manageBluetoothAudio;
-
-  const AndroidRecordConfig({
-    this.useLegacy = false,
-    this.muteAudio = false,
-    this.manageBluetoothAudio = true,
-  });
-
-  Map<String, dynamic> toMap() {
-    return {
-      'useLegacy': useLegacy,
-      'muteAudio': muteAudio,
-      'manageBluetoothAudio': manageBluetoothAudio,
-    };
-  }
-}
-
-/// iOS specific configuration for recording.
-class IosRecordConfig {
-  /// Constants that specify optional audio behaviors.
-  /// https://developer.apple.com/documentation/avfaudio/avaudiosession/categoryoptions
-  final List<IosAudioCategoryOption> categoryOptions;
-  /// Manage the shared AVAudioSession (defaults to `true`).
-  /// Set this to false if another plugin is already managing the AVAudioSession.
-  /// If false, audioCategories config will have no effect.
-  final bool manageAudioSession;
-
-  const IosRecordConfig({
-    this.categoryOptions = const [
-      IosAudioCategoryOption.defaultToSpeaker,
-      IosAudioCategoryOption.allowBluetooth,
-      IosAudioCategoryOption.allowBluetoothA2DP,
-    ],
-    this.manageAudioSession = true,
-  });
-  Map<String, dynamic> toMap() {
-    return {
-      "categoryOptions": categoryOptions.map((e) => e.name).join(','),
-      "manageAudioSession": manageAudioSession,
-    };
-  }
-  
-}

record_platform_interface/lib/src/types/record_config.dart

@@ -1,6 +1,7 @@
 export 'package:record_platform_interface/src/types/amplitude.dart';
+export 'package:record_platform_interface/src/types/android_record_config.dart';
 export 'package:record_platform_interface/src/types/audio_encoder.dart';
 export 'package:record_platform_interface/src/types/input_device.dart';
-export 'package:record_platform_interface/src/types/ios_audio_category_option.dart';
+export 'package:record_platform_interface/src/types/ios_record_config.dart';
 export 'package:record_platform_interface/src/types/record_config.dart';
 export 'package:record_platform_interface/src/types/record_state.dart';