feat: add microphone foreground permission request

Author: cybex-dev

android/src/main/AndroidManifest.xml

@@ -8,6 +8,7 @@
     <uses-permission android:name="android.permission.READ_PHONE_STATE" />
     <uses-permission android:name="android.permission.READ_PHONE_NUMBERS" />
     <uses-permission android:name="android.permission.CALL_PHONE" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE"/>
 
     <application>
         <service

android/src/main/kotlin/com/twilio/twilio_voice/TwilioVoicePlugin.kt

@@ -8,6 +8,7 @@ import android.content.DialogInterface
 import android.content.Intent
 import android.content.IntentFilter
 import android.content.pm.PackageManager
+import android.os.Build
 import android.os.Bundle
 import android.telecom.CallAudioState
 import android.telecom.PhoneAccountHandle
@@ -95,6 +96,7 @@ class TwilioVoicePlugin : FlutterPlugin, MethodCallHandler, EventChannel.StreamH
     private val REQUEST_CODE_CALL_PHONE = 3
     private val REQUEST_CODE_READ_PHONE_NUMBERS = 4
     private val REQUEST_CODE_READ_PHONE_STATE = 5
+    private val REQUEST_CODE_MICROPHONE_FOREGROUND = 6
 
     private var isSpeakerOn: Boolean = false
     private var isBluetoothOn: Boolean = false
@@ -244,6 +246,9 @@ class TwilioVoicePlugin : FlutterPlugin, MethodCallHandler, EventChannel.StreamH
         if (requestCode == REQUEST_CODE_MICROPHONE) {
             if (permissions.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                 Log.d(TAG, "Microphone permission granted")
+                requestPermissionForMicrophoneForeground(onPermissionResult = { granted ->
+                    Log.d(TAG, "onRequestPermissionsResult: Microphone foreground permission granted: $granted");
+                });
                 logEventPermission("Microphone", true)
             } else {
                 Log.d(TAG, "Microphone permission not granted")
@@ -281,6 +286,14 @@ class TwilioVoicePlugin : FlutterPlugin, MethodCallHandler, EventChannel.StreamH
                 Log.d(TAG, "Call Phone permission not granted")
                 logEventPermission("Call Phone State", false)
             }
+        } else if (requestCode == REQUEST_CODE_MICROPHONE_FOREGROUND) {
+            if (permissions.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                Log.d(TAG, "Microphone foreground permission granted")
+                logEventPermission("Microphone", true)
+            } else {
+                Log.d(TAG, "Microphone foreground permission not granted")
+                logEventPermission("Microphone", false)
+            }
         }
         return true
     }
@@ -1435,6 +1448,23 @@ class TwilioVoicePlugin : FlutterPlugin, MethodCallHandler, EventChannel.StreamH
         )
     }
 
+    /// Request permission for microphone on Android 14 and higher.
+    /// Source: https://developer.android.com/reference/android/Manifest.permission#FOREGROUND_SERVICE_MICROPHONE
+    private fun requestPermissionForMicrophoneForeground(onPermissionResult: (Boolean) -> Unit) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+            Log.d(TAG, "requestPermissionForMicrophoneForeground: Microphone foreground permission automatically requested.");
+            return requestPermissionOrShowRationale(
+                "Microphone Foreground",
+                "Microphone Foreground permission is required to make or receive phone calls on Android 14 and higher.",
+                Manifest.permission.FOREGROUND_SERVICE_MICROPHONE,
+                REQUEST_CODE_MICROPHONE_FOREGROUND,
+                onPermissionResult
+            )
+        } else {
+            Log.d(TAG, "requestPermissionForMicrophoneForeground: Microphone foreground permission skipped.");
+        }
+    }
+
     private fun requestPermissionForPhoneState(onPermissionResult: (Boolean) -> Unit) {
         return requestPermissionOrShowRationale(
             "Read Phone State",