feat: expose android audio and focus modes (#84)

Author: davidliu

android/build.gradle

@@ -129,7 +129,7 @@ dependencies {
   // noinspection GradleDynamicVersion
   api 'com.facebook.react:react-native:+'
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-  api 'com.github.davidliu:audioswitch:c498d866c57f1d88056d5e7e7a78d622e3b0c046'
+  api 'com.github.davidliu:audioswitch:fb33b237aa50b3d1d2dea0e0695ecb7b38a98971'
   api 'io.github.webrtc-sdk:android:104.5112.10'
   implementation project(':livekit_react-native-webrtc')
   implementation "androidx.annotation:annotation:1.4.0"

android/src/main/java/com/livekit/reactnative/LivekitReactNativeModule.kt

@@ -2,6 +2,7 @@ package com.livekit.reactnative
 
 import com.facebook.react.bridge.*
 import com.livekit.reactnative.audio.AudioDeviceKind
+import com.livekit.reactnative.audio.AudioManagerUtils
 import com.livekit.reactnative.audio.AudioSwitchManager
 
 
@@ -23,6 +24,19 @@ class LivekitReactNativeModule(reactContext: ReactApplicationContext) : ReactCon
             }
             audioManager.preferredDeviceList = preferredDeviceList
         }
+
+        androidConfig.getString("audioMode")?.let { audioModeString ->
+            val audioMode = AudioManagerUtils.audioModeFromString(audioModeString)
+            if (audioMode != null) {
+                audioManager.setAudioMode(audioMode)
+            }
+        }
+        androidConfig.getString("audioFocusMode")?.let { focusModeString ->
+            val focusMode = AudioManagerUtils.focusModeFromString(focusModeString)
+            if (focusMode != null) {
+                audioManager.setFocusMode(focusMode)
+            }
+        }
     }
 
     @ReactMethod

android/src/main/java/com/livekit/reactnative/audio/AudioManagerUtils.kt

@@ -0,0 +1,44 @@
+package com.livekit.reactnative.audio
+
+import android.media.AudioManager
+import android.util.Log
+
+
+object AudioManagerUtils {
+    private const val TAG = "AudioManagerUtils"
+
+    fun audioModeFromString(audioModeString: String?): Int? {
+        if (audioModeString == null) {
+            return null
+        }
+
+        var audioMode: Int? = null
+        when (audioModeString) {
+            "normal" -> audioMode = AudioManager.MODE_NORMAL
+            "callScreening" -> audioMode = AudioManager.MODE_CALL_SCREENING
+            "inCall" -> audioMode = AudioManager.MODE_IN_CALL
+            "inCommunication" -> audioMode = AudioManager.MODE_IN_COMMUNICATION
+            "ringtone" -> audioMode = AudioManager.MODE_RINGTONE
+            else -> Log.w(TAG, "Unknown audio mode: $audioModeString")
+        }
+
+        return audioMode
+    }
+
+    fun focusModeFromString(focusModeString: String?): Int? {
+        if (focusModeString == null) {
+            return null
+        }
+
+        var focusMode: Int? = null
+        when (focusModeString) {
+            "gain" -> focusMode = AudioManager.AUDIOFOCUS_GAIN
+            "gainTransient" -> focusMode = AudioManager.AUDIOFOCUS_GAIN_TRANSIENT
+            "gainTransientExclusive" -> focusMode = AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE
+            "gainTransientMayDuck" -> focusMode = AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
+            else -> Log.w(TAG, "Unknown audio focus mode: $focusModeString")
+        }
+
+        return focusMode
+    }
+}

android/src/main/java/com/livekit/reactnative/audio/AudioSwitchManager.java

@@ -43,6 +43,20 @@ public class AudioSwitchManager {
     @Nullable
     private AudioSwitch audioSwitch;
 
+    /**
+     * The audio focus mode to use while started.
+     *
+     * Defaults to [AudioManager.AUDIOFOCUS_GAIN].
+     */
+    private int focusMode = AudioManager.AUDIOFOCUS_GAIN;
+
+    /**
+     * The audio mode to use while started.
+     *
+     * Defaults to [AudioManager.MODE_NORMAL].
+     */
+    private int audioMode = AudioManager.MODE_NORMAL;
+
     public AudioSwitchManager(@NonNull Context context) {
         this.context = context;
         this.audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
@@ -64,6 +78,8 @@ public void start() {
                         audioFocusChangeListener,
                         preferredDeviceList
                 );
+                audioSwitch.setFocusMode(focusMode);
+                audioSwitch.setAudioMode(audioMode);
                 audioSwitch.start(audioDeviceChangeListener);
                 audioSwitch.activate();
             });
@@ -137,4 +153,12 @@ public void selectAudioOutput(@Nullable AudioDeviceKind kind) {
             selectAudioOutput(kind.audioDeviceClass);
         }
     }
+
+    public void setFocusMode(int focusMode) {
+        this.focusMode = focusMode;
+    }
+
+    public void setAudioMode(int audioMode) {
+        this.audioMode = audioMode;
+    }
 }

example/src/RoomPage.tsx

@@ -62,7 +62,9 @@ export const RoomPage = ({
       // If you wish to configure audio, uncomment the following:
       // await AudioSession.configureAudio({
       //   android: {
-      //     preferredOutputList: ["earpiece"]
+      //     preferredOutputList: ["earpiece"],
+      //     audioMode: 'normal',
+      //     audioFocusMode: 'gain',
       //   },
       //   ios: {
       //     defaultOutput: "earpiece"

src/audio/AudioSession.ts

@@ -39,11 +39,22 @@ const LivekitReactNative = NativeModules.LivekitReactNative
  *   By default, this is set to `"speaker"`
  */
 export type AudioConfiguration = {
-  android: {
-    preferredOutputList: ('speaker' | 'earpiece' | 'headset' | 'bluetooth')[];
+  android?: {
+    preferredOutputList?: ('speaker' | 'earpiece' | 'headset' | 'bluetooth')[];
+    audioMode?:
+      | 'normal'
+      | 'callScreening'
+      | 'inCall'
+      | 'inCommunication'
+      | 'ringtone';
+    audioFocusMode?:
+      | 'gain'
+      | 'gainTransient'
+      | 'gainTransientExclusive'
+      | 'gainTransientMayDuck';
   };
-  ios: {
-    defaultOutput: 'speaker' | 'earpiece';
+  ios?: {
+    defaultOutput?: 'speaker' | 'earpiece';
   };
 };