@siteed/expo-audio-studio 2.4.0 → 2.4.1

package/CHANGELOG.md

@@ -8,6 +8,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 
+## [2.4.1] - 2025-04-08
+### Changed
+- feat(audio-stream): enhance background audio handling and permission checks (#200) ([60befbe](https://github.com/deeeed/expo-audio-stream/commit/60befbedc9d3cbcc1fc684254d812381e5905e43))
 ## [2.4.0] - 2025-04-03
 ### Changed
 - fix(audio-stream): resolve iOS sample rate mismatch and enhance recording stability (#198) ([05bfc61](https://github.com/deeeed/expo-audio-stream/commit/05bfc6159e7f71fb1d70c3de24fa487cdfb73a62))
@@ -189,7 +192,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Feature: Audio features extraction during recording.
 - Feature: Consistent WAV PCM recording format across all platforms.
 
-[unreleased]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.4.0...HEAD
+[unreleased]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.4.1...HEAD
+[2.4.1]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.4.0...@siteed/expo-audio-studio@2.4.1
 [2.4.0]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.3.1...@siteed/expo-audio-studio@2.4.0
 [2.3.1]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.3.0...@siteed/expo-audio-studio@2.3.1
 [2.3.0]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.2.0...@siteed/expo-audio-studio@2.3.0

package/android/src/main/java/net/siteed/audiostream/AudioRecorderManager.kt

@@ -38,7 +38,8 @@ class AudioRecorderManager(
     private val permissionUtils: PermissionUtils,
     private val audioDataEncoder: AudioDataEncoder,
     private val eventSender: EventSender,
-    private val enablePhoneStateHandling: Boolean = true
+    private val enablePhoneStateHandling: Boolean = true,
+    private val enableBackgroundAudio: Boolean = true
 ) {
     private var audioRecord: AudioRecord? = null
     private var bufferSizeInBytes = 0
@@ -232,12 +233,13 @@ class AudioRecorderManager(
             permissionUtils: PermissionUtils,
             audioDataEncoder: AudioDataEncoder,
             eventSender: EventSender,
-            enablePhoneStateHandling: Boolean = true
+            enablePhoneStateHandling: Boolean = true,
+            enableBackgroundAudio: Boolean = true
         ): AudioRecorderManager {
             return instance ?: synchronized(this) {
                 instance ?: AudioRecorderManager(
                     context, filesDir, permissionUtils, audioDataEncoder, eventSender,
-                    enablePhoneStateHandling
+                    enablePhoneStateHandling, enableBackgroundAudio
                 ).also { instance = it }
             }
         }
@@ -441,7 +443,7 @@ class AudioRecorderManager(
     }
 
     private fun isAudioFormatSupported(sampleRate: Int, channels: Int, format: Int): Boolean {
-        if (!permissionUtils.checkRecordingPermission()) {
+        if (!permissionUtils.checkRecordingPermission(enableBackgroundAudio)) {
             throw SecurityException("Recording permission has not been granted")
         }
 
@@ -477,7 +479,7 @@ class AudioRecorderManager(
     }
 
     private fun checkPermissions(options: Map<String, Any?>, promise: Promise): Boolean {
-        if (!permissionUtils.checkRecordingPermission()) {
+        if (!permissionUtils.checkRecordingPermission(enableBackgroundAudio)) {
             promise.reject(
                 "PERMISSION_DENIED",
                 "Recording permission has not been granted",
@@ -595,7 +597,7 @@ class AudioRecorderManager(
 
 
     private fun initializeAudioRecord(promise: Promise): Boolean {
-        if (!permissionUtils.checkRecordingPermission()) {
+        if (!permissionUtils.checkRecordingPermission(enableBackgroundAudio)) {
             promise.reject(
                 "PERMISSION_DENIED",
                 "Recording permission has not been granted",

package/android/src/main/java/net/siteed/audiostream/ExpoAudioStreamModule.kt

@@ -19,6 +19,7 @@ class ExpoAudioStreamModule : Module(), EventSender {
     private lateinit var audioProcessor: AudioProcessor
     private var enablePhoneStateHandling: Boolean = false // Default to false until we check manifest
     private var enableNotificationHandling: Boolean = false // Default to false until we check manifest
+    private var enableBackgroundAudio: Boolean = false // Default to false until we check manifest
 
     private val audioFileHandler by lazy { 
         AudioFileHandler(appContext.reactContext?.filesDir ?: throw IllegalStateException("React context not available")) 
@@ -50,12 +51,17 @@ class ExpoAudioStreamModule : Module(), EventSender {
             // Check if POST_NOTIFICATIONS is in the requested permissions
             enableNotificationHandling = packageInfo.requestedPermissions?.contains(Manifest.permission.POST_NOTIFICATIONS) ?: false
             
+            // Check if background audio is enabled by looking for FOREGROUND_SERVICE permission
+            enableBackgroundAudio = packageInfo.requestedPermissions?.contains(Manifest.permission.FOREGROUND_SERVICE) ?: false
+            
             Log.d(Constants.TAG, "Phone state handling ${if (enablePhoneStateHandling) "enabled" else "disabled"} based on manifest permissions")
             Log.d(Constants.TAG, "Notification handling ${if (enableNotificationHandling) "enabled" else "disabled"} based on manifest permissions")
+            Log.d(Constants.TAG, "Background audio handling ${if (enableBackgroundAudio) "enabled" else "disabled"} based on manifest permissions")
         } catch (e: Exception) {
             Log.e(Constants.TAG, "Failed to check manifest permissions: ${e.message}", e)
             enablePhoneStateHandling = false
             enableNotificationHandling = false
+            enableBackgroundAudio = false
         }
 
         Events(
@@ -68,6 +74,11 @@ class ExpoAudioStreamModule : Module(), EventSender {
         // Initialize AudioRecorderManager
         initializeManager()
 
+        // Add a convenience function to check for foreground service permission separately
+        fun isForegroundServiceMicRequired(): Boolean {
+            return Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE && enableBackgroundAudio
+        }
+
         AsyncFunction("startRecording") { options: Map<String, Any?>, promise: Promise ->
             // If notifications are requested but permission not in manifest, modify options
             if (options["showNotification"] as? Boolean == true && !enableNotificationHandling) {
@@ -215,8 +226,8 @@ class ExpoAudioStreamModule : Module(), EventSender {
                     permissions.add(Manifest.permission.READ_PHONE_STATE)
                 }
 
-                // Add foreground service permission for Android 14+
-                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+                // Add foreground service permission for Android 14+ only if background audio is enabled
+                if (isForegroundServiceMicRequired()) {
                     Log.d(Constants.TAG, "Adding FOREGROUND_SERVICE_MICROPHONE permission request")
                     permissions.add(Manifest.permission.FOREGROUND_SERVICE_MICROPHONE)
                 }
@@ -243,7 +254,8 @@ class ExpoAudioStreamModule : Module(), EventSender {
                 permissions.add(Manifest.permission.READ_PHONE_STATE)
             }
 
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+            // Only check foreground service permission when background audio is enabled
+            if (isForegroundServiceMicRequired()) {
                 permissions.add(Manifest.permission.FOREGROUND_SERVICE_MICROPHONE)
             }
 
@@ -768,7 +780,8 @@ class ExpoAudioStreamModule : Module(), EventSender {
             permissionUtils,
             audioDataEncoder,
             this,
-            enablePhoneStateHandling
+            enablePhoneStateHandling,
+            enableBackgroundAudio
         )
         audioProcessor = AudioProcessor(filesDir)
     }

package/android/src/main/java/net/siteed/audiostream/PermissionUtils.kt

@@ -8,7 +8,7 @@ import android.Manifest
 import android.util.Log
 
 class PermissionUtils(private val context: Context) {
-    fun checkRecordingPermission(): Boolean {
+    fun checkRecordingPermission(enableBackgroundAudio: Boolean = true): Boolean {
         val hasRecordPermission = ContextCompat.checkSelfPermission(
             context,
             Manifest.permission.RECORD_AUDIO
@@ -16,16 +16,20 @@ class PermissionUtils(private val context: Context) {
 
         Log.d(Constants.TAG, "RECORD_AUDIO permission: $hasRecordPermission")
 
-        // Check for foreground service permission on Android 14+
-        val hasForegroundService = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+        // Check for foreground service permission on Android 14+ only if background audio is enabled
+        val hasForegroundService = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE && enableBackgroundAudio) {
             val result = ContextCompat.checkSelfPermission(
                 context,
                 Manifest.permission.FOREGROUND_SERVICE_MICROPHONE
             ) == PackageManager.PERMISSION_GRANTED
-            Log.d(Constants.TAG, "FOREGROUND_SERVICE_MICROPHONE permission: $result (Android 14+)")
+            Log.d(Constants.TAG, "FOREGROUND_SERVICE_MICROPHONE permission: $result (Android 14+, background audio enabled)")
             result
         } else {
-            Log.d(Constants.TAG, "FOREGROUND_SERVICE_MICROPHONE not required (Android < 14)")
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+                Log.d(Constants.TAG, "FOREGROUND_SERVICE_MICROPHONE not required (background audio disabled)")
+            } else {
+                Log.d(Constants.TAG, "FOREGROUND_SERVICE_MICROPHONE not required (Android < 14)")
+            }
             true
         }
 
@@ -34,6 +38,11 @@ class PermissionUtils(private val context: Context) {
         return result
     }
 
+    // Overload the original method for backward compatibility
+    fun checkRecordingPermission(): Boolean {
+        return checkRecordingPermission(true)
+    }
+
     fun checkNotificationPermission(): Boolean {
         val result = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
             val hasPermission = ContextCompat.checkSelfPermission(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siteed/expo-audio-studio",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Comprehensive audio processing library for React Native and Expo with recording, analysis, visualization, and streaming capabilities across iOS, Android, and web",
   "license": "MIT",
   "main": "build/index.js",