@stream-io/video-react-native-sdk 1.27.4 → 1.28.1

package/src/modules/call-manager/CallManager.ts

@@ -91,6 +91,8 @@ export class CallManager {
    * @param config.deviceEndpointType The default audio device endpoint type to set. It can be one of the following:
    * - `'speaker'`: (Default) For normal video or voice calls.
    * - `'earpiece'`: For voice-only mobile call type scenarios.
+   *
+   * @param config.enableStereoAudioOutput Whether to enable stereo audio output. Only supported for listener audio role.
    */
   start = (config?: StreamInCallManagerConfig): void => {
     NativeManager.setAudioRole(config?.audioRole ?? 'communicator');
@@ -98,6 +100,9 @@ export class CallManager {
       const type = config.deviceEndpointType ?? 'speaker';
       NativeManager.setDefaultAudioDeviceEndpointType(type);
     }
+    if (config?.audioRole === 'listener' && config.enableStereoAudioOutput) {
+      NativeManager.setEnableStereoAudioOutput(true);
+    }
     NativeManager.start();
   };
 

package/src/modules/call-manager/native-module.d.ts

@@ -51,6 +51,11 @@ export interface CallManager extends NativeModule {
    */
   stop: () => void;
 
+  /**
+   * Setup the in call manager.
+   */
+  setup: () => void;
+
   /**
    * Mutes the speaker
    */
@@ -66,6 +71,12 @@ export interface CallManager extends NativeModule {
    */
   setForceSpeakerphoneOn: (boolean) => void;
 
+  /**
+   * Enables or disables stereo audio output.
+   * @param enable - Whether to enable stereo audio output.
+   */
+  setEnableStereoAudioOutput: (enable: boolean) => void;
+
   /**
    * Log the current audio state natively.
    * Meant for debugging purposes.

package/src/modules/call-manager/types.ts

@@ -22,4 +22,5 @@ export type StreamInCallManagerConfig =
     }
   | {
       audioRole: 'listener';
+      enableStereoAudioOutput?: boolean;
     };

package/src/utils/internal/registerSDKGlobals.ts

@@ -0,0 +1,30 @@
+import { StreamRNVideoSDKGlobals } from '@stream-io/video-client';
+import { NativeModules } from 'react-native';
+
+const StreamInCallManagerNativeModule = NativeModules.StreamInCallManager;
+
+const streamRNVideoSDKGlobals: StreamRNVideoSDKGlobals = {
+  callManager: {
+    setup: ({ defaultDevice }) => {
+      StreamInCallManagerNativeModule.setDefaultAudioDeviceEndpointType(
+        defaultDevice,
+      );
+      StreamInCallManagerNativeModule.setup();
+    },
+    start: () => {
+      StreamInCallManagerNativeModule.start();
+    },
+    stop: () => {
+      StreamInCallManagerNativeModule.stop();
+    },
+  },
+};
+
+// Note: The global type declaration for `streamRNVideoSDK` is defined in
+// @stream-io/video-client/src/types.ts and is automatically available when
+// importing from the client package.
+export function registerSDKGlobals() {
+  if (!global.streamRNVideoSDK) {
+    global.streamRNVideoSDK = streamRNVideoSDKGlobals;
+  }
+}

package/src/utils/push/setupIosCallKeepEvents.ts

@@ -12,6 +12,7 @@ import {
   processCallFromPushInBackground,
 } from './internal/utils';
 import { AppState, NativeModules, Platform } from 'react-native';
+import { RTCAudioSession } from '@stream-io/react-native-webrtc';
 import { setPushLogoutCallback } from '../internal/pushLogoutCallback';
 
 type PushConfig = NonNullable<StreamVideoConfig['push']>;
@@ -75,6 +76,34 @@ export function setupIosCallKeepEvents(
     });
   }
 
+  /**
+   * CallKeep / CallKit audio-session events -> WebRTC (iOS)
+   *
+   * iOS CallKit is the authority that *activates* and *deactivates* the underlying `AVAudioSession`
+   * when a call is answered/ended from the system UI (lock screen, Call UI, Bluetooth, etc).
+   *
+   * WebRTC on iOS wraps `AVAudioSession` with `RTCAudioSession` and its AudioDeviceModule relies on
+   * being notified of those lifecycle transitions to correctly start/stop audio I/O and keep its
+   * internal activation state consistent (e.g. activation count, playout/recording start).
+   *
+   * If these callbacks don’t reach WebRTC, answering via the native dialer UI can result in:
+   * - no microphone capture / one-way audio
+   * - silent playout until the app forces an audio reconfiguration
+   * - flaky audio routing (speaker/earpiece/Bluetooth) across subsequent calls
+   *
+   * We forward CallKeep’s `didActivateAudioSession` / `didDeactivateAudioSession` events to WebRTC’s
+   * `RTCAudioSession.audioSessionDidActivate()` / `audioSessionDidDeactivate()` methods.
+   */
+  function didActivateAudioSession() {
+    logger.debug('didActivateAudioSession');
+    RTCAudioSession.audioSessionDidActivate();
+  }
+
+  function didDeactivateAudioSession() {
+    logger.debug('didDeactivateAudioSession');
+    RTCAudioSession.audioSessionDidDeactivate();
+  }
+
   function didDisplayIncomingCall(callUUID: string, payload: object) {
     const voipPushNotification = getVoipPushNotificationLib();
     // @ts-expect-error - call_cid is not part of RNCallKeepEventPayload
@@ -118,6 +147,20 @@ export function setupIosCallKeepEvents(
     },
   );
 
+  const { remove: removeDidActivateAudioSession } = callkeep.addEventListener(
+    'didActivateAudioSession',
+    () => {
+      didActivateAudioSession();
+    },
+  );
+
+  const { remove: removeDidDeactivateAudioSession } = callkeep.addEventListener(
+    'didDeactivateAudioSession',
+    () => {
+      didDeactivateAudioSession();
+    },
+  );
+
   const { remove: removeDidLoadWithEvents } = callkeep.addEventListener(
     'didLoadWithEvents',
     (events) => {
@@ -133,6 +176,10 @@ export function setupIosCallKeepEvents(
           answerCall(data.callUUID);
         } else if (name === 'RNCallKeepPerformEndCallAction') {
           endCall(data.callUUID);
+        } else if (name === 'RNCallKeepDidActivateAudioSession') {
+          didActivateAudioSession();
+        } else if (name === 'RNCallKeepDidDeactivateAudioSession') {
+          didDeactivateAudioSession();
         }
       });
     },
@@ -142,6 +189,8 @@ export function setupIosCallKeepEvents(
     removeAnswerCall();
     removeEndCall();
     removeDisplayIncomingCall();
+    removeDidActivateAudioSession();
+    removeDidDeactivateAudioSession();
     removeDidLoadWithEvents();
   });
 }

