@siteed/expo-audio-studio 2.12.3 → 2.13.1

package/CHANGELOG.md

@@ -8,6 +8,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 
+## [2.13.1] - 2025-06-09
+### Changed
+- feat(investigation): resolve Issue #251 - comprehensive sub-100ms audio events analysis (#270) ([4813f1e](https://github.com/deeeed/expo-audio-stream/commit/4813f1ef05f3856b58ec8fde95b7b8909feb513d))
+- fix(deps): update expo-modules-core peer dependency for Expo SDK 53 compatibility ([40b946f](https://github.com/deeeed/expo-audio-stream/commit/40b946f83eecd3fdcedfe7a2cbac62f1207a4ff0))
+- docs: updated docs site ([8a01a97](https://github.com/deeeed/expo-audio-stream/commit/8a01a97ebee927a2dfa0a7cb40b11329410509d2))
+## [2.13.0] - 2025-06-09
+### Changed
+- feat(expo-audio-studio): enhance device detection and management system ([97ceef0](https://github.com/deeeed/expo-audio-stream/commit/97ceef003ddb8eb5246cda8a5a00ddc75bf665a0))
 ## [2.12.3] - 2025-06-07
 ### Changed
 - refactor(expo-audio-studio): adjust audio focus request timing in AudioRecorderManager ([317367c](https://github.com/deeeed/expo-audio-stream/commit/317367cb29fa09016aa73884f2f51e9cfdee1086))
@@ -304,7 +312,9 @@ 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.12.3...HEAD
+[unreleased]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.13.1...HEAD
+[2.13.1]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.13.0...@siteed/expo-audio-studio@2.13.1
+[2.13.0]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.12.3...@siteed/expo-audio-studio@2.13.0
 [2.12.3]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.12.2...@siteed/expo-audio-studio@2.12.3
 [2.12.2]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.12.1...@siteed/expo-audio-studio@2.12.2
 [2.12.1]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.12.0...@siteed/expo-audio-studio@2.12.1

package/android/build.gradle

@@ -32,6 +32,7 @@ buildscript {
 
   repositories {
     mavenCentral()
+    google()
   }
 
   dependencies {
@@ -91,12 +92,22 @@ android {
 
 repositories {
   mavenCentral()
+  google()
 }
 
 dependencies {
   implementation project(':expo-modules-core')
   implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:${getKotlinVersion()}"
 
+  // Add AndroidX dependencies
+  implementation 'androidx.core:core-ktx:1.10.1'
+  implementation 'androidx.annotation:annotation:1.6.0'
+  implementation 'androidx.appcompat:appcompat:1.6.1'
+  
+  // Add Kotlinx Coroutines for main code
+  implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3'
+  implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3'
+
   // Add testing dependencies
   testImplementation 'junit:junit:4.13.2'
   testImplementation 'org.jetbrains.kotlin:kotlin-test:1.8.10'

package/android/src/main/AndroidManifest.xml

@@ -6,6 +6,14 @@
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE"/>
     <uses-permission android:name="android.permission.WAKE_LOCK" />
     <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+    
+    <!-- Bluetooth permissions for device detection -->
+    <uses-permission android:name="android.permission.BLUETOOTH" />
+    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
+    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+    
+    <!-- USB permission for USB device detection -->
+    <uses-permission android:name="android.permission.USB_PERMISSION" />
 
     <application>
         <receiver 

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

@@ -21,6 +21,7 @@ import net.siteed.audiostream.LogUtils
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
+import kotlinx.coroutines.delay
 
 /**
  * Constants not available in all Android versions
@@ -62,6 +63,12 @@ class AudioDeviceManager(private val context: Context) {
     // Delegate for handling device disconnection
     var delegate: AudioDeviceManagerDelegate? = null
     
+    // Simple callback for device connections
+    var onDeviceConnected: ((String) -> Unit)? = null
+    
+    // Simple callback for device disconnections
+    var onDeviceDisconnected: ((String) -> Unit)? = null
+    
     // Audio manager for accessing device information
     private val audioManager: AudioManager = context.getSystemService(Context.AUDIO_SERVICE) as AudioManager
     
@@ -1113,6 +1120,9 @@ class AudioDeviceManager(private val context: Context) {
                     addAction(UsbManager.ACTION_USB_ACCESSORY_ATTACHED)
                     addAction(UsbManager.ACTION_USB_ACCESSORY_DETACHED)
                 }
+                
+                // Bluetooth SCO state changes - to detect when microphone becomes available
+                addAction(AudioManager.ACTION_SCO_AUDIO_STATE_UPDATED)
             }
             
             deviceReceiver = object : BroadcastReceiver() {
@@ -1153,6 +1163,28 @@ class AudioDeviceManager(private val context: Context) {
                                         }
                                     }
                                 }
+                            } else if (state == 1) { // Plugged in
+                                LogUtils.d(CLASS_NAME, "Wired headset connected: $name")
+                                
+                                // For M+ find the actual new device
+                                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+                                    // Find the newly connected wired device
+                                    val audioDevices = audioManager.getDevices(AudioManager.GET_DEVICES_INPUTS)
+                                    val wiredDevice = audioDevices.firstOrNull { 
+                                        (it.type == AudioDeviceInfo.TYPE_WIRED_HEADSET || 
+                                         it.type == AudioDeviceInfo.TYPE_WIRED_HEADPHONES) &&
+                                        getDeviceName(it).contains(name, ignoreCase = true)
+                                    }
+                                    
+                                    if (wiredDevice != null) {
+                                        val connectedDeviceId = wiredDevice.id.toString()
+                                        LogUtils.d(CLASS_NAME, "Found connected wired device: $name (ID: $connectedDeviceId)")
+                                        handleDeviceConnection(connectedDeviceId)
+                                    }
+                                } else {
+                                    // Legacy handling for older Android
+                                    handleDeviceConnection("1")
+                                }
                             }
                         }
                         
@@ -1184,6 +1216,59 @@ class AudioDeviceManager(private val context: Context) {
                             }
                         }
                         
+                        BluetoothDevice.ACTION_ACL_CONNECTED -> {
+                            val device = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                                intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE, BluetoothDevice::class.java)
+                            } else {
+                                @Suppress("DEPRECATION")
+                                intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
+                            }
+                            
+                            if (device != null) {
+                                LogUtils.d(CLASS_NAME, "Bluetooth device connected: ${device.name}")
+                                
+                                // For M+ find the actual new device
+                                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+                                    val actualDevice = findBluetoothDevice(device)
+                                    if (actualDevice != null) {
+                                        val connectedDeviceId = actualDevice.id.toString()
+                                        LogUtils.d(CLASS_NAME, "Found connected Bluetooth device: ${device.name} (ID: $connectedDeviceId)")
+                                        handleDeviceConnection(connectedDeviceId)
+                                    } else {
+                                        LogUtils.d(CLASS_NAME, "Bluetooth device ${device.name} connected but not found in audio device list - attempting to activate SCO")
+                                        
+                                        // Try to activate Bluetooth SCO to make microphone available
+                                        if (!audioManager.isBluetoothScoOn) {
+                                            LogUtils.d(CLASS_NAME, "Starting Bluetooth SCO to activate microphone for ${device.name}")
+                                            audioManager.startBluetoothSco()
+                                            
+                                            // Give SCO time to activate, then check again
+                                            coroutineScope.launch {
+                                                delay(2000) // Wait 2 seconds
+                                                
+                                                val scoDevice = findBluetoothDevice(device)
+                                                if (scoDevice != null) {
+                                                    val activatedDeviceId = scoDevice.id.toString()
+                                                    LogUtils.d(CLASS_NAME, "Bluetooth SCO activated for device: ${device.name} (ID: $activatedDeviceId)")
+                                                    handleDeviceConnection(activatedDeviceId)
+                                                } else {
+                                                    LogUtils.d(CLASS_NAME, "Bluetooth SCO didn't activate microphone for ${device.name}")
+                                                    // Send generic connection event anyway
+                                                    handleDeviceConnection("bluetooth:${device.address}")
+                                                }
+                                            }
+                                        } else {
+                                            // SCO already on, send generic event
+                                            handleDeviceConnection("bluetooth:${device.address}")
+                                        }
+                                    }
+                                } else {
+                                    // Legacy handling for older Android
+                                    handleDeviceConnection("2")
+                                }
+                            }
+                        }
+                        
                         BluetoothDevice.ACTION_ACL_DISCONNECTED -> {
                             val device = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
                                 intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE, BluetoothDevice::class.java)
@@ -1213,42 +1298,117 @@ class AudioDeviceManager(private val context: Context) {
                             val state = intent.getIntExtra(BluetoothAdapter.EXTRA_CONNECTION_STATE, -1)
                             logAudioState()
                             
-                            // Only handle disconnect events and only for HEADSET profile (relevant for audio)
-                            if (state == BluetoothAdapter.STATE_DISCONNECTED) {
-                                val device = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
-                                    intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE, BluetoothDevice::class.java)
-                                } else {
-                                    @Suppress("DEPRECATION")
-                                    intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
-                                }
-                                
-                                if (device != null) {
-                                    deviceId = "2" // Legacy ID for bluetooth
-                                    deviceName = device.name
-                                    deviceType = DEVICE_TYPE_BLUETOOTH
+                            when (state) {
+                                BluetoothAdapter.STATE_CONNECTED -> {
+                                    val device = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                                        intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE, BluetoothDevice::class.java)
+                                    } else {
+                                        @Suppress("DEPRECATION")
+                                        intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
+                                    }
                                     
-                                    // For M+ get the actual ID
-                                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
-                                        val actualDevice = findBluetoothDevice(device)
-                                        if (actualDevice != null) {
-                                            deviceId = actualDevice.id.toString()
+                                    if (device != null) {
+                                        LogUtils.d(CLASS_NAME, "Bluetooth profile connected: ${device.name}")
+                                        
+                                        // For M+ find the actual new device
+                                        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+                                            val actualDevice = findBluetoothDevice(device)
+                                            if (actualDevice != null) {
+                                                val connectedDeviceId = actualDevice.id.toString()
+                                                LogUtils.d(CLASS_NAME, "Found connected Bluetooth profile device: ${device.name} (ID: $connectedDeviceId)")
+                                                handleDeviceConnection(connectedDeviceId)
+                                            } else {
+                                                LogUtils.d(CLASS_NAME, "Bluetooth profile ${device.name} connected but not found in audio device list - attempting to activate SCO")
+                                                
+                                                // Try to activate Bluetooth SCO to make microphone available
+                                                if (!audioManager.isBluetoothScoOn) {
+                                                    LogUtils.d(CLASS_NAME, "Starting Bluetooth SCO to activate microphone for ${device.name}")
+                                                    audioManager.startBluetoothSco()
+                                                    
+                                                    // Give SCO time to activate, then check again
+                                                    coroutineScope.launch {
+                                                        delay(2000) // Wait 2 seconds
+                                                        
+                                                        val scoDevice = findBluetoothDevice(device)
+                                                        if (scoDevice != null) {
+                                                            val activatedDeviceId = scoDevice.id.toString()
+                                                            LogUtils.d(CLASS_NAME, "Bluetooth SCO activated for device: ${device.name} (ID: $activatedDeviceId)")
+                                                            handleDeviceConnection(activatedDeviceId)
+                                                        } else {
+                                                            LogUtils.d(CLASS_NAME, "Bluetooth SCO didn't activate microphone for ${device.name}")
+                                                            // Send generic connection event anyway
+                                                            handleDeviceConnection("bluetooth:${device.address}")
+                                                        }
+                                                    }
+                                                } else {
+                                                    // SCO already on, send generic event
+                                                    handleDeviceConnection("bluetooth:${device.address}")
+                                                }
+                                            }
+                                        } else {
+                                            // Legacy handling for older Android
+                                            handleDeviceConnection("2")
                                         }
                                     }
+                                }
+                                
+                                BluetoothAdapter.STATE_DISCONNECTED -> {
+                                    val device = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                                        intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE, BluetoothDevice::class.java)
+                                    } else {
+                                        @Suppress("DEPRECATION")
+                                        intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
+                                    }
                                     
-                                    LogUtils.d(CLASS_NAME, "Bluetooth profile disconnected: ${device.name}, using ID: $deviceId")
-                                } 
-                                // No device info, check if our last device was bluetooth
-                                else if (lastSelectedDeviceId != null && Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
-                                    val lastDeviceInfo = findDeviceById(lastSelectedDeviceId!!)
-                                    
-                                    if (lastDeviceInfo?.type == AudioDeviceInfo.TYPE_BLUETOOTH_SCO) {
-                                        deviceId = lastSelectedDeviceId
-                                        LogUtils.d(CLASS_NAME, "Bluetooth profile disconnected, using last selected device ID: $deviceId")
+                                    if (device != null) {
+                                        deviceId = "2" // Legacy ID for bluetooth
+                                        deviceName = device.name
+                                        deviceType = DEVICE_TYPE_BLUETOOTH
+                                        
+                                        // For M+ get the actual ID
+                                        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+                                            val actualDevice = findBluetoothDevice(device)
+                                            if (actualDevice != null) {
+                                                deviceId = actualDevice.id.toString()
+                                            }
+                                        }
+                                        
+                                        LogUtils.d(CLASS_NAME, "Bluetooth profile disconnected: ${device.name}, using ID: $deviceId")
+                                    } 
+                                    // No device info, check if our last device was bluetooth
+                                    else if (lastSelectedDeviceId != null && Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+                                        val lastDeviceInfo = findDeviceById(lastSelectedDeviceId!!)
+                                        
+                                        if (lastDeviceInfo?.type == AudioDeviceInfo.TYPE_BLUETOOTH_SCO) {
+                                            deviceId = lastSelectedDeviceId
+                                            LogUtils.d(CLASS_NAME, "Bluetooth profile disconnected, using last selected device ID: $deviceId")
+                                        }
                                     }
                                 }
                             }
                         }
                         
+                        UsbManager.ACTION_USB_DEVICE_ATTACHED, UsbManager.ACTION_USB_ACCESSORY_ATTACHED -> {
+                            LogUtils.d(CLASS_NAME, "USB device attached")
+                            
+                            // For M+ find newly connected USB audio devices
+                            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+                                val audioDevices = audioManager.getDevices(AudioManager.GET_DEVICES_INPUTS)
+                                val usbDevice = audioDevices.firstOrNull { 
+                                    it.type == AudioDeviceInfo.TYPE_USB_DEVICE || 
+                                    it.type == AudioDeviceInfo.TYPE_USB_HEADSET || 
+                                    it.type == AudioDeviceInfo.TYPE_USB_ACCESSORY
+                                }
+                                
+                                if (usbDevice != null) {
+                                    val connectedDeviceId = usbDevice.id.toString()
+                                    val deviceName = getDeviceName(usbDevice)
+                                    LogUtils.d(CLASS_NAME, "Found connected USB audio device: $deviceName (ID: $connectedDeviceId)")
+                                    handleDeviceConnection(connectedDeviceId)
+                                }
+                            }
+                        }
+                        
                         UsbManager.ACTION_USB_DEVICE_DETACHED, UsbManager.ACTION_USB_ACCESSORY_DETACHED -> {
                             LogUtils.d(CLASS_NAME, "USB device detached")
                             
@@ -1266,28 +1426,74 @@ class AudioDeviceManager(private val context: Context) {
                                 }
                             }
                         }
+                        
+                        AudioManager.ACTION_SCO_AUDIO_STATE_UPDATED -> {
+                            val scoState = intent.getIntExtra(AudioManager.EXTRA_SCO_AUDIO_STATE, -1)
+                            LogUtils.d(CLASS_NAME, "Bluetooth SCO state changed: $scoState")
+                            
+                            when (scoState) {
+                                AudioManager.SCO_AUDIO_STATE_CONNECTED -> {
+                                    LogUtils.d(CLASS_NAME, "Bluetooth SCO connected - microphone available")
+                                    
+                                    // Check if any new Bluetooth SCO devices appeared
+                                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+                                        val audioDevices = audioManager.getDevices(AudioManager.GET_DEVICES_INPUTS)
+                                        val bluetoothScoDevices = audioDevices.filter { 
+                                            it.type == AudioDeviceInfo.TYPE_BLUETOOTH_SCO 
+                                        }
+                                        
+                                        if (bluetoothScoDevices.isNotEmpty()) {
+                                            // Found Bluetooth SCO device(s), notify about the first one
+                                            val scoDevice = bluetoothScoDevices.first()
+                                            val scoDeviceId = scoDevice.id.toString()
+                                            val scoDeviceName = getDeviceName(scoDevice)
+                                            LogUtils.d(CLASS_NAME, "Found Bluetooth SCO device: $scoDeviceName (ID: $scoDeviceId)")
+                                            handleDeviceConnection(scoDeviceId)
+                                        }
+                                    }
+                                }
+                                
+                                AudioManager.SCO_AUDIO_STATE_DISCONNECTED -> {
+                                    LogUtils.d(CLASS_NAME, "Bluetooth SCO disconnected - microphone no longer available")
+                                    // Note: Device disconnection will be handled by other broadcasts
+                                }
+                                
+                                AudioManager.SCO_AUDIO_STATE_CONNECTING -> {
+                                    LogUtils.d(CLASS_NAME, "Bluetooth SCO connecting...")
+                                }
+                                
+                                else -> {
+                                    LogUtils.d(CLASS_NAME, "Bluetooth SCO state: $scoState")
+                                }
+                            }
+                        }
                     }
                     
-                    // If this is the currently selected device, notify delegate
-                    if (deviceId != null && deviceId == lastSelectedDeviceId) {
-                        LogUtils.d(CLASS_NAME, "Currently selected device disconnected: $deviceId")
+                    // Handle any device disconnection - send events to React Native for device list updates
+                    if (deviceId != null) {
+                        LogUtils.d(CLASS_NAME, "Device disconnected: $deviceId (selected: ${deviceId == lastSelectedDeviceId})")
+                        if (deviceName != null) {
+                            LogUtils.d(CLASS_NAME, "Device name: $deviceName, type: $deviceType")
+                        }
+                        
                         // Log the disconnection for debugging
                         logDeviceDisconnection(deviceId, action ?: "unknown")
                         
-                        // Launch a coroutine to call the suspend function
-                        coroutineScope.launch {
-                            try {
-                                handleDeviceDisconnection(deviceId)
-                            } catch (e: Exception) {
-                                LogUtils.e(CLASS_NAME, "Error handling device disconnection: ${e.message}", e)
+                        // Send device disconnection event to React Native (for UI updates)
+                        handleDeviceDisconnectionEvent(deviceId)
+                        
+                        // If this was the currently selected device, also notify delegate for recording interruption
+                        if (deviceId == lastSelectedDeviceId) {
+                            LogUtils.d(CLASS_NAME, "Currently selected device disconnected - notifying delegate: $deviceId")
+                            // Launch a coroutine to call the suspend function
+                            coroutineScope.launch {
+                                try {
+                                    handleDeviceDisconnection(deviceId)
+                                } catch (e: Exception) {
+                                    LogUtils.e(CLASS_NAME, "Error handling device disconnection: ${e.message}", e)
+                                }
                             }
                         }
-                    } else if (deviceId != null) {
-                        // Even if not our current device, log for debugging
-                        LogUtils.d(CLASS_NAME, "Device disconnected but not currently selected: $deviceId")
-                        if (deviceName != null) {
-                            LogUtils.d(CLASS_NAME, "Device name: $deviceName, type: $deviceType")
-                        }
                     }
                     
                     // Force refresh the device list
@@ -1498,4 +1704,22 @@ class AudioDeviceManager(private val context: Context) {
         LogUtils.d(CLASS_NAME, "Device disconnected: $deviceId. Pausing recording.")
         delegate?.onDeviceDisconnected(deviceId)
     }
+    
+    /**
+     * Handles audio device connection
+     */
+    private fun handleDeviceConnection(deviceId: String) {
+        LogUtils.d(CLASS_NAME, "Device connected: $deviceId")
+        onDeviceConnected?.invoke(deviceId)
+    }
+    
+    /**
+     * Handles audio device disconnection (for React Native events)
+     */
+    private fun handleDeviceDisconnectionEvent(deviceId: String) {
+        LogUtils.d(CLASS_NAME, "Device disconnected: $deviceId")
+        onDeviceDisconnected?.invoke(deviceId)
+    }
+    
+
 } 

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

@@ -7,6 +7,7 @@ import android.os.Bundle
 import android.util.Log
 import android.content.pm.PackageManager
 import androidx.annotation.RequiresApi
+import androidx.core.content.ContextCompat
 import androidx.core.os.bundleOf
 import expo.modules.kotlin.Promise
 import expo.modules.kotlin.modules.Module
@@ -30,6 +31,7 @@ class ExpoAudioStreamModule : Module(), EventSender {
     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 var enableDeviceDetection: Boolean = false // Default to false until we check manifest
     private val coroutineScope = CoroutineScope(Dispatchers.Main)
 
     private val audioFileHandler by lazy { 
@@ -65,14 +67,19 @@ class ExpoAudioStreamModule : Module(), EventSender {
             // Check if background audio is enabled by looking for FOREGROUND_SERVICE_MICROPHONE permission
             enableBackgroundAudio = packageInfo.requestedPermissions?.contains(Manifest.permission.FOREGROUND_SERVICE_MICROPHONE) ?: false
             
+            // Check if device detection is enabled by looking for BLUETOOTH_CONNECT permission
+            enableDeviceDetection = packageInfo.requestedPermissions?.contains(Manifest.permission.BLUETOOTH_CONNECT) ?: false
+            
             LogUtils.d(CLASS_NAME, "Phone state handling ${if (enablePhoneStateHandling) "enabled" else "disabled"} based on manifest permissions")
             LogUtils.d(CLASS_NAME, "Notification handling ${if (enableNotificationHandling) "enabled" else "disabled"} based on manifest permissions")
             LogUtils.d(CLASS_NAME, "Background audio handling ${if (enableBackgroundAudio) "enabled" else "disabled"} based on manifest permissions")
+            LogUtils.d(CLASS_NAME, "Device detection ${if (enableDeviceDetection) "enabled" else "disabled"} based on manifest permissions")
         } catch (e: Exception) {
             LogUtils.e(CLASS_NAME, "Failed to check manifest permissions: ${e.message}", e)
             enablePhoneStateHandling = false
             enableNotificationHandling = false
             enableBackgroundAudio = false
+            enableDeviceDetection = false
         }
 
         Events(
@@ -91,6 +98,11 @@ class ExpoAudioStreamModule : Module(), EventSender {
             return Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE && enableBackgroundAudio
         }
 
+        // Helper function to check if device detection is enabled
+        fun isDeviceDetectionEnabled(): Boolean {
+            return enableDeviceDetection
+        }
+
         // Add device-related functions to the module
         
         // Gets available audio input devices with an optional refresh parameter
@@ -169,6 +181,8 @@ class ExpoAudioStreamModule : Module(), EventSender {
             return@Function mapOf("success" to success)
         }
 
+
+
         AsyncFunction("prepareRecording") { options: Map<String, Any?>, promise: Promise ->
             try {
                 // If notifications are requested but permission not in manifest, modify options
@@ -263,6 +277,15 @@ class ExpoAudioStreamModule : Module(), EventSender {
                     permissions.add(Manifest.permission.FOREGROUND_SERVICE_MICROPHONE)
                 }
 
+                // Add device detection permissions if device detection is enabled
+                if (isDeviceDetectionEnabled()) {
+                    // BLUETOOTH_CONNECT is needed on Android 12+ to access device names/addresses
+                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+                        permissions.add(Manifest.permission.BLUETOOTH_CONNECT)
+                        LogUtils.d(CLASS_NAME, "Adding BLUETOOTH_CONNECT permission request for device detection")
+                    }
+                }
+
                 LogUtils.d(CLASS_NAME, "Requesting permissions: $permissions")
                 Permissions.askForPermissionsWithPermissionsManager(
                     appContext.permissions,
@@ -290,6 +313,14 @@ class ExpoAudioStreamModule : Module(), EventSender {
                 permissions.add(Manifest.permission.FOREGROUND_SERVICE_MICROPHONE)
             }
 
+            // Add device detection permissions if enabled
+            if (isDeviceDetectionEnabled()) {
+                // BLUETOOTH_CONNECT is needed on Android 12+ to access device names/addresses
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+                    permissions.add(Manifest.permission.BLUETOOTH_CONNECT)
+                }
+            }
+
             Permissions.getPermissionsWithPermissionsManager(
                 appContext.permissions,
                 promise,
@@ -909,7 +940,10 @@ class ExpoAudioStreamModule : Module(), EventSender {
         val audioDataEncoder = AudioDataEncoder()
         
         // Initialize AudioDeviceManager
+        LogUtils.d(CLASS_NAME, "🔧 Initializing AudioDeviceManager...")
+        LogUtils.d(CLASS_NAME, "🔧 Device detection enabled: $enableDeviceDetection")
         audioDeviceManager = AudioDeviceManager(context)
+        LogUtils.d(CLASS_NAME, "🔧 AudioDeviceManager initialized")
         
         // Initialize AudioRecorderManager with AudioDeviceManager integration
         audioRecorderManager = AudioRecorderManager.initialize(
@@ -936,7 +970,7 @@ class ExpoAudioStreamModule : Module(), EventSender {
                         
                         // Notify JS about the disconnection
                         sendEvent(Constants.DEVICE_CHANGED_EVENT, bundleOf(
-                            "reason" to "deviceDisconnected",
+                            "type" to "deviceDisconnected",
                             "deviceId" to deviceId
                         ))
                     } catch (e: Exception) {
@@ -946,6 +980,26 @@ class ExpoAudioStreamModule : Module(), EventSender {
             }
         }
         
+        // Set up connection callback
+        audioDeviceManager.onDeviceConnected = { deviceId ->
+            LogUtils.d(CLASS_NAME, "📱 Device connected: $deviceId")
+            // Notify JS about the connection
+            sendEvent(Constants.DEVICE_CHANGED_EVENT, bundleOf(
+                "type" to "deviceConnected",
+                "deviceId" to deviceId
+            ))
+        }
+        
+        // Set up disconnection callback
+        audioDeviceManager.onDeviceDisconnected = { deviceId ->
+            LogUtils.d(CLASS_NAME, "📱 Device disconnected: $deviceId")
+            // Notify JS about the disconnection
+            sendEvent(Constants.DEVICE_CHANGED_EVENT, bundleOf(
+                "type" to "deviceDisconnected",
+                "deviceId" to deviceId
+            ))
+        }
+        
         audioProcessor = AudioProcessor(filesDir)
     }
     

package/app.plugin.js

@@ -1 +1,3 @@
-module.exports = require('./plugin/build')
+// Plugin for app.json usage (regular Node.js context)
+const plugin = require('./plugin/build/index.js')
+module.exports = plugin.default || plugin

package/build/cjs/AudioAnalysis/AudioAnalysis.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudioAnalysis.types.js","sourceRoot":"","sources":["../../../src/AudioAnalysis/AudioAnalysis.types.ts"],"names":[],"mappings":";AAAA,sEAAsE","sourcesContent":["// packages/expo-audio-stream/src/AudioAnalysis/AudioAnalysis.types.ts\n\nimport { BitDepth, ConsoleLike } from '../ExpoAudioStream.types'\n\n/**\n * Represents the configuration for decoding audio data.\n */\nexport interface DecodingConfig {\n    /** Target sample rate for decoded audio (Android and Web) */\n    targetSampleRate?: number\n    /** Target number of channels (Android and Web) */\n    targetChannels?: number\n    /** Target bit depth (Android and Web) */\n    targetBitDepth?: BitDepth\n    /** Whether to normalize audio levels (Android and Web) */\n    normalizeAudio?: boolean\n}\n\n/**\n * Represents speech-related features extracted from audio.\n */\nexport interface SpeechFeatures {\n    isActive: boolean // Whether speech is detected in this segment\n    speakerId?: number // Optional speaker identification\n    // Could add more speech-related features here like:\n    // confidence: number\n    // language?: string\n    // sentiment?: number\n    // etc.\n}\n\n/**\n * Represents various audio features extracted from an audio signal.\n */\nexport interface AudioFeatures {\n    energy?: number // The infinite integral of the squared signal, representing the overall energy of the audio.\n    mfcc?: number[] // Mel-frequency cepstral coefficients, describing the short-term power spectrum of a sound.\n    rms?: number // Root mean square value, indicating the amplitude of the audio signal.\n    minAmplitude?: number // Minimum amplitude value in the audio signal.\n    maxAmplitude?: number // Maximum amplitude value in the audio signal.\n    zcr?: number // Zero-crossing rate, indicating the rate at which the signal changes sign.\n    spectralCentroid?: number // The center of mass of the spectrum, indicating the brightness of the sound.\n    spectralFlatness?: number // Measure of the flatness of the spectrum, indicating how noise-like the signal is.\n    spectralRolloff?: number // The frequency below which a specified percentage (usually 85%) of the total spectral energy lies.\n    spectralBandwidth?: number // The width of the spectrum, indicating the range of frequencies present.\n    chromagram?: number[] // Chromagram, representing the 12 different pitch classes of the audio.\n    tempo?: number // Estimated tempo of the audio signal, measured in beats per minute (BPM).\n    hnr?: number // Harmonics-to-noise ratio, indicating the proportion of harmonics to noise in the audio signal.\n    melSpectrogram?: number[] // Mel-scaled spectrogram representation of the audio.\n    spectralContrast?: number[] // Spectral contrast features representing the difference between peaks and valleys.\n    tonnetz?: number[] // Tonal network features representing harmonic relationships.\n    pitch?: number // Pitch of the audio signal, measured in Hertz (Hz).\n    crc32?: number // crc32 checksum of the audio signal, used to verify the integrity of the audio.\n}\n\n/**\n * Options to specify which audio features to extract.\n * Note: Advanced features (spectral features, chromagram, pitch, etc.) are experimental,\n * especially during live recording, due to high processing requirements.\n */\nexport interface AudioFeaturesOptions {\n    // Basic features - well optimized\n    energy?: boolean\n    rms?: boolean\n    zcr?: boolean\n\n    // Advanced features - experimental, may impact performance in live recording\n    mfcc?: boolean\n    spectralCentroid?: boolean\n    spectralFlatness?: boolean\n    spectralRolloff?: boolean\n    spectralBandwidth?: boolean\n    chromagram?: boolean\n    tempo?: boolean\n    hnr?: boolean\n    melSpectrogram?: boolean\n    spectralContrast?: boolean\n    tonnetz?: boolean\n    pitch?: boolean\n\n    // Utility\n    crc32?: boolean\n}\n\n/**\n * Represents a single data point in the audio analysis.\n */\nexport interface DataPoint {\n    id: number\n    amplitude: number // Peak amplitude for the segment\n    rms: number // Root mean square value\n    dB: number // dBFS (decibels relative to full scale) computed from RMS value\n    silent: boolean // Always computed\n    features?: AudioFeatures\n    speech?: SpeechFeatures\n    startTime?: number\n    endTime?: number\n    // start / end position in bytes\n    startPosition?: number\n    endPosition?: number\n    // number of audio samples for this point (samples size depends on bit depth)\n    samples?: number\n}\n\n/**\n * Represents the complete data from the audio analysis.\n */\nexport interface AudioAnalysis {\n    segmentDurationMs: number // Duration of each segment in milliseconds\n    durationMs: number // Duration of the audio in milliseconds\n    bitDepth: number // Bit depth of the audio\n    samples: number // Size of the audio in bytes\n    numberOfChannels: number // Number of audio channels\n    sampleRate: number // Sample rate of the audio\n    dataPoints: DataPoint[] // Array of data points from the analysis.\n    amplitudeRange: {\n        min: number\n        max: number\n    }\n    rmsRange: {\n        min: number\n        max: number\n    }\n    // TODO: speaker changes into a broader speech analysis section\n    speechAnalysis?: {\n        speakerChanges: {\n            timestamp: number\n            speakerId: number\n        }[]\n        // Could add more speech analysis data here like:\n        // dominantSpeaker?: number\n        // totalSpeechDuration?: number\n        // speakerStats?: { [speakerId: number]: { duration: number, segments: number } }\n    }\n}\n\n/**\n * Options for specifying a time range within an audio file.\n */\nexport interface AudioRangeOptions {\n    /** Start time in milliseconds */\n    startTimeMs?: number\n    /** End time in milliseconds */\n    endTimeMs?: number\n}\n\n/**\n * Options for generating a quick preview of audio waveform.\n * This is optimized for UI rendering with a specified number of points.\n */\nexport interface PreviewOptions extends AudioRangeOptions {\n    /** URI of the audio file to analyze */\n    fileUri: string\n    /**\n     * Total number of points to generate for the preview.\n     * @default 100\n     */\n    numberOfPoints?: number\n    /**\n     * Optional logger for debugging.\n     */\n    logger?: ConsoleLike\n    /**\n     * Optional configuration for decoding the audio file.\n     * Defaults to:\n     * - targetSampleRate: undefined (keep original)\n     * - targetChannels: undefined (keep original)\n     * - targetBitDepth: 16\n     * - normalizeAudio: false\n     */\n    decodingOptions?: DecodingConfig\n}\n\n/**\n * Options for mel-spectrogram extraction\n *\n * @experimental This feature is experimental and currently only available on Android.\n * The API may change in future versions.\n */\nexport interface ExtractMelSpectrogramOptions {\n    fileUri?: string // Path to audio file\n    arrayBuffer?: ArrayBuffer // Raw audio buffer\n    windowSizeMs: number // Window size in ms (e.g., 25)\n    hopLengthMs: number // Hop length in ms (e.g., 10)\n    nMels: number // Number of mel filters (e.g., 60)\n    fMin?: number // Min frequency (default: 0)\n    fMax?: number // Max frequency (default: sampleRate / 2)\n    windowType?: 'hann' | 'hamming' // Window function (default: 'hann')\n    normalize?: boolean // Mean normalization (default: false)\n    logScale?: boolean // Log scaling of mel energies (default: true)\n    decodingOptions?: DecodingConfig // Audio decoding settings\n    startTimeMs?: number // Optional start time\n    endTimeMs?: number // Optional end time\n    logger?: ConsoleLike\n}\n\n/**\n * Return type for mel spectrogram extraction\n *\n * @experimental This feature is experimental and currently only available on Android.\n * The API may change in future versions.\n */\nexport interface MelSpectrogram {\n    spectrogram: number[][] // 2D array [time][mel]\n    sampleRate: number // Audio sample rate\n    nMels: number // Number of mel filters\n    timeSteps: number // Number of time frames\n    durationMs: number // Audio duration in ms\n}\n"]}
+{"version":3,"file":"AudioAnalysis.types.js","sourceRoot":"","sources":["../../../src/AudioAnalysis/AudioAnalysis.types.ts"],"names":[],"mappings":";AAAA,sEAAsE","sourcesContent":["// packages/expo-audio-stream/src/AudioAnalysis/AudioAnalysis.types.ts\n\nimport { BitDepth, ConsoleLike } from '../ExpoAudioStream.types'\n\n/**\n * Represents the configuration for decoding audio data.\n */\nexport interface DecodingConfig {\n    /** Target sample rate for decoded audio (Android and Web) */\n    targetSampleRate?: number\n    /** Target number of channels (Android and Web) */\n    targetChannels?: number\n    /** Target bit depth (Android and Web) */\n    targetBitDepth?: BitDepth\n    /** Whether to normalize audio levels (Android and Web) */\n    normalizeAudio?: boolean\n}\n\n/**\n * Represents speech-related features extracted from audio.\n */\nexport interface SpeechFeatures {\n    isActive: boolean // Whether speech is detected in this segment\n    speakerId?: number // Optional speaker identification\n    // Could add more speech-related features here like:\n    // confidence: number\n    // language?: string\n    // sentiment?: number\n    // etc.\n}\n\n/**\n * Represents various audio features extracted from an audio signal.\n */\nexport interface AudioFeatures {\n    energy?: number // The infinite integral of the squared signal, representing the overall energy of the audio.\n    mfcc?: number[] // Mel-frequency cepstral coefficients, describing the short-term power spectrum of a sound.\n    rms?: number // Root mean square value, indicating the amplitude of the audio signal.\n    minAmplitude?: number // Minimum amplitude value in the audio signal.\n    maxAmplitude?: number // Maximum amplitude value in the audio signal.\n    zcr?: number // Zero-crossing rate, indicating the rate at which the signal changes sign.\n    spectralCentroid?: number // The center of mass of the spectrum, indicating the brightness of the sound.\n    spectralFlatness?: number // Measure of the flatness of the spectrum, indicating how noise-like the signal is.\n    spectralRolloff?: number // The frequency below which a specified percentage (usually 85%) of the total spectral energy lies.\n    spectralBandwidth?: number // The width of the spectrum, indicating the range of frequencies present.\n    chromagram?: number[] // Chromagram, representing the 12 different pitch classes of the audio.\n    tempo?: number // Estimated tempo of the audio signal, measured in beats per minute (BPM).\n    hnr?: number // Harmonics-to-noise ratio, indicating the proportion of harmonics to noise in the audio signal.\n    melSpectrogram?: number[] // Mel-scaled spectrogram representation of the audio.\n    spectralContrast?: number[] // Spectral contrast features representing the difference between peaks and valleys.\n    tonnetz?: number[] // Tonal network features representing harmonic relationships.\n    pitch?: number // Pitch of the audio signal, measured in Hertz (Hz).\n    crc32?: number // crc32 checksum of the audio signal, used to verify the integrity of the audio.\n}\n\n/**\n * Options to specify which audio features to extract.\n * Note: Advanced features (spectral features, chromagram, pitch, etc.) are experimental,\n * especially during live recording, due to high processing requirements.\n */\nexport interface AudioFeaturesOptions {\n    // Basic features - well optimized\n    energy?: boolean\n    rms?: boolean\n    zcr?: boolean\n\n    // Advanced features - experimental, may impact performance in live recording\n    mfcc?: boolean\n    spectralCentroid?: boolean\n    spectralFlatness?: boolean\n    spectralRolloff?: boolean\n    spectralBandwidth?: boolean\n    chromagram?: boolean\n    tempo?: boolean\n    hnr?: boolean\n    melSpectrogram?: boolean\n    spectralContrast?: boolean\n    tonnetz?: boolean\n    pitch?: boolean\n\n    // Utility\n    crc32?: boolean\n}\n\n/**\n * Represents a single data point in the audio analysis.\n */\nexport interface DataPoint {\n    id: number\n    amplitude: number // Peak amplitude for the segment\n    rms: number // Root mean square value\n    dB: number // dBFS (decibels relative to full scale) computed from RMS value\n    silent: boolean // Always computed\n    features?: AudioFeatures\n    speech?: SpeechFeatures\n    startTime?: number\n    endTime?: number\n    // start / end position in bytes\n    startPosition?: number\n    endPosition?: number\n    // number of audio samples for this point (samples size depends on bit depth)\n    samples?: number\n}\n\n/**\n * Represents the complete data from the audio analysis.\n */\nexport interface AudioAnalysis {\n    segmentDurationMs: number // Duration of each segment in milliseconds\n    durationMs: number // Duration of the audio in milliseconds\n    bitDepth: number // Bit depth of the audio\n    samples: number // Size of the audio in bytes\n    numberOfChannels: number // Number of audio channels\n    sampleRate: number // Sample rate of the audio\n    dataPoints: DataPoint[] // Array of data points from the analysis.\n    amplitudeRange: {\n        min: number\n        max: number\n    }\n    rmsRange: {\n        min: number\n        max: number\n    }\n    extractionTimeMs: number // Time taken to extract/process the analysis in milliseconds\n    // TODO: speaker changes into a broader speech analysis section\n    speechAnalysis?: {\n        speakerChanges: {\n            timestamp: number\n            speakerId: number\n        }[]\n        // Could add more speech analysis data here like:\n        // dominantSpeaker?: number\n        // totalSpeechDuration?: number\n        // speakerStats?: { [speakerId: number]: { duration: number, segments: number } }\n    }\n}\n\n/**\n * Options for specifying a time range within an audio file.\n */\nexport interface AudioRangeOptions {\n    /** Start time in milliseconds */\n    startTimeMs?: number\n    /** End time in milliseconds */\n    endTimeMs?: number\n}\n\n/**\n * Options for generating a quick preview of audio waveform.\n * This is optimized for UI rendering with a specified number of points.\n */\nexport interface PreviewOptions extends AudioRangeOptions {\n    /** URI of the audio file to analyze */\n    fileUri: string\n    /**\n     * Total number of points to generate for the preview.\n     * @default 100\n     */\n    numberOfPoints?: number\n    /**\n     * Optional logger for debugging.\n     */\n    logger?: ConsoleLike\n    /**\n     * Optional configuration for decoding the audio file.\n     * Defaults to:\n     * - targetSampleRate: undefined (keep original)\n     * - targetChannels: undefined (keep original)\n     * - targetBitDepth: 16\n     * - normalizeAudio: false\n     */\n    decodingOptions?: DecodingConfig\n}\n\n/**\n * Options for mel-spectrogram extraction\n *\n * @experimental This feature is experimental and currently only available on Android.\n * The API may change in future versions.\n */\nexport interface ExtractMelSpectrogramOptions {\n    fileUri?: string // Path to audio file\n    arrayBuffer?: ArrayBuffer // Raw audio buffer\n    windowSizeMs: number // Window size in ms (e.g., 25)\n    hopLengthMs: number // Hop length in ms (e.g., 10)\n    nMels: number // Number of mel filters (e.g., 60)\n    fMin?: number // Min frequency (default: 0)\n    fMax?: number // Max frequency (default: sampleRate / 2)\n    windowType?: 'hann' | 'hamming' // Window function (default: 'hann')\n    normalize?: boolean // Mean normalization (default: false)\n    logScale?: boolean // Log scaling of mel energies (default: true)\n    decodingOptions?: DecodingConfig // Audio decoding settings\n    startTimeMs?: number // Optional start time\n    endTimeMs?: number // Optional end time\n    logger?: ConsoleLike\n}\n\n/**\n * Return type for mel spectrogram extraction\n *\n * @experimental This feature is experimental and currently only available on Android.\n * The API may change in future versions.\n */\nexport interface MelSpectrogram {\n    spectrogram: number[][] // 2D array [time][mel]\n    sampleRate: number // Audio sample rate\n    nMels: number // Number of mel filters\n    timeSteps: number // Number of time frames\n    durationMs: number // Audio duration in ms\n}\n"]}