fix: improve android wake lock and power manager handling RN-291 (#1990)

santhoshvai · web-flow · commit 28096ad9b148 · 2025-11-10T13:21:22.000+01:00
### 💡 Overview Follow up to #1971 Fixes the following issues on android: * Proximity stuff (turning off screen when kept closed to body for earpiece output) - should be done only for communicator mode * `getAudioDeviceStatus` method was somehow removed from callmanager native side. This PR adds it back. * Earpiece detection was using older APIs on newer android. This PR makes sure newer APIs are used. * Ringing calls started with earpiece. No need to do so. Changed to speaker now. * adds the necessary `android.permission.WAKE_LOCK` to the android library extra: comments to clarify impl in iOS ### 📝 Implementation notes 🎫 Ticket: https://linear.app/stream/issue/XYZ-123 📑 Docs: https://github.com/GetStream/docs-content/pull/<id>
diff --git a/packages/react-native-sdk/android/src/main/AndroidManifest.xml b/packages/react-native-sdk/android/src/main/AndroidManifest.xml
@@ -3,4 +3,5 @@
 
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.DEVICE_POWER" />
+    <uses-permission android:name="android.permission.WAKE_LOCK" />
 </manifest>
diff --git a/packages/react-native-sdk/android/src/main/java/com/streamvideo/reactnative/audio/AudioDeviceManager.kt b/packages/react-native-sdk/android/src/main/java/com/streamvideo/reactnative/audio/AudioDeviceManager.kt
@@ -33,6 +33,7 @@ import com.streamvideo.reactnative.audio.utils.AudioManagerUtil
 import com.streamvideo.reactnative.audio.utils.AudioManagerUtil.Companion.getAvailableAudioDevices
 import com.streamvideo.reactnative.audio.utils.AudioSetupStoreUtil
 import com.streamvideo.reactnative.audio.utils.CallAudioRole
+import com.streamvideo.reactnative.callmanager.ProximityManager
 import com.streamvideo.reactnative.callmanager.StreamInCallManagerModule
 import com.streamvideo.reactnative.model.AudioDeviceEndpoint
 import com.streamvideo.reactnative.model.AudioDeviceEndpoint.Companion.EndpointType
@@ -70,12 +71,15 @@ class AudioDeviceManager(
 
     /** Returns the currently selected audio device. */
     private var _selectedAudioDeviceEndpoint: AudioDeviceEndpoint? = null
-    private var selectedAudioDeviceEndpoint: AudioDeviceEndpoint?
+    var selectedAudioDeviceEndpoint: AudioDeviceEndpoint?
         get() = _selectedAudioDeviceEndpoint
         set(value) {
             _selectedAudioDeviceEndpoint = value
             // send an event to the frontend everytime this endpoint changes
             sendAudioStatusEvent()
+            if (callAudioRole == CallAudioRole.Communicator) {
+                proximityManager.update()
+            }
         }
 
     // Default audio device; speaker phone for video calls or earpiece for audio only phone calls
@@ -101,6 +105,8 @@ class AudioDeviceManager(
 
     val bluetoothManager = BluetoothManager(mReactContext, this)
 
+    private val proximityManager by lazy { ProximityManager(mReactContext, this) }
+
     init {
         // Note that we will immediately receive a call to onDevicesAdded with the list of
         // devices which are currently connected.
@@ -120,6 +126,7 @@ class AudioDeviceManager(
                 bluetoothManager.start()
                 mAudioManager.registerAudioDeviceCallback(this, null)
                 updateAudioDeviceState()
+                proximityManager.start()
             } else {
                 // Audio routing is handled automatically by the system in normal media mode
                 // and bluetooth microphones may not work on some devices.
@@ -141,6 +148,7 @@ class AudioDeviceManager(
                     mAudioManager.setSpeakerphoneOn(false)
                 }
                 bluetoothManager.stop()
+                proximityManager.stop()
             }
             audioSetupStoreUtil.restoreOriginalAudioSetup()
             audioFocusUtil.abandonFocus()
@@ -221,6 +229,7 @@ class AudioDeviceManager(
 
     override fun close() {
         mAudioManager.unregisterAudioDeviceCallback(this)
+        proximityManager.onDestroy()
     }
 
     override fun onAudioDevicesAdded(addedDevices: Array<out AudioDeviceInfo>?) {
@@ -522,7 +531,7 @@ class AudioDeviceManager(
         }
     }
 
-    private fun audioStatusMap(): WritableMap {
+    fun audioStatusMap(): WritableMap {
         val endpoint = this.selectedAudioDeviceEndpoint
         val availableEndpoints = Arguments.fromList(getCurrentDeviceEndpoints().map { it.name })
 
diff --git a/packages/react-native-sdk/android/src/main/java/com/streamvideo/reactnative/callmanager/ProximityManager.kt b/packages/react-native-sdk/android/src/main/java/com/streamvideo/reactnative/callmanager/ProximityManager.kt
@@ -8,6 +8,7 @@ import android.media.AudioDeviceInfo
 import android.media.AudioManager
 import android.os.PowerManager
 import android.util.Log
+import com.streamvideo.reactnative.audio.AudioDeviceManager
 
 /**
  * Encapsulates Android proximity sensor handling for in-call UX.
@@ -20,6 +21,7 @@ import android.util.Log
  */
 class ProximityManager(
     private val context: Context,
+    private val audioDeviceManager: AudioDeviceManager,
 ) {
 
     companion object {
@@ -67,10 +69,7 @@ class ProximityManager(
         }
         try {
             powerManager = context.getSystemService(Context.POWER_SERVICE) as PowerManager
-            // Obtain PROXIMITY_SCREEN_OFF_WAKE_LOCK via reflection to avoid compile-time dependency
-            val field = PowerManager::class.java.getField("PROXIMITY_SCREEN_OFF_WAKE_LOCK")
-            val level = field.getInt(null)
-            proximityWakeLock = powerManager?.newWakeLock(level, "$TAG:Proximity")
+            proximityWakeLock = powerManager?.newWakeLock(PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK, "$TAG:Proximity")
         } catch (t: Throwable) {
             Log.w(TAG, "Proximity wakelock init failed (may be unsupported on this device)", t)
             proximityWakeLock = null
@@ -156,28 +155,6 @@ class ProximityManager(
     }
 
     private fun isOnEarpiece(): Boolean {
-        val audioManager = context.getSystemService(Context.AUDIO_SERVICE) as AudioManager
-        // If speakerphone is on, not earpiece
-        if (audioManager.isSpeakerphoneOn) return false
-
-        // Check if Bluetooth SCO/A2DP or wired headset is connected
-        var hasBt = false
-        var hasWired = false
-        val outputs = audioManager.getDevices(AudioManager.GET_DEVICES_OUTPUTS)
-        outputs.forEach { dev ->
-            val type = dev.type
-            if (type == AudioDeviceInfo.TYPE_BLUETOOTH_A2DP ||
-                type == AudioDeviceInfo.TYPE_BLUETOOTH_SCO
-            ) {
-                hasBt = true
-            } else if (type == AudioDeviceInfo.TYPE_WIRED_HEADPHONES
-                || type == AudioDeviceInfo.TYPE_WIRED_HEADSET
-                || type == AudioDeviceInfo.TYPE_USB_HEADSET
-            ) {
-                hasWired = true
-            }
-        }
-
-        return !hasBt && !hasWired
+        return audioDeviceManager.selectedAudioDeviceEndpoint?.isEarpieceType() ?: false
     }
 }
diff --git a/packages/react-native-sdk/android/src/main/java/com/streamvideo/reactnative/callmanager/StreamInCallManagerModule.kt b/packages/react-native-sdk/android/src/main/java/com/streamvideo/reactnative/callmanager/StreamInCallManagerModule.kt
@@ -3,6 +3,7 @@ package com.streamvideo.reactnative.callmanager
 import android.util.Log
 import android.view.WindowManager
 import com.facebook.react.bridge.LifecycleEventListener
+import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReactMethod
@@ -20,7 +21,6 @@ class StreamInCallManagerModule(reactContext: ReactApplicationContext) :
     private var audioManagerActivated = false
 
     private val mAudioDeviceManager = AudioDeviceManager(reactContext)
-    private val proximityManager = ProximityManager(reactContext)
 
     override fun getName(): String {
         return TAG
@@ -89,8 +89,6 @@ class StreamInCallManagerModule(reactContext: ReactApplicationContext) :
                     mAudioDeviceManager.start(it)
                     setKeepScreenOn(true)
                     audioManagerActivated = true
-                    // Initialize and evaluate proximity monitoring via controller
-                    proximityManager.start()
                 }
             }
         }
@@ -103,8 +101,6 @@ class StreamInCallManagerModule(reactContext: ReactApplicationContext) :
                 Log.d(TAG, "stop() mAudioDeviceManager")
                 mAudioDeviceManager.stop()
                 setMicrophoneMute(false)
-                // Disable proximity monitoring via controller and clear keep-screen-on
-                proximityManager.stop()
                 setKeepScreenOn(false)
                 audioManagerActivated = false
             }
@@ -133,15 +129,18 @@ class StreamInCallManagerModule(reactContext: ReactApplicationContext) :
             return
         }
         mAudioDeviceManager.setSpeakerphoneOn(enable)
-        // Re-evaluate proximity monitoring when route may change
-        this.proximityManager.update()
     }
 
     @ReactMethod
     fun setMicrophoneMute(enable: Boolean) {
         mAudioDeviceManager.setMicrophoneMute(enable)
     }
 
+    @ReactMethod
+    fun getAudioDeviceStatus(promise: Promise) {
+        promise.resolve(mAudioDeviceManager.audioStatusMap())
+    }
+
     @ReactMethod
     fun logAudioState() {
         WebRtcAudioUtils.logAudioState(
@@ -160,8 +159,6 @@ class StreamInCallManagerModule(reactContext: ReactApplicationContext) :
         mAudioDeviceManager.switchDeviceFromDeviceName(
             endpointDeviceName
         )
-        // Re-evaluate proximity monitoring when endpoint changes
-        this.proximityManager.update()
     }
 
     @ReactMethod
diff --git a/packages/react-native-sdk/ios/StreamInCallManager.swift b/packages/react-native-sdk/ios/StreamInCallManager.swift
@@ -79,9 +79,11 @@ class StreamInCallManager: RCTEventEmitter {
                 options: session.categoryOptions
             )
             configureAudioSession()
-            // Enable wake lock to prevent the screen from dimming/locking during a call
+            
             DispatchQueue.main.async {
+                // Enable wake lock to prevent the screen from dimming/locking during a call
                 UIApplication.shared.isIdleTimerDisabled = true
+                // Register for audio route changes to turn off screen when earpiece is connected
                 self.registerAudioRouteObserver()
                 self.updateProximityMonitoring()
                 self.log("Wake lock enabled (idle timer disabled)")
@@ -120,8 +122,10 @@ class StreamInCallManager: RCTEventEmitter {
         }
         // Disable wake lock and proximity when call manager stops so the device can sleep again
         DispatchQueue.main.async {
+            // Disable proximity monitoring to disable earpiece detection
             self.setProximityMonitoringEnabled(false)
             self.unregisterAudioRouteObserver()
+            // Disable wake lock to allow the screen to dim/lock again
             UIApplication.shared.isIdleTimerDisabled = false
             self.log("Wake lock disabled (idle timer enabled)")
         }
diff --git a/sample-apps/react-native/dogfood/src/navigators/Call.tsx b/sample-apps/react-native/dogfood/src/navigators/Call.tsx
@@ -46,7 +46,7 @@ const CallLeaveOnUnmount = ({ call }: { call: StreamCallType }) => {
   useEffect(() => {
     callManager.start({
       audioRole: 'communicator',
-      deviceEndpointType: 'earpiece',
+      deviceEndpointType: 'speaker',
     });
     return () => {
       callManager.stop();