package/src/version.ts

@@ -1 +1 @@
-export const version = '1.27.4';
+export const version = '1.28.1';

package/android/src/main/java/com/streamvideo/reactnative/audio/utils/AudioSetupStoreUtil.kt

@@ -1,41 +0,0 @@
-package com.streamvideo.reactnative.audio.utils
-
-import android.media.AudioManager
-import android.util.Log
-import com.facebook.react.bridge.ReactContext
-import com.streamvideo.reactnative.audio.AudioDeviceManager
-import com.streamvideo.reactnative.callmanager.StreamInCallManagerModule.Companion.TAG
-
-class AudioSetupStoreUtil(
-    private val mReactContext: ReactContext,
-    private val mAudioManager: AudioManager,
-    private val mAudioDeviceManager: AudioDeviceManager
-) {
-    private var isOrigAudioSetupStored = false
-    private var origIsSpeakerPhoneOn = false
-    private var origIsMicrophoneMute = false
-    private var origAudioMode = AudioManager.MODE_NORMAL
-
-    fun storeOriginalAudioSetup() {
-        if (!isOrigAudioSetupStored) {
-            origAudioMode = mAudioManager.mode
-            origIsSpeakerPhoneOn = AudioManagerUtil.isSpeakerphoneOn(mAudioManager)
-            origIsMicrophoneMute = mAudioManager.isMicrophoneMute
-            isOrigAudioSetupStored = true
-        }
-    }
-
-    fun restoreOriginalAudioSetup() {
-        if (isOrigAudioSetupStored) {
-            if (origIsSpeakerPhoneOn) {
-                mAudioDeviceManager.setSpeakerphoneOn(true)
-            }
-            mAudioManager.setMicrophoneMute(origIsMicrophoneMute)
-            mAudioManager.mode = origAudioMode
-            mReactContext.currentActivity?.apply {
-                volumeControlStream = AudioManager.USE_DEFAULT_STREAM_TYPE
-            }
-            isOrigAudioSetupStored = false
-        }
-    }
-}