@livekit/react-native 1.2.0 → 1.3.0

package/README.md

@@ -45,7 +45,7 @@ public class MainApplication extends Application implements ReactApplication {
   @Override
   public void onCreate() {
     // Place this above any other RN related initialization
-    LiveKitReactNative.setup();
+    LiveKitReactNative.setup(this);
 
     //...
   }

package/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:fb33b237aa50b3d1d2dea0e0695ecb7b38a98971'
+  api 'com.github.davidliu:audioswitch:d18e3e31d427c27f1593030e024b370bf24480fd'
   api 'io.github.webrtc-sdk:android:104.5112.10'
   implementation project(':livekit_react-native-webrtc')
   implementation "androidx.annotation:annotation:1.4.0"

package/android/src/main/java/com/livekit/reactnative/LiveKitReactNative.kt

@@ -1,16 +1,35 @@
 package com.livekit.reactnative
 
+import android.app.Application
+import android.content.Context
+import android.os.Build
+import com.livekit.reactnative.audio.AudioType
 import com.livekit.reactnative.video.SimulcastVideoEncoderFactoryWrapper
 import com.livekit.reactnative.video.WrappedVideoDecoderFactoryProxy
 import com.oney.WebRTCModule.WebRTCModuleOptions
-
+import org.webrtc.audio.JavaAudioDeviceModule
 
 object LiveKitReactNative {
 
+    /**
+     * Initializes components required for LiveKit to work on Android.
+     *
+     * Must be called from your [Application.onCreate] method before any other react-native
+     * initialization.
+     */
     @JvmStatic
-    fun setup() {
+    @JvmOverloads
+    fun setup(context: Context, audioType: AudioType = AudioType.CommunicationAudioType()) {
         val options = WebRTCModuleOptions.getInstance()
         options.videoEncoderFactory = SimulcastVideoEncoderFactoryWrapper(null, true, true)
         options.videoDecoderFactory = WrappedVideoDecoderFactoryProxy()
+
+        val useHardwareAudioProcessing = Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q
+
+        options.audioDeviceModule = JavaAudioDeviceModule.builder(context)
+            .setUseHardwareAcousticEchoCanceler(useHardwareAudioProcessing)
+            .setUseHardwareNoiseSuppressor(useHardwareAudioProcessing)
+            .setAudioAttributes(audioType.audioAttributes)
+            .createAudioDeviceModule()
     }
 }

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

@@ -1,5 +1,7 @@
 package com.livekit.reactnative
 
+import android.annotation.SuppressLint
+import android.content.Context
 import com.facebook.react.bridge.*
 import com.livekit.reactnative.audio.AudioDeviceKind
 import com.livekit.reactnative.audio.AudioManagerUtils
@@ -17,24 +19,71 @@ class LivekitReactNativeModule(reactContext: ReactApplicationContext) : ReactCon
     fun configureAudio(config: ReadableMap) {
         val androidConfig = config.getMap("android") ?: return
 
-        androidConfig.getArray("preferredOutputList")?.let { preferredOutputList ->
-            val preferredDeviceList = preferredOutputList.toArrayList().mapNotNull { output ->
-                val outputStr = output as? String
-                AudioDeviceKind.fromTypeName(outputStr)?.audioDeviceClass
+        if (androidConfig.hasKey("preferredOutputList")) {
+            androidConfig.getArray("preferredOutputList")?.let { preferredOutputList ->
+                val preferredDeviceList = preferredOutputList.toArrayList().mapNotNull { output ->
+                    val outputStr = output as? String
+                    AudioDeviceKind.fromTypeName(outputStr)?.audioDeviceClass
+                }
+                audioManager.preferredDeviceList = preferredDeviceList
             }
-            audioManager.preferredDeviceList = preferredDeviceList
         }
 
-        androidConfig.getString("audioMode")?.let { audioModeString ->
-            val audioMode = AudioManagerUtils.audioModeFromString(audioModeString)
-            if (audioMode != null) {
-                audioManager.setAudioMode(audioMode)
+        if (androidConfig.hasKey("audioTypeOptions")) {
+            val audioTypeOptions = androidConfig.getMap("audioTypeOptions") ?: return
+
+            if (audioTypeOptions.hasKey("manageAudioFocus")) {
+                val manageFocus = audioTypeOptions.getBoolean("manageAudioFocus")
+                audioManager.setManageAudioFocus(manageFocus)
             }
-        }
-        androidConfig.getString("audioFocusMode")?.let { focusModeString ->
-            val focusMode = AudioManagerUtils.focusModeFromString(focusModeString)
-            if (focusMode != null) {
-                audioManager.setFocusMode(focusMode)
+            if (audioTypeOptions.hasKey("audioMode")) {
+                audioTypeOptions.getString("audioMode")?.let { audioModeString ->
+                    val audioMode = AudioManagerUtils.audioModeFromString(audioModeString)
+                    if (audioMode != null) {
+                        audioManager.setAudioMode(audioMode)
+                    }
+                }
+            }
+
+            if (audioTypeOptions.hasKey("audioFocusMode")) {
+                audioTypeOptions.getString("audioFocusMode")?.let { focusModeString ->
+                    val focusMode = AudioManagerUtils.focusModeFromString(focusModeString)
+                    if (focusMode != null) {
+                        audioManager.setFocusMode(focusMode)
+                    }
+                }
+            }
+
+            if (audioTypeOptions.hasKey("audioStreamType")) {
+                audioTypeOptions.getString("audioStreamType")?.let { streamTypeString ->
+                    val streamType = AudioManagerUtils.audioStreamTypeFromString(streamTypeString)
+                    if (streamType != null) {
+                        audioManager.setAudioStreamType(streamType)
+                    }
+                }
+            }
+
+            if (audioTypeOptions.hasKey("audioAttributesUsageType")) {
+                audioTypeOptions.getString("audioAttributesUsageType")?.let { usageTypeString ->
+                    val usageType = AudioManagerUtils.audioAttributesUsageTypeFromString(usageTypeString)
+                    if (usageType != null) {
+                        audioManager.setAudioAttributesUsageType(usageType)
+                    }
+                }
+            }
+
+            if (audioTypeOptions.hasKey("audioAttributesContentType")) {
+                audioTypeOptions.getString("audioAttributesContentType")?.let { contentTypeString ->
+                    val contentType = AudioManagerUtils.audioAttributesContentTypeFromString(contentTypeString)
+                    if (contentType != null) {
+                        audioManager.setAudioAttributesContentType(contentType)
+                    }
+                }
+            }
+
+            if (audioTypeOptions.hasKey("forceHandleAudioRouting")) {
+                val force = audioTypeOptions.getBoolean("forceHandleAudioRouting")
+                audioManager.setForceHandleAudioRouting(force)
             }
         }
     }

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

@@ -1,5 +1,6 @@
 package com.livekit.reactnative.audio
 
+import android.media.AudioAttributes
 import android.media.AudioManager
 import android.util.Log
 
@@ -41,4 +42,75 @@ object AudioManagerUtils {
 
         return focusMode
     }
+
+    fun audioAttributesUsageTypeFromString(usageTypeString: String?): Int? {
+        if (usageTypeString == null) {
+            return null
+        }
+
+        val usageType: Int? = when (usageTypeString) {
+            "alarm" -> AudioAttributes.USAGE_ALARM
+            "assistanceAccessibility" -> AudioAttributes.USAGE_ASSISTANCE_ACCESSIBILITY
+            "assistanceNavigationGuidance" -> AudioAttributes.USAGE_ASSISTANCE_NAVIGATION_GUIDANCE
+            "assistanceSonification" -> AudioAttributes.USAGE_ASSISTANCE_SONIFICATION
+            "assistant" -> AudioAttributes.USAGE_ASSISTANT
+            "game" -> AudioAttributes.USAGE_GAME
+            "media" -> AudioAttributes.USAGE_MEDIA
+            "notification" -> AudioAttributes.USAGE_NOTIFICATION
+            "notificationEvent" -> AudioAttributes.USAGE_NOTIFICATION_EVENT
+            "notificationRingtone" -> AudioAttributes.USAGE_NOTIFICATION_RINGTONE
+            "unknown" -> AudioAttributes.USAGE_UNKNOWN
+            "voiceCommunication" -> AudioAttributes.USAGE_VOICE_COMMUNICATION
+            "voiceCommunicationSignalling" -> AudioAttributes.USAGE_VOICE_COMMUNICATION_SIGNALLING
+            else -> {
+                Log.w(TAG, "Unknown audio attributes usage type: $usageTypeString")
+                null
+            }
+        }
+
+        return usageType
+    }
+
+    fun audioAttributesContentTypeFromString(contentTypeString: String?): Int? {
+        if (contentTypeString == null) {
+            return null
+        }
+
+        val contentType = when (contentTypeString) {
+            "movie" -> AudioAttributes.CONTENT_TYPE_MOVIE
+            "music" -> AudioAttributes.CONTENT_TYPE_MUSIC
+            "sonification" -> AudioAttributes.CONTENT_TYPE_SONIFICATION
+            "speech" -> AudioAttributes.CONTENT_TYPE_SPEECH
+            "unknown" -> AudioAttributes.CONTENT_TYPE_UNKNOWN
+            else -> {
+                Log.w(TAG, "Unknown audio attributes content type: $contentTypeString")
+                null
+            }
+        }
+
+        return contentType
+    }
+
+    fun audioStreamTypeFromString(streamTypeString: String?): Int? {
+        if (streamTypeString == null) {
+            return null
+        }
+
+        val streamType = when (streamTypeString) {
+            "accessibility" -> AudioManager.STREAM_ACCESSIBILITY
+            "alarm" -> AudioManager.STREAM_ALARM
+            "dtmf" -> AudioManager.STREAM_DTMF
+            "music" -> AudioManager.STREAM_MUSIC
+            "notification" -> AudioManager.STREAM_NOTIFICATION
+            "ring" -> AudioManager.STREAM_RING
+            "system" -> AudioManager.STREAM_SYSTEM
+            "voiceCall" -> AudioManager.STREAM_VOICE_CALL
+            else -> {
+                Log.w(TAG, "Unknown audio stream type: $streamTypeString")
+                null
+            }
+        }
+
+        return streamType
+    }
 }

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

@@ -1,6 +1,7 @@
 package com.livekit.reactnative.audio;
 
 import android.content.Context;
+import android.media.AudioAttributes;
 import android.media.AudioManager;
 import android.os.Handler;
 import android.os.Looper;
@@ -14,6 +15,7 @@ import com.twilio.audioswitch.AudioSwitch;
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
+import java.util.Objects;
 
 import kotlin.Unit;
 import kotlin.jvm.functions.Function2;
@@ -32,7 +34,8 @@ public class AudioSwitchManager {
             Unit> audioDeviceChangeListener = (devices, currentDevice) -> null;
 
     @NonNull
-    public AudioManager.OnAudioFocusChangeListener audioFocusChangeListener = (i -> {});
+    public AudioManager.OnAudioFocusChangeListener audioFocusChangeListener = (i -> {
+    });
 
     @NonNull
     public List<Class<? extends AudioDevice>> preferredDeviceList;
@@ -43,6 +46,13 @@ public class AudioSwitchManager {
     @Nullable
     private AudioSwitch audioSwitch;
 
+    /**
+     * When true, AudioSwitchHandler will request audio focus on start and abandon on stop.
+     *
+     * Defaults to true.
+     */
+    private boolean manageAudioFocus = true;
+
     /**
      * The audio focus mode to use while started.
      *
@@ -53,9 +63,55 @@ public class AudioSwitchManager {
     /**
      * The audio mode to use while started.
      *
-     * Defaults to [AudioManager.MODE_NORMAL].
+     * Defaults to AudioManager.MODE_IN_COMMUNICATION.
+     */
+    private int audioMode = AudioManager.MODE_IN_COMMUNICATION;
+
+    /**
+     * The audio stream type to use when requesting audio focus on pre-O devices.
+     *
+     * Defaults to [AudioManager.STREAM_VOICE_CALL].
+     *
+     * Refer to this [compatibility table](https://source.android.com/docs/core/audio/attributes#compatibility)
+     * to ensure that your values match between android versions.
+     *
+     * Note: Manual audio routing may not work appropriately when using non-default values.
      */
-    private int audioMode = AudioManager.MODE_NORMAL;
+    private int audioStreamType = AudioManager.STREAM_VOICE_CALL;
+
+    /**
+     * The audio attribute usage type to use when requesting audio focus on devices O and beyond.
+     *
+     * Defaults to [AudioAttributes.USAGE_VOICE_COMMUNICATION].
+     *
+     * Refer to this [compatibility table](https://source.android.com/docs/core/audio/attributes#compatibility)
+     * to ensure that your values match between android versions.
+     *
+     * Note: Manual audio routing may not work appropriately when using non-default values.
+     */
+    private int audioAttributeUsageType = AudioAttributes.USAGE_VOICE_COMMUNICATION;
+
+    /**
+     * The audio attribute content type to use when requesting audio focus on devices O and beyond.
+     *
+     * Defaults to [AudioAttributes.CONTENT_TYPE_SPEECH].
+     *
+     * Refer to this [compatibility table](https://source.android.com/docs/core/audio/attributes#compatibility)
+     * to ensure that your values match between android versions.
+     *
+     * Note: Manual audio routing may not work appropriately when using non-default values.
+     */
+    private int audioAttributeContentType = AudioAttributes.CONTENT_TYPE_SPEECH;
+
+    /**
+     * On certain Android devices, audio routing does not function properly and bluetooth microphones will not work
+     * unless audio mode is set to [AudioManager.MODE_IN_COMMUNICATION] or [AudioManager.MODE_IN_CALL].
+     *
+     * AudioSwitchManager by default will not handle audio routing in those cases to avoid audio issues.
+     *
+     * If this set to true, AudioSwitchManager will attempt to do audio routing, though behavior is undefined.
+     */
+    private boolean forceHandleAudioRouting = false;
 
     public AudioSwitchManager(@NonNull Context context) {
         this.context = context;
@@ -78,8 +134,13 @@ public class AudioSwitchManager {
                         audioFocusChangeListener,
                         preferredDeviceList
                 );
+                audioSwitch.setManageAudioFocus(manageAudioFocus);
                 audioSwitch.setFocusMode(focusMode);
                 audioSwitch.setAudioMode(audioMode);
+                audioSwitch.setAudioStreamType(audioStreamType);
+                audioSwitch.setAudioAttributeContentType(audioAttributeContentType);
+                audioSwitch.setAudioAttributeUsageType(audioAttributeUsageType);
+                audioSwitch.setForceHandleAudioRouting(forceHandleAudioRouting);
                 audioSwitch.start(audioDeviceChangeListener);
                 audioSwitch.activate();
             });
@@ -96,7 +157,7 @@ public class AudioSwitchManager {
         });
     }
 
-    public void setMicrophoneMute(boolean mute){
+    public void setMicrophoneMute(boolean mute) {
         audioManager.setMicrophoneMute(mute);
     }
 
@@ -141,24 +202,65 @@ public class AudioSwitchManager {
     }
 
     public void enableSpeakerphone(boolean enable) {
-        if(enable) {
+        if (enable) {
             audioManager.setSpeakerphoneOn(true);
         } else {
             audioManager.setSpeakerphoneOn(false);
         }
     }
-    
+
     public void selectAudioOutput(@Nullable AudioDeviceKind kind) {
         if (kind != null) {
             selectAudioOutput(kind.audioDeviceClass);
         }
     }
 
+    public void setManageAudioFocus(boolean manage) {
+        this.manageAudioFocus = manage;
+        if (audioSwitch != null) {
+            Objects.requireNonNull(audioSwitch).setManageAudioFocus(this.manageAudioFocus);
+        }
+    }
+
     public void setFocusMode(int focusMode) {
         this.focusMode = focusMode;
+        if (audioSwitch != null) {
+            Objects.requireNonNull(audioSwitch).setFocusMode(this.focusMode);
+        }
     }
 
     public void setAudioMode(int audioMode) {
         this.audioMode = audioMode;
+        if (audioSwitch != null) {
+            Objects.requireNonNull(audioSwitch).setAudioMode(this.audioMode);
+        }
+    }
+
+    public void setAudioStreamType(int streamType) {
+        this.audioStreamType = streamType;
+        if (audioSwitch != null) {
+            Objects.requireNonNull(audioSwitch).setAudioStreamType(this.audioStreamType);
+        }
+    }
+
+    public void setAudioAttributesUsageType(int usageType) {
+        this.audioAttributeUsageType = usageType;
+        if (audioSwitch != null) {
+            Objects.requireNonNull(audioSwitch).setAudioAttributeUsageType(this.audioAttributeUsageType);
+        }
+    }
+
+    public void setAudioAttributesContentType(int contentType) {
+        this.audioAttributeContentType = contentType;
+        if (audioSwitch != null) {
+            Objects.requireNonNull(audioSwitch).setAudioAttributeContentType(this.audioAttributeContentType);
+        }
+    }
+
+    public void setForceHandleAudioRouting(boolean force) {
+        this.forceHandleAudioRouting = force;
+        if (audioSwitch != null) {
+            Objects.requireNonNull(audioSwitch).setForceHandleAudioRouting(this.forceHandleAudioRouting);
+        }
     }
 }

package/android/src/main/java/com/livekit/reactnative/audio/AudioType.kt

@@ -0,0 +1,46 @@
+package com.livekit.reactnative.audio
+
+import android.media.AudioAttributes
+import android.media.AudioManager
+
+sealed class AudioType(
+    val audioMode: Int, 
+    val audioAttributes: AudioAttributes, 
+    val audioStreamType: Int
+) {
+    /**
+     * An audio type for general media playback usage (i.e. listener-only use cases).
+     *
+     * Audio routing is handled automatically by the system in normal media mode,
+     * and bluetooth microphones may not work on some devices.
+     */
+    class MediaAudioType : AudioType(
+        AudioManager.MODE_NORMAL,
+        AudioAttributes.Builder()
+            .setUsage(AudioAttributes.USAGE_MEDIA)
+            .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH)
+            .build(),
+        AudioManager.STREAM_MUSIC
+    )
+
+    /**
+     * An audio type for communications (i.e. participating a call or otherwise
+     * publishing local microphone).
+     *
+     * Audio routing can be manually controlled.
+     */
+    class CommunicationAudioType : AudioType(
+        AudioManager.MODE_IN_COMMUNICATION,
+        AudioAttributes.Builder()
+            .setUsage(AudioAttributes.USAGE_VOICE_COMMUNICATION)
+            .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH)
+            .build(),
+        AudioManager.STREAM_VOICE_CALL
+    )
+
+    /**
+     * An audio type that takes in a user-defined [AudioAttributes] and audio stream type.
+     */
+    class CustomAudioType(audioMode: Int, audioAttributes: AudioAttributes, audioStreamType: Int) :
+        AudioType(audioMode, audioAttributes, audioStreamType)
+}

package/lib/commonjs/audio/AudioSession.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = void 0;
+exports.default = exports.AndroidAudioTypePresets = void 0;
 
 var _reactNative = require("react-native");
 
@@ -29,17 +29,15 @@ const LivekitReactNative = _reactNative.NativeModules.LivekitReactNative ? _reac
  *   This is ignored when an output is manually selected with {@link AudioSession.selectAudioOutput}.
  *
  *   By default, the order is set to:
- *   1. `"speaker"`
- *   2. `"earpiece"`
- *   3. `"headset"`
- *   4. `"bluetooth"`
+ *   1. `"bluetooth"
+ *   2. `"headset"``
+ *   3. `"speaker"`
+ *   4. `"earpiece"`
  *
- * * audioMode - The audio mode to use for the audio session. Defaults to 'normal'.
+ * * audioTypeOptions - An {@link AndroidAudioTypeOptions} object which provides the
+ *   audio options to use on Android.
  *
- * * audioFocusMode - The focus mode to use for the audio session. Defaults to 'gain'.
- *
- *  See [AudioManager](https://developer.android.com/reference/android/media/AudioManager) for details
- *  on audio and focus modes.
+ *   See {@link AndroidAudioTypePresets} for pre-configured values.
  *
  * ----
  * iOS
@@ -49,6 +47,26 @@ const LivekitReactNative = _reactNative.NativeModules.LivekitReactNative ? _reac
  *   By default, this is set to `"speaker"`
  */
 
+const AndroidAudioTypePresets = {
+  communication: {
+    manageAudioFocus: true,
+    audioMode: 'inCommunication',
+    audioFocusMode: 'gain',
+    audioStreamType: 'voiceCall',
+    audioAttributesUsageType: 'voiceCommunication',
+    audioAttributesContentType: 'speech'
+  },
+  media: {
+    manageAudioFocus: true,
+    audioMode: 'normal',
+    audioFocusMode: 'gain',
+    audioStreamType: 'music',
+    audioAttributesUsageType: 'media',
+    audioAttributesContentType: 'unknown'
+  }
+};
+exports.AndroidAudioTypePresets = AndroidAudioTypePresets;
+
 class AudioSession {}
 
 exports.default = AudioSession;

package/lib/commonjs/audio/AudioSession.js.map

@@ -1 +1 @@
-{"version":3,"sources":["AudioSession.ts"],"names":["LINKING_ERROR","Platform","select","ios","default","LivekitReactNative","NativeModules","Proxy","get","Error","AudioSession","config","configureAudio","startAudioSession","stopAudioSession","OS","getAudioOutputs","deviceId","selectAudioOutput","showAudioRoutePicker"],"mappings":";;;;;;;AAAA;;;;AACA,MAAMA,aAAa,GAChB,gFAAD,GACAC,sBAASC,MAAT,CAAgB;AAAEC,EAAAA,GAAG,EAAE,gCAAP;AAAyCC,EAAAA,OAAO,EAAE;AAAlD,CAAhB,CADA,GAEA,sDAFA,GAGA,6CAJF;AAMA,MAAMC,kBAAkB,GAAGC,2BAAcD,kBAAd,GACvBC,2BAAcD,kBADS,GAEvB,IAAIE,KAAJ,CACE,EADF,EAEE;AACEC,EAAAA,GAAG,GAAG;AACJ,UAAM,IAAIC,KAAJ,CAAUT,aAAV,CAAN;AACD;;AAHH,CAFF,CAFJ;AAWA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAqBe,MAAMU,YAAN,CAAmB;;;;gBAAbA,Y,oBAMK,MAAOC,MAAP,IAAsC;AAC5D,QAAMN,kBAAkB,CAACO,cAAnB,CAAkCD,MAAlC,CAAN;AACD,C;;gBARkBD,Y,uBAaQ,YAAY;AACrC,QAAML,kBAAkB,CAACQ,iBAAnB,EAAN;AACD,C;;gBAfkBH,Y,sBAoBO,YAAY;AACpC,QAAML,kBAAkB,CAACS,gBAAnB,EAAN;AACD,C;;gBAtBkBJ,Y,qBAmDM,YAA+B;AACtD,MAAIT,sBAASc,EAAT,KAAgB,KAApB,EAA2B;AACzB,WAAO,CAAC,SAAD,EAAY,eAAZ,CAAP;AACD,GAFD,MAEO,IAAId,sBAASc,EAAT,KAAgB,SAApB,EAA+B;AACpC,WAAQ,MAAMV,kBAAkB,CAACW,eAAnB,EAAd;AACD,GAFM,MAEA;AACL,WAAO,EAAP;AACD;AACF,C;;gBA3DkBN,Y,uBAoEQ,MAAOO,QAAP,IAA4B;AACrD,QAAMZ,kBAAkB,CAACa,iBAAnB,CAAqCD,QAArC,CAAN;AACD,C;;gBAtEkBP,Y,0BA6EW,YAAY;AACxC,MAAIT,sBAASc,EAAT,KAAgB,KAApB,EAA2B;AACzB,UAAMV,kBAAkB,CAACc,oBAAnB,EAAN;AACD;AACF,C","sourcesContent":["import { NativeModules, Platform } from 'react-native';\nconst LINKING_ERROR =\n  `The package '@livekit/react-native' doesn't seem to be linked. Make sure: \\n\\n` +\n  Platform.select({ ios: \"- You have run 'pod install'\\n\", default: '' }) +\n  '- You rebuilt the app after installing the package\\n' +\n  '- You are not using Expo managed workflow\\n';\n\nconst LivekitReactNative = NativeModules.LivekitReactNative\n  ? NativeModules.LivekitReactNative\n  : new Proxy(\n      {},\n      {\n        get() {\n          throw new Error(LINKING_ERROR);\n        },\n      }\n    );\n\n/**\n * Configuration for the underlying AudioSession.\n *\n * ----\n * Android specific options:\n *\n * * preferredOutputList - The preferred order in which to automatically select an audio output.\n *   This is ignored when an output is manually selected with {@link AudioSession.selectAudioOutput}.\n *\n *   By default, the order is set to:\n *   1. `\"speaker\"`\n *   2. `\"earpiece\"`\n *   3. `\"headset\"`\n *   4. `\"bluetooth\"`\n *\n * * audioMode - The audio mode to use for the audio session. Defaults to 'normal'.\n *\n * * audioFocusMode - The focus mode to use for the audio session. Defaults to 'gain'.\n *\n *  See [AudioManager](https://developer.android.com/reference/android/media/AudioManager) for details\n *  on audio and focus modes.\n *\n * ----\n * iOS\n *\n * * defaultOutput - The default preferred output to use when a wired headset or bluetooth output is unavailable.\n *\n *   By default, this is set to `\"speaker\"`\n */\nexport type AudioConfiguration = {\n  android?: {\n    preferredOutputList?: ('speaker' | 'earpiece' | 'headset' | 'bluetooth')[];\n    audioMode?:\n      | 'normal'\n      | 'callScreening'\n      | 'inCall'\n      | 'inCommunication'\n      | 'ringtone';\n    audioFocusMode?:\n      | 'gain'\n      | 'gainTransient'\n      | 'gainTransientExclusive'\n      | 'gainTransientMayDuck';\n  };\n  ios?: {\n    defaultOutput?: 'speaker' | 'earpiece';\n  };\n};\n\nexport default class AudioSession {\n  /**\n   * Applies the provided audio configuration to the underlying AudioSession.\n   *\n   * Must be called prior to connecting to a Room for the configuration to apply correctly.\n   */\n  static configureAudio = async (config: AudioConfiguration) => {\n    await LivekitReactNative.configureAudio(config);\n  };\n\n  /**\n   * Starts an AudioSession.\n   */\n  static startAudioSession = async () => {\n    await LivekitReactNative.startAudioSession();\n  };\n\n  /**\n   * Stops the existing AudioSession.\n   */\n  static stopAudioSession = async () => {\n    await LivekitReactNative.stopAudioSession();\n  };\n\n  /**\n   * Gets the available audio outputs for use with {@link selectAudioOutput}.\n   *\n   * {@link startAudioSession} must be called prior to using this method.\n   *\n   * For Android, will return if available:\n   * * \"speaker\"\n   * * \"earpiece\"\n   * * \"headset\"\n   * * \"bluetooth\"\n   *\n   * Note: For applications targeting SDK versions over 30, the runtime BLUETOOTH_CONNECT\n   * permission must be requested to send audio to bluetooth headsets.\n   *\n   * ----\n   *\n   * For iOS, due to OS limitations, the only available types are:\n   * * \"default\" - Use default iOS audio routing\n   * * \"force_speaker\" - Force audio output through speaker\n   *\n   * See also {@link showAudioRoutePicker} to display a route picker that\n   * can choose between other audio devices (i.e. headset/bluetooth/airplay),\n   * or use a library like `react-native-avroutepicker` for a native platform\n   * control.\n   *\n   * @returns the available audio output types\n   */\n  static getAudioOutputs = async (): Promise<string[]> => {\n    if (Platform.OS === 'ios') {\n      return ['default', 'force_speaker'];\n    } else if (Platform.OS === 'android') {\n      return (await LivekitReactNative.getAudioOutputs()) as string[];\n    } else {\n      return [];\n    }\n  };\n\n  /**\n   * Select the provided audio output if available.\n   *\n   * {@link startAudioSession} must be called prior to using this method.\n   *\n   * @param deviceId A deviceId retrieved from {@link getAudioOutputs}\n   */\n  static selectAudioOutput = async (deviceId: string) => {\n    await LivekitReactNative.selectAudioOutput(deviceId);\n  };\n\n  /**\n   * iOS only, requires iOS 11+.\n   *\n   * Displays an AVRoutePickerView for the user to choose their audio output.\n   */\n  static showAudioRoutePicker = async () => {\n    if (Platform.OS === 'ios') {\n      await LivekitReactNative.showAudioRoutePicker();\n    }\n  };\n}\n"]}
+{"version":3,"sources":["AudioSession.ts"],"names":["LINKING_ERROR","Platform","select","ios","default","LivekitReactNative","NativeModules","Proxy","get","Error","AndroidAudioTypePresets","communication","manageAudioFocus","audioMode","audioFocusMode","audioStreamType","audioAttributesUsageType","audioAttributesContentType","media","AudioSession","config","configureAudio","startAudioSession","stopAudioSession","OS","getAudioOutputs","deviceId","selectAudioOutput","showAudioRoutePicker"],"mappings":";;;;;;;AAAA;;;;AACA,MAAMA,aAAa,GAChB,gFAAD,GACAC,sBAASC,MAAT,CAAgB;AAAEC,EAAAA,GAAG,EAAE,gCAAP;AAAyCC,EAAAA,OAAO,EAAE;AAAlD,CAAhB,CADA,GAEA,sDAFA,GAGA,6CAJF;AAMA,MAAMC,kBAAkB,GAAGC,2BAAcD,kBAAd,GACvBC,2BAAcD,kBADS,GAEvB,IAAIE,KAAJ,CACE,EADF,EAEE;AACEC,EAAAA,GAAG,GAAG;AACJ,UAAM,IAAIC,KAAJ,CAAUT,aAAV,CAAN;AACD;;AAHH,CAFF,CAFJ;AAWA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA6GO,MAAMU,uBASZ,GAAG;AACFC,EAAAA,aAAa,EAAE;AACbC,IAAAA,gBAAgB,EAAE,IADL;AAEbC,IAAAA,SAAS,EAAE,iBAFE;AAGbC,IAAAA,cAAc,EAAE,MAHH;AAIbC,IAAAA,eAAe,EAAE,WAJJ;AAKbC,IAAAA,wBAAwB,EAAE,oBALb;AAMbC,IAAAA,0BAA0B,EAAE;AANf,GADb;AASFC,EAAAA,KAAK,EAAE;AACLN,IAAAA,gBAAgB,EAAE,IADb;AAELC,IAAAA,SAAS,EAAE,QAFN;AAGLC,IAAAA,cAAc,EAAE,MAHX;AAILC,IAAAA,eAAe,EAAE,OAJZ;AAKLC,IAAAA,wBAAwB,EAAE,OALrB;AAMLC,IAAAA,0BAA0B,EAAE;AANvB;AATL,CATG;;;AA4BQ,MAAME,YAAN,CAAmB;;;;gBAAbA,Y,oBAMK,MAAOC,MAAP,IAAsC;AAC5D,QAAMf,kBAAkB,CAACgB,cAAnB,CAAkCD,MAAlC,CAAN;AACD,C;;gBARkBD,Y,uBAaQ,YAAY;AACrC,QAAMd,kBAAkB,CAACiB,iBAAnB,EAAN;AACD,C;;gBAfkBH,Y,sBAoBO,YAAY;AACpC,QAAMd,kBAAkB,CAACkB,gBAAnB,EAAN;AACD,C;;gBAtBkBJ,Y,qBAgDM,YAA+B;AACtD,MAAIlB,sBAASuB,EAAT,KAAgB,KAApB,EAA2B;AACzB,WAAO,CAAC,SAAD,EAAY,eAAZ,CAAP;AACD,GAFD,MAEO,IAAIvB,sBAASuB,EAAT,KAAgB,SAApB,EAA+B;AACpC,WAAQ,MAAMnB,kBAAkB,CAACoB,eAAnB,EAAd;AACD,GAFM,MAEA;AACL,WAAO,EAAP;AACD;AACF,C;;gBAxDkBN,Y,uBAiEQ,MAAOO,QAAP,IAA4B;AACrD,QAAMrB,kBAAkB,CAACsB,iBAAnB,CAAqCD,QAArC,CAAN;AACD,C;;gBAnEkBP,Y,0BA0EW,YAAY;AACxC,MAAIlB,sBAASuB,EAAT,KAAgB,KAApB,EAA2B;AACzB,UAAMnB,kBAAkB,CAACuB,oBAAnB,EAAN;AACD;AACF,C","sourcesContent":["import { NativeModules, Platform } from 'react-native';\nconst LINKING_ERROR =\n  `The package '@livekit/react-native' doesn't seem to be linked. Make sure: \\n\\n` +\n  Platform.select({ ios: \"- You have run 'pod install'\\n\", default: '' }) +\n  '- You rebuilt the app after installing the package\\n' +\n  '- You are not using Expo managed workflow\\n';\n\nconst LivekitReactNative = NativeModules.LivekitReactNative\n  ? NativeModules.LivekitReactNative\n  : new Proxy(\n      {},\n      {\n        get() {\n          throw new Error(LINKING_ERROR);\n        },\n      }\n    );\n\n/**\n * Configuration for the underlying AudioSession.\n *\n * ----\n * Android specific options:\n *\n * * preferredOutputList - The preferred order in which to automatically select an audio output.\n *   This is ignored when an output is manually selected with {@link AudioSession.selectAudioOutput}.\n *\n *   By default, the order is set to:\n *   1. `\"bluetooth\"\n *   2. `\"headset\"``\n *   3. `\"speaker\"`\n *   4. `\"earpiece\"`\n *\n * * audioTypeOptions - An {@link AndroidAudioTypeOptions} object which provides the\n *   audio options to use on Android.\n *\n *   See {@link AndroidAudioTypePresets} for pre-configured values.\n *\n * ----\n * iOS\n *\n * * defaultOutput - The default preferred output to use when a wired headset or bluetooth output is unavailable.\n *\n *   By default, this is set to `\"speaker\"`\n */\nexport type AudioConfiguration = {\n  android?: {\n    preferredOutputList?: ('speaker' | 'earpiece' | 'headset' | 'bluetooth')[];\n    audioTypeOptions: AndroidAudioTypeOptions;\n  };\n  ios?: {\n    defaultOutput?: 'speaker' | 'earpiece';\n  };\n};\n\nexport type AndroidAudioTypeOptions = {\n  /**\n   * Whether LiveKit should handle managing the audio focus or not.\n   *\n   * Defaults to true.\n   */\n  manageAudioFocus?: boolean;\n\n  /**\n   * Corresponds to {@link https://developer.android.com/reference/android/media/AudioManager#setMode(int)}\n   *\n   * Defaults to 'inCommunication'.\n   */\n  audioMode?:\n    | 'normal'\n    | 'callScreening'\n    | 'inCall'\n    | 'inCommunication'\n    | 'ringtone';\n\n  /**\n   * Corresponds to the duration hint when requesting audio focus.\n   *\n   * Defaults to 'gain'.\n   *\n   * See also {@link https://developer.android.com/reference/android/media/AudioManager#AUDIOFOCUS_GAIN}\n   */\n  audioFocusMode?:\n    | 'gain'\n    | 'gainTransient'\n    | 'gainTransientExclusive'\n    | 'gainTransientMayDuck';\n\n  /**\n   * Corresponds to Android's AudioAttributes usage type.\n   *\n   * Defaults to 'voiceCommunication'.\n   *\n   * See also {@link https://developer.android.com/reference/android/media/AudioAttributes}\n   */\n  audioAttributesUsageType?:\n    | 'alarm'\n    | 'assistanceAccessibility'\n    | 'assistanceNavigationGuidance'\n    | 'assistanceSonification'\n    | 'assistant'\n    | 'game'\n    | 'media'\n    | 'notification'\n    | 'notificationEvent'\n    | 'notificationRingtone'\n    | 'unknown'\n    | 'voiceCommunication'\n    | 'voiceCommunicationSignalling';\n\n  /**\n   * Corresponds to Android's AndroidAttributes content type.\n   *\n   * Defaults to 'speech'.\n   *\n   * See also {@link https://developer.android.com/reference/android/media/AudioAttributes}\n   */\n  audioAttributesContentType?:\n    | 'movie'\n    | 'music'\n    | 'sonification'\n    | 'speech'\n    | 'unknown';\n\n  /**\n   * Corresponds to the stream type when requesting audio focus. Used on pre-O devices.\n   *\n   * Defaults to 'voiceCall'\n   *\n   * See also {@link https://developer.android.com/reference/android/media/AudioManager#STREAM_VOICE_CALL}\n   */\n  audioStreamType?:\n    | 'accessibility'\n    | 'alarm'\n    | 'dtmf'\n    | 'music'\n    | 'notification'\n    | 'ring'\n    | 'system'\n    | 'voiceCall';\n\n  /**\n   * On certain Android devices, audio routing does not function properly and\n   * bluetooth microphones will not work unless audio mode is set to\n   * `inCommunication` or `inCall`. Audio routing is turned off those cases.\n   *\n   * If this set to true, will attempt to do audio routing regardless of audio mode.\n   *\n   * Defaults to false.\n   */\n  forceHandleAudioRouting?: boolean;\n};\n\nexport const AndroidAudioTypePresets: {\n  /**\n   * A pre-configured AndroidAudioConfiguration for voice communication.\n   */\n  communication: AndroidAudioTypeOptions;\n  /**\n   * A pre-configured AndroidAudioConfiguration for media playback.\n   */\n  media: AndroidAudioTypeOptions;\n} = {\n  communication: {\n    manageAudioFocus: true,\n    audioMode: 'inCommunication',\n    audioFocusMode: 'gain',\n    audioStreamType: 'voiceCall',\n    audioAttributesUsageType: 'voiceCommunication',\n    audioAttributesContentType: 'speech',\n  },\n  media: {\n    manageAudioFocus: true,\n    audioMode: 'normal',\n    audioFocusMode: 'gain',\n    audioStreamType: 'music',\n    audioAttributesUsageType: 'media',\n    audioAttributesContentType: 'unknown',\n  },\n} as const;\n\nexport default class AudioSession {\n  /**\n   * Applies the provided audio configuration to the underlying AudioSession.\n   *\n   * Must be called prior to connecting to a Room for the configuration to apply correctly.\n   */\n  static configureAudio = async (config: AudioConfiguration) => {\n    await LivekitReactNative.configureAudio(config);\n  };\n\n  /**\n   * Starts an AudioSession.\n   */\n  static startAudioSession = async () => {\n    await LivekitReactNative.startAudioSession();\n  };\n\n  /**\n   * Stops the existing AudioSession.\n   */\n  static stopAudioSession = async () => {\n    await LivekitReactNative.stopAudioSession();\n  };\n\n  /**\n   * Gets the available audio outputs for use with {@link selectAudioOutput}.\n   *\n   * {@link startAudioSession} must be called prior to using this method.\n   *\n   * For Android, will return if available:\n   * * \"speaker\"\n   * * \"earpiece\"\n   * * \"headset\"\n   * * \"bluetooth\"\n   *\n   * ----\n   *\n   * For iOS, due to OS limitations, the only available types are:\n   * * \"default\" - Use default iOS audio routing\n   * * \"force_speaker\" - Force audio output through speaker\n   *\n   * See also {@link showAudioRoutePicker} to display a route picker that\n   * can choose between other audio devices (i.e. headset/bluetooth/airplay),\n   * or use a library like `react-native-avroutepicker` for a native platform\n   * control.\n   *\n   * @returns the available audio output types\n   */\n  static getAudioOutputs = async (): Promise<string[]> => {\n    if (Platform.OS === 'ios') {\n      return ['default', 'force_speaker'];\n    } else if (Platform.OS === 'android') {\n      return (await LivekitReactNative.getAudioOutputs()) as string[];\n    } else {\n      return [];\n    }\n  };\n\n  /**\n   * Select the provided audio output if available.\n   *\n   * {@link startAudioSession} must be called prior to using this method.\n   *\n   * @param deviceId A deviceId retrieved from {@link getAudioOutputs}\n   */\n  static selectAudioOutput = async (deviceId: string) => {\n    await LivekitReactNative.selectAudioOutput(deviceId);\n  };\n\n  /**\n   * iOS only, requires iOS 11+.\n   *\n   * Displays an AVRoutePickerView for the user to choose their audio output.\n   */\n  static showAudioRoutePicker = async () => {\n    if (Platform.OS === 'ios') {\n      await LivekitReactNative.showAudioRoutePicker();\n    }\n  };\n}\n"]}

package/lib/commonjs/index.js

@@ -5,8 +5,22 @@ Object.defineProperty(exports, "__esModule", {
 });
 var _exportNames = {
   registerGlobals: true,
-  AudioSession: true
+  AudioSession: true,
+  AndroidAudioTypePresets: true,
+  AndroidAudioTypeOptions: true
 };
+Object.defineProperty(exports, "AndroidAudioTypeOptions", {
+  enumerable: true,
+  get: function () {
+    return _AudioSession.AndroidAudioTypeOptions;
+  }
+});
+Object.defineProperty(exports, "AndroidAudioTypePresets", {
+  enumerable: true,
+  get: function () {
+    return _AudioSession.AndroidAudioTypePresets;
+  }
+});
 Object.defineProperty(exports, "AudioSession", {
   enumerable: true,
   get: function () {
@@ -19,7 +33,9 @@ var _reactNativeWebrtc = require("@livekit/react-native-webrtc");
 
 var _reactNativeUrlPolyfill = require("react-native-url-polyfill");
 
-var _AudioSession = _interopRequireDefault(require("./audio/AudioSession"));
+require("fastestsmallesttextencoderdecoder");
+
+var _AudioSession = _interopRequireWildcard(require("./audio/AudioSession"));
 
 var _reactNative = require("react-native");
 
@@ -65,7 +81,9 @@ Object.keys(_useRoom).forEach(function (key) {
   });
 });
 
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 
 /**
  * Registers the required globals needed for LiveKit to work.
@@ -79,6 +97,8 @@ function registerGlobals() {
   fixWebrtcAdapter();
   shimPromiseAllSettled();
   shimArrayAt();
+  shimAsyncIterator();
+  shimIterator();
 }
 
 function livekitRegisterGlobals() {
@@ -122,4 +142,16 @@ function shimArrayAt() {
     at.shim();
   }
 }
+
+function shimAsyncIterator() {
+  var shim = require('well-known-symbols/Symbol.asyncIterator/shim');
+
+  shim();
+}
+
+function shimIterator() {
+  var shim = require('well-known-symbols/Symbol.iterator/shim');
+
+  shim();
+}
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["index.tsx"],"names":["registerGlobals","livekitRegisterGlobals","fixWebrtcAdapter","shimPromiseAllSettled","shimArrayAt","lkGlobal","platform","Platform","OS","devicePixelRatio","PixelRatio","get","global","LiveKitReactNativeGlobal","window","navigator","undefined","userAgent","product","allSettled","require","shim","Array","prototype","at"],"mappings":";;;;;;;;;;;;;;;;;AAAA;;AACA;;AACA;;AAEA;;AAkDA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AACA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AACA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;;AAjDA;AACA;AACA;AACA;AACA;AACO,SAASA,eAAT,GAA2B;AAChC;AACAC,EAAAA,sBAAsB;AACtB;AACAC,EAAAA,gBAAgB;AAChBC,EAAAA,qBAAqB;AACrBC,EAAAA,WAAW;AACZ;;AACD,SAASH,sBAAT,GAAkC;AAChC,MAAII,QAAgC,GAAG;AACrCC,IAAAA,QAAQ,EAAEC,sBAASC,EADkB;AAErCC,IAAAA,gBAAgB,EAAEC,wBAAWC,GAAX;AAFmB,GAAvC,CADgC,CAMhC;;AACAC,EAAAA,MAAM,CAACC,wBAAP,GAAkCR,QAAlC;AACD;;AAED,SAASH,gBAAT,GAA4B;AAAA;;AAC1B;AACA,MAAI,YAAAY,MAAM,UAAN,0CAAQC,SAAR,MAAsBC,SAA1B,EAAqC;AACnC;AACA,UAAM;AAAED,MAAAA;AAAF,QAAgBD,MAAtB;;AACA,QAAIC,SAAS,CAACE,SAAV,KAAwBD,SAA5B,EAAuC;AAAA;;AACrCD,MAAAA,SAAS,CAACE,SAAV,yBAAsBF,SAAS,CAACG,OAAhC,mEAA2C,SAA3C;AACD;AACF;AACF;;AAED,SAASf,qBAAT,GAAiC;AAC/B,MAAIgB,UAAU,GAAGC,OAAO,CAAC,oBAAD,CAAxB;;AACAD,EAAAA,UAAU,CAACE,IAAX;AACD;;AAED,SAASjB,WAAT,GAAuB;AACrB;AACA,MAAI,CAACkB,KAAK,CAACC,SAAN,CAAgBC,EAArB,EAAyB;AACvB,QAAIA,EAAE,GAAGJ,OAAO,CAAC,oBAAD,CAAhB;;AACAI,IAAAA,EAAE,CAACH,IAAH;AACD;AACF","sourcesContent":["import { registerGlobals as webrtcRegisterGlobals } from '@livekit/react-native-webrtc';\nimport { setupURLPolyfill } from 'react-native-url-polyfill';\nimport AudioSession from './audio/AudioSession';\nimport type { AudioConfiguration } from './audio/AudioSession';\nimport { PixelRatio, Platform } from 'react-native';\nimport type { LiveKitReactNativeInfo } from 'livekit-client';\n\n/**\n * Registers the required globals needed for LiveKit to work.\n *\n * Must be called before using LiveKit.\n */\nexport function registerGlobals() {\n  webrtcRegisterGlobals();\n  livekitRegisterGlobals();\n  setupURLPolyfill();\n  fixWebrtcAdapter();\n  shimPromiseAllSettled();\n  shimArrayAt();\n}\nfunction livekitRegisterGlobals() {\n  let lkGlobal: LiveKitReactNativeInfo = {\n    platform: Platform.OS,\n    devicePixelRatio: PixelRatio.get(),\n  };\n\n  // @ts-ignore\n  global.LiveKitReactNativeGlobal = lkGlobal;\n}\n\nfunction fixWebrtcAdapter() {\n  // @ts-ignore\n  if (window?.navigator !== undefined) {\n    // @ts-ignore\n    const { navigator } = window;\n    if (navigator.userAgent === undefined) {\n      navigator.userAgent = navigator.product ?? 'Unknown';\n    }\n  }\n}\n\nfunction shimPromiseAllSettled() {\n  var allSettled = require('promise.allsettled');\n  allSettled.shim();\n}\n\nfunction shimArrayAt() {\n  // Some versions of RN don't have Array.prototype.at, which is used by sdp-transform\n  if (!Array.prototype.at) {\n    var at = require('array.prototype.at');\n    at.shim();\n  }\n}\n\nexport * from './components/VideoView';\nexport * from './useParticipant';\nexport * from './useRoom';\nexport { AudioSession, AudioConfiguration };\n"]}
+{"version":3,"sources":["index.tsx"],"names":["registerGlobals","livekitRegisterGlobals","fixWebrtcAdapter","shimPromiseAllSettled","shimArrayAt","shimAsyncIterator","shimIterator","lkGlobal","platform","Platform","OS","devicePixelRatio","PixelRatio","get","global","LiveKitReactNativeGlobal","window","navigator","undefined","userAgent","product","allSettled","require","shim","Array","prototype","at"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;AACA;;AACA;;AACA;;AAKA;;AA8DA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AACA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AACA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;;;;AA7DA;AACA;AACA;AACA;AACA;AACO,SAASA,eAAT,GAA2B;AAChC;AACAC,EAAAA,sBAAsB;AACtB;AACAC,EAAAA,gBAAgB;AAChBC,EAAAA,qBAAqB;AACrBC,EAAAA,WAAW;AACXC,EAAAA,iBAAiB;AACjBC,EAAAA,YAAY;AACb;;AACD,SAASL,sBAAT,GAAkC;AAChC,MAAIM,QAAgC,GAAG;AACrCC,IAAAA,QAAQ,EAAEC,sBAASC,EADkB;AAErCC,IAAAA,gBAAgB,EAAEC,wBAAWC,GAAX;AAFmB,GAAvC,CADgC,CAMhC;;AACAC,EAAAA,MAAM,CAACC,wBAAP,GAAkCR,QAAlC;AACD;;AAED,SAASL,gBAAT,GAA4B;AAAA;;AAC1B;AACA,MAAI,YAAAc,MAAM,UAAN,0CAAQC,SAAR,MAAsBC,SAA1B,EAAqC;AACnC;AACA,UAAM;AAAED,MAAAA;AAAF,QAAgBD,MAAtB;;AACA,QAAIC,SAAS,CAACE,SAAV,KAAwBD,SAA5B,EAAuC;AAAA;;AACrCD,MAAAA,SAAS,CAACE,SAAV,yBAAsBF,SAAS,CAACG,OAAhC,mEAA2C,SAA3C;AACD;AACF;AACF;;AAED,SAASjB,qBAAT,GAAiC;AAC/B,MAAIkB,UAAU,GAAGC,OAAO,CAAC,oBAAD,CAAxB;;AACAD,EAAAA,UAAU,CAACE,IAAX;AACD;;AAED,SAASnB,WAAT,GAAuB;AACrB;AACA,MAAI,CAACoB,KAAK,CAACC,SAAN,CAAgBC,EAArB,EAAyB;AACvB,QAAIA,EAAE,GAAGJ,OAAO,CAAC,oBAAD,CAAhB;;AACAI,IAAAA,EAAE,CAACH,IAAH;AACD;AACF;;AAED,SAASlB,iBAAT,GAA6B;AAC3B,MAAIkB,IAAI,GAAGD,OAAO,CAAC,8CAAD,CAAlB;;AACAC,EAAAA,IAAI;AACL;;AAED,SAASjB,YAAT,GAAwB;AACtB,MAAIiB,IAAI,GAAGD,OAAO,CAAC,yCAAD,CAAlB;;AACAC,EAAAA,IAAI;AACL","sourcesContent":["import { registerGlobals as webrtcRegisterGlobals } from '@livekit/react-native-webrtc';\nimport { setupURLPolyfill } from 'react-native-url-polyfill';\nimport 'fastestsmallesttextencoderdecoder';\nimport AudioSession, {\n  AndroidAudioTypePresets,\n  AndroidAudioTypeOptions,\n} from './audio/AudioSession';\nimport type { AudioConfiguration } from './audio/AudioSession';\nimport { PixelRatio, Platform } from 'react-native';\nimport type { LiveKitReactNativeInfo } from 'livekit-client';\n\n/**\n * Registers the required globals needed for LiveKit to work.\n *\n * Must be called before using LiveKit.\n */\nexport function registerGlobals() {\n  webrtcRegisterGlobals();\n  livekitRegisterGlobals();\n  setupURLPolyfill();\n  fixWebrtcAdapter();\n  shimPromiseAllSettled();\n  shimArrayAt();\n  shimAsyncIterator();\n  shimIterator();\n}\nfunction livekitRegisterGlobals() {\n  let lkGlobal: LiveKitReactNativeInfo = {\n    platform: Platform.OS,\n    devicePixelRatio: PixelRatio.get(),\n  };\n\n  // @ts-ignore\n  global.LiveKitReactNativeGlobal = lkGlobal;\n}\n\nfunction fixWebrtcAdapter() {\n  // @ts-ignore\n  if (window?.navigator !== undefined) {\n    // @ts-ignore\n    const { navigator } = window;\n    if (navigator.userAgent === undefined) {\n      navigator.userAgent = navigator.product ?? 'Unknown';\n    }\n  }\n}\n\nfunction shimPromiseAllSettled() {\n  var allSettled = require('promise.allsettled');\n  allSettled.shim();\n}\n\nfunction shimArrayAt() {\n  // Some versions of RN don't have Array.prototype.at, which is used by sdp-transform\n  if (!Array.prototype.at) {\n    var at = require('array.prototype.at');\n    at.shim();\n  }\n}\n\nfunction shimAsyncIterator() {\n  var shim = require('well-known-symbols/Symbol.asyncIterator/shim');\n  shim();\n}\n\nfunction shimIterator() {\n  var shim = require('well-known-symbols/Symbol.iterator/shim');\n  shim();\n}\n\nexport * from './components/VideoView';\nexport * from './useParticipant';\nexport * from './useRoom';\nexport {\n  AudioSession,\n  AudioConfiguration,\n  AndroidAudioTypeOptions,\n  AndroidAudioTypePresets,\n};\n"]}

package/lib/module/audio/AudioSession.js

@@ -21,17 +21,15 @@ const LivekitReactNative = NativeModules.LivekitReactNative ? NativeModules.Live
  *   This is ignored when an output is manually selected with {@link AudioSession.selectAudioOutput}.
  *
  *   By default, the order is set to:
- *   1. `"speaker"`
- *   2. `"earpiece"`
- *   3. `"headset"`
- *   4. `"bluetooth"`
+ *   1. `"bluetooth"
+ *   2. `"headset"``
+ *   3. `"speaker"`
+ *   4. `"earpiece"`
  *
- * * audioMode - The audio mode to use for the audio session. Defaults to 'normal'.
+ * * audioTypeOptions - An {@link AndroidAudioTypeOptions} object which provides the
+ *   audio options to use on Android.
  *
- * * audioFocusMode - The focus mode to use for the audio session. Defaults to 'gain'.
- *
- *  See [AudioManager](https://developer.android.com/reference/android/media/AudioManager) for details
- *  on audio and focus modes.
+ *   See {@link AndroidAudioTypePresets} for pre-configured values.
  *
  * ----
  * iOS
@@ -41,6 +39,24 @@ const LivekitReactNative = NativeModules.LivekitReactNative ? NativeModules.Live
  *   By default, this is set to `"speaker"`
  */
 
+export const AndroidAudioTypePresets = {
+  communication: {
+    manageAudioFocus: true,
+    audioMode: 'inCommunication',
+    audioFocusMode: 'gain',
+    audioStreamType: 'voiceCall',
+    audioAttributesUsageType: 'voiceCommunication',
+    audioAttributesContentType: 'speech'
+  },
+  media: {
+    manageAudioFocus: true,
+    audioMode: 'normal',
+    audioFocusMode: 'gain',
+    audioStreamType: 'music',
+    audioAttributesUsageType: 'media',
+    audioAttributesContentType: 'unknown'
+  }
+};
 export default class AudioSession {}
 
 _defineProperty(AudioSession, "configureAudio", async config => {

package/lib/module/audio/AudioSession.js.map

@@ -1 +1 @@
-{"version":3,"sources":["AudioSession.ts"],"names":["NativeModules","Platform","LINKING_ERROR","select","ios","default","LivekitReactNative","Proxy","get","Error","AudioSession","config","configureAudio","startAudioSession","stopAudioSession","OS","getAudioOutputs","deviceId","selectAudioOutput","showAudioRoutePicker"],"mappings":";;AAAA,SAASA,aAAT,EAAwBC,QAAxB,QAAwC,cAAxC;AACA,MAAMC,aAAa,GAChB,gFAAD,GACAD,QAAQ,CAACE,MAAT,CAAgB;AAAEC,EAAAA,GAAG,EAAE,gCAAP;AAAyCC,EAAAA,OAAO,EAAE;AAAlD,CAAhB,CADA,GAEA,sDAFA,GAGA,6CAJF;AAMA,MAAMC,kBAAkB,GAAGN,aAAa,CAACM,kBAAd,GACvBN,aAAa,CAACM,kBADS,GAEvB,IAAIC,KAAJ,CACE,EADF,EAEE;AACEC,EAAAA,GAAG,GAAG;AACJ,UAAM,IAAIC,KAAJ,CAAUP,aAAV,CAAN;AACD;;AAHH,CAFF,CAFJ;AAWA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAqBA,eAAe,MAAMQ,YAAN,CAAmB;;gBAAbA,Y,oBAMK,MAAOC,MAAP,IAAsC;AAC5D,QAAML,kBAAkB,CAACM,cAAnB,CAAkCD,MAAlC,CAAN;AACD,C;;gBARkBD,Y,uBAaQ,YAAY;AACrC,QAAMJ,kBAAkB,CAACO,iBAAnB,EAAN;AACD,C;;gBAfkBH,Y,sBAoBO,YAAY;AACpC,QAAMJ,kBAAkB,CAACQ,gBAAnB,EAAN;AACD,C;;gBAtBkBJ,Y,qBAmDM,YAA+B;AACtD,MAAIT,QAAQ,CAACc,EAAT,KAAgB,KAApB,EAA2B;AACzB,WAAO,CAAC,SAAD,EAAY,eAAZ,CAAP;AACD,GAFD,MAEO,IAAId,QAAQ,CAACc,EAAT,KAAgB,SAApB,EAA+B;AACpC,WAAQ,MAAMT,kBAAkB,CAACU,eAAnB,EAAd;AACD,GAFM,MAEA;AACL,WAAO,EAAP;AACD;AACF,C;;gBA3DkBN,Y,uBAoEQ,MAAOO,QAAP,IAA4B;AACrD,QAAMX,kBAAkB,CAACY,iBAAnB,CAAqCD,QAArC,CAAN;AACD,C;;gBAtEkBP,Y,0BA6EW,YAAY;AACxC,MAAIT,QAAQ,CAACc,EAAT,KAAgB,KAApB,EAA2B;AACzB,UAAMT,kBAAkB,CAACa,oBAAnB,EAAN;AACD;AACF,C","sourcesContent":["import { NativeModules, Platform } from 'react-native';\nconst LINKING_ERROR =\n  `The package '@livekit/react-native' doesn't seem to be linked. Make sure: \\n\\n` +\n  Platform.select({ ios: \"- You have run 'pod install'\\n\", default: '' }) +\n  '- You rebuilt the app after installing the package\\n' +\n  '- You are not using Expo managed workflow\\n';\n\nconst LivekitReactNative = NativeModules.LivekitReactNative\n  ? NativeModules.LivekitReactNative\n  : new Proxy(\n      {},\n      {\n        get() {\n          throw new Error(LINKING_ERROR);\n        },\n      }\n    );\n\n/**\n * Configuration for the underlying AudioSession.\n *\n * ----\n * Android specific options:\n *\n * * preferredOutputList - The preferred order in which to automatically select an audio output.\n *   This is ignored when an output is manually selected with {@link AudioSession.selectAudioOutput}.\n *\n *   By default, the order is set to:\n *   1. `\"speaker\"`\n *   2. `\"earpiece\"`\n *   3. `\"headset\"`\n *   4. `\"bluetooth\"`\n *\n * * audioMode - The audio mode to use for the audio session. Defaults to 'normal'.\n *\n * * audioFocusMode - The focus mode to use for the audio session. Defaults to 'gain'.\n *\n *  See [AudioManager](https://developer.android.com/reference/android/media/AudioManager) for details\n *  on audio and focus modes.\n *\n * ----\n * iOS\n *\n * * defaultOutput - The default preferred output to use when a wired headset or bluetooth output is unavailable.\n *\n *   By default, this is set to `\"speaker\"`\n */\nexport type AudioConfiguration = {\n  android?: {\n    preferredOutputList?: ('speaker' | 'earpiece' | 'headset' | 'bluetooth')[];\n    audioMode?:\n      | 'normal'\n      | 'callScreening'\n      | 'inCall'\n      | 'inCommunication'\n      | 'ringtone';\n    audioFocusMode?:\n      | 'gain'\n      | 'gainTransient'\n      | 'gainTransientExclusive'\n      | 'gainTransientMayDuck';\n  };\n  ios?: {\n    defaultOutput?: 'speaker' | 'earpiece';\n  };\n};\n\nexport default class AudioSession {\n  /**\n   * Applies the provided audio configuration to the underlying AudioSession.\n   *\n   * Must be called prior to connecting to a Room for the configuration to apply correctly.\n   */\n  static configureAudio = async (config: AudioConfiguration) => {\n    await LivekitReactNative.configureAudio(config);\n  };\n\n  /**\n   * Starts an AudioSession.\n   */\n  static startAudioSession = async () => {\n    await LivekitReactNative.startAudioSession();\n  };\n\n  /**\n   * Stops the existing AudioSession.\n   */\n  static stopAudioSession = async () => {\n    await LivekitReactNative.stopAudioSession();\n  };\n\n  /**\n   * Gets the available audio outputs for use with {@link selectAudioOutput}.\n   *\n   * {@link startAudioSession} must be called prior to using this method.\n   *\n   * For Android, will return if available:\n   * * \"speaker\"\n   * * \"earpiece\"\n   * * \"headset\"\n   * * \"bluetooth\"\n   *\n   * Note: For applications targeting SDK versions over 30, the runtime BLUETOOTH_CONNECT\n   * permission must be requested to send audio to bluetooth headsets.\n   *\n   * ----\n   *\n   * For iOS, due to OS limitations, the only available types are:\n   * * \"default\" - Use default iOS audio routing\n   * * \"force_speaker\" - Force audio output through speaker\n   *\n   * See also {@link showAudioRoutePicker} to display a route picker that\n   * can choose between other audio devices (i.e. headset/bluetooth/airplay),\n   * or use a library like `react-native-avroutepicker` for a native platform\n   * control.\n   *\n   * @returns the available audio output types\n   */\n  static getAudioOutputs = async (): Promise<string[]> => {\n    if (Platform.OS === 'ios') {\n      return ['default', 'force_speaker'];\n    } else if (Platform.OS === 'android') {\n      return (await LivekitReactNative.getAudioOutputs()) as string[];\n    } else {\n      return [];\n    }\n  };\n\n  /**\n   * Select the provided audio output if available.\n   *\n   * {@link startAudioSession} must be called prior to using this method.\n   *\n   * @param deviceId A deviceId retrieved from {@link getAudioOutputs}\n   */\n  static selectAudioOutput = async (deviceId: string) => {\n    await LivekitReactNative.selectAudioOutput(deviceId);\n  };\n\n  /**\n   * iOS only, requires iOS 11+.\n   *\n   * Displays an AVRoutePickerView for the user to choose their audio output.\n   */\n  static showAudioRoutePicker = async () => {\n    if (Platform.OS === 'ios') {\n      await LivekitReactNative.showAudioRoutePicker();\n    }\n  };\n}\n"]}
+{"version":3,"sources":["AudioSession.ts"],"names":["NativeModules","Platform","LINKING_ERROR","select","ios","default","LivekitReactNative","Proxy","get","Error","AndroidAudioTypePresets","communication","manageAudioFocus","audioMode","audioFocusMode","audioStreamType","audioAttributesUsageType","audioAttributesContentType","media","AudioSession","config","configureAudio","startAudioSession","stopAudioSession","OS","getAudioOutputs","deviceId","selectAudioOutput","showAudioRoutePicker"],"mappings":";;AAAA,SAASA,aAAT,EAAwBC,QAAxB,QAAwC,cAAxC;AACA,MAAMC,aAAa,GAChB,gFAAD,GACAD,QAAQ,CAACE,MAAT,CAAgB;AAAEC,EAAAA,GAAG,EAAE,gCAAP;AAAyCC,EAAAA,OAAO,EAAE;AAAlD,CAAhB,CADA,GAEA,sDAFA,GAGA,6CAJF;AAMA,MAAMC,kBAAkB,GAAGN,aAAa,CAACM,kBAAd,GACvBN,aAAa,CAACM,kBADS,GAEvB,IAAIC,KAAJ,CACE,EADF,EAEE;AACEC,EAAAA,GAAG,GAAG;AACJ,UAAM,IAAIC,KAAJ,CAAUP,aAAV,CAAN;AACD;;AAHH,CAFF,CAFJ;AAWA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA6GA,OAAO,MAAMQ,uBASZ,GAAG;AACFC,EAAAA,aAAa,EAAE;AACbC,IAAAA,gBAAgB,EAAE,IADL;AAEbC,IAAAA,SAAS,EAAE,iBAFE;AAGbC,IAAAA,cAAc,EAAE,MAHH;AAIbC,IAAAA,eAAe,EAAE,WAJJ;AAKbC,IAAAA,wBAAwB,EAAE,oBALb;AAMbC,IAAAA,0BAA0B,EAAE;AANf,GADb;AASFC,EAAAA,KAAK,EAAE;AACLN,IAAAA,gBAAgB,EAAE,IADb;AAELC,IAAAA,SAAS,EAAE,QAFN;AAGLC,IAAAA,cAAc,EAAE,MAHX;AAILC,IAAAA,eAAe,EAAE,OAJZ;AAKLC,IAAAA,wBAAwB,EAAE,OALrB;AAMLC,IAAAA,0BAA0B,EAAE;AANvB;AATL,CATG;AA4BP,eAAe,MAAME,YAAN,CAAmB;;gBAAbA,Y,oBAMK,MAAOC,MAAP,IAAsC;AAC5D,QAAMd,kBAAkB,CAACe,cAAnB,CAAkCD,MAAlC,CAAN;AACD,C;;gBARkBD,Y,uBAaQ,YAAY;AACrC,QAAMb,kBAAkB,CAACgB,iBAAnB,EAAN;AACD,C;;gBAfkBH,Y,sBAoBO,YAAY;AACpC,QAAMb,kBAAkB,CAACiB,gBAAnB,EAAN;AACD,C;;gBAtBkBJ,Y,qBAgDM,YAA+B;AACtD,MAAIlB,QAAQ,CAACuB,EAAT,KAAgB,KAApB,EAA2B;AACzB,WAAO,CAAC,SAAD,EAAY,eAAZ,CAAP;AACD,GAFD,MAEO,IAAIvB,QAAQ,CAACuB,EAAT,KAAgB,SAApB,EAA+B;AACpC,WAAQ,MAAMlB,kBAAkB,CAACmB,eAAnB,EAAd;AACD,GAFM,MAEA;AACL,WAAO,EAAP;AACD;AACF,C;;gBAxDkBN,Y,uBAiEQ,MAAOO,QAAP,IAA4B;AACrD,QAAMpB,kBAAkB,CAACqB,iBAAnB,CAAqCD,QAArC,CAAN;AACD,C;;gBAnEkBP,Y,0BA0EW,YAAY;AACxC,MAAIlB,QAAQ,CAACuB,EAAT,KAAgB,KAApB,EAA2B;AACzB,UAAMlB,kBAAkB,CAACsB,oBAAnB,EAAN;AACD;AACF,C","sourcesContent":["import { NativeModules, Platform } from 'react-native';\nconst LINKING_ERROR =\n  `The package '@livekit/react-native' doesn't seem to be linked. Make sure: \\n\\n` +\n  Platform.select({ ios: \"- You have run 'pod install'\\n\", default: '' }) +\n  '- You rebuilt the app after installing the package\\n' +\n  '- You are not using Expo managed workflow\\n';\n\nconst LivekitReactNative = NativeModules.LivekitReactNative\n  ? NativeModules.LivekitReactNative\n  : new Proxy(\n      {},\n      {\n        get() {\n          throw new Error(LINKING_ERROR);\n        },\n      }\n    );\n\n/**\n * Configuration for the underlying AudioSession.\n *\n * ----\n * Android specific options:\n *\n * * preferredOutputList - The preferred order in which to automatically select an audio output.\n *   This is ignored when an output is manually selected with {@link AudioSession.selectAudioOutput}.\n *\n *   By default, the order is set to:\n *   1. `\"bluetooth\"\n *   2. `\"headset\"``\n *   3. `\"speaker\"`\n *   4. `\"earpiece\"`\n *\n * * audioTypeOptions - An {@link AndroidAudioTypeOptions} object which provides the\n *   audio options to use on Android.\n *\n *   See {@link AndroidAudioTypePresets} for pre-configured values.\n *\n * ----\n * iOS\n *\n * * defaultOutput - The default preferred output to use when a wired headset or bluetooth output is unavailable.\n *\n *   By default, this is set to `\"speaker\"`\n */\nexport type AudioConfiguration = {\n  android?: {\n    preferredOutputList?: ('speaker' | 'earpiece' | 'headset' | 'bluetooth')[];\n    audioTypeOptions: AndroidAudioTypeOptions;\n  };\n  ios?: {\n    defaultOutput?: 'speaker' | 'earpiece';\n  };\n};\n\nexport type AndroidAudioTypeOptions = {\n  /**\n   * Whether LiveKit should handle managing the audio focus or not.\n   *\n   * Defaults to true.\n   */\n  manageAudioFocus?: boolean;\n\n  /**\n   * Corresponds to {@link https://developer.android.com/reference/android/media/AudioManager#setMode(int)}\n   *\n   * Defaults to 'inCommunication'.\n   */\n  audioMode?:\n    | 'normal'\n    | 'callScreening'\n    | 'inCall'\n    | 'inCommunication'\n    | 'ringtone';\n\n  /**\n   * Corresponds to the duration hint when requesting audio focus.\n   *\n   * Defaults to 'gain'.\n   *\n   * See also {@link https://developer.android.com/reference/android/media/AudioManager#AUDIOFOCUS_GAIN}\n   */\n  audioFocusMode?:\n    | 'gain'\n    | 'gainTransient'\n    | 'gainTransientExclusive'\n    | 'gainTransientMayDuck';\n\n  /**\n   * Corresponds to Android's AudioAttributes usage type.\n   *\n   * Defaults to 'voiceCommunication'.\n   *\n   * See also {@link https://developer.android.com/reference/android/media/AudioAttributes}\n   */\n  audioAttributesUsageType?:\n    | 'alarm'\n    | 'assistanceAccessibility'\n    | 'assistanceNavigationGuidance'\n    | 'assistanceSonification'\n    | 'assistant'\n    | 'game'\n    | 'media'\n    | 'notification'\n    | 'notificationEvent'\n    | 'notificationRingtone'\n    | 'unknown'\n    | 'voiceCommunication'\n    | 'voiceCommunicationSignalling';\n\n  /**\n   * Corresponds to Android's AndroidAttributes content type.\n   *\n   * Defaults to 'speech'.\n   *\n   * See also {@link https://developer.android.com/reference/android/media/AudioAttributes}\n   */\n  audioAttributesContentType?:\n    | 'movie'\n    | 'music'\n    | 'sonification'\n    | 'speech'\n    | 'unknown';\n\n  /**\n   * Corresponds to the stream type when requesting audio focus. Used on pre-O devices.\n   *\n   * Defaults to 'voiceCall'\n   *\n   * See also {@link https://developer.android.com/reference/android/media/AudioManager#STREAM_VOICE_CALL}\n   */\n  audioStreamType?:\n    | 'accessibility'\n    | 'alarm'\n    | 'dtmf'\n    | 'music'\n    | 'notification'\n    | 'ring'\n    | 'system'\n    | 'voiceCall';\n\n  /**\n   * On certain Android devices, audio routing does not function properly and\n   * bluetooth microphones will not work unless audio mode is set to\n   * `inCommunication` or `inCall`. Audio routing is turned off those cases.\n   *\n   * If this set to true, will attempt to do audio routing regardless of audio mode.\n   *\n   * Defaults to false.\n   */\n  forceHandleAudioRouting?: boolean;\n};\n\nexport const AndroidAudioTypePresets: {\n  /**\n   * A pre-configured AndroidAudioConfiguration for voice communication.\n   */\n  communication: AndroidAudioTypeOptions;\n  /**\n   * A pre-configured AndroidAudioConfiguration for media playback.\n   */\n  media: AndroidAudioTypeOptions;\n} = {\n  communication: {\n    manageAudioFocus: true,\n    audioMode: 'inCommunication',\n    audioFocusMode: 'gain',\n    audioStreamType: 'voiceCall',\n    audioAttributesUsageType: 'voiceCommunication',\n    audioAttributesContentType: 'speech',\n  },\n  media: {\n    manageAudioFocus: true,\n    audioMode: 'normal',\n    audioFocusMode: 'gain',\n    audioStreamType: 'music',\n    audioAttributesUsageType: 'media',\n    audioAttributesContentType: 'unknown',\n  },\n} as const;\n\nexport default class AudioSession {\n  /**\n   * Applies the provided audio configuration to the underlying AudioSession.\n   *\n   * Must be called prior to connecting to a Room for the configuration to apply correctly.\n   */\n  static configureAudio = async (config: AudioConfiguration) => {\n    await LivekitReactNative.configureAudio(config);\n  };\n\n  /**\n   * Starts an AudioSession.\n   */\n  static startAudioSession = async () => {\n    await LivekitReactNative.startAudioSession();\n  };\n\n  /**\n   * Stops the existing AudioSession.\n   */\n  static stopAudioSession = async () => {\n    await LivekitReactNative.stopAudioSession();\n  };\n\n  /**\n   * Gets the available audio outputs for use with {@link selectAudioOutput}.\n   *\n   * {@link startAudioSession} must be called prior to using this method.\n   *\n   * For Android, will return if available:\n   * * \"speaker\"\n   * * \"earpiece\"\n   * * \"headset\"\n   * * \"bluetooth\"\n   *\n   * ----\n   *\n   * For iOS, due to OS limitations, the only available types are:\n   * * \"default\" - Use default iOS audio routing\n   * * \"force_speaker\" - Force audio output through speaker\n   *\n   * See also {@link showAudioRoutePicker} to display a route picker that\n   * can choose between other audio devices (i.e. headset/bluetooth/airplay),\n   * or use a library like `react-native-avroutepicker` for a native platform\n   * control.\n   *\n   * @returns the available audio output types\n   */\n  static getAudioOutputs = async (): Promise<string[]> => {\n    if (Platform.OS === 'ios') {\n      return ['default', 'force_speaker'];\n    } else if (Platform.OS === 'android') {\n      return (await LivekitReactNative.getAudioOutputs()) as string[];\n    } else {\n      return [];\n    }\n  };\n\n  /**\n   * Select the provided audio output if available.\n   *\n   * {@link startAudioSession} must be called prior to using this method.\n   *\n   * @param deviceId A deviceId retrieved from {@link getAudioOutputs}\n   */\n  static selectAudioOutput = async (deviceId: string) => {\n    await LivekitReactNative.selectAudioOutput(deviceId);\n  };\n\n  /**\n   * iOS only, requires iOS 11+.\n   *\n   * Displays an AVRoutePickerView for the user to choose their audio output.\n   */\n  static showAudioRoutePicker = async () => {\n    if (Platform.OS === 'ios') {\n      await LivekitReactNative.showAudioRoutePicker();\n    }\n  };\n}\n"]}

package/lib/module/index.js

@@ -1,6 +1,7 @@
 import { registerGlobals as webrtcRegisterGlobals } from '@livekit/react-native-webrtc';
 import { setupURLPolyfill } from 'react-native-url-polyfill';
-import AudioSession from './audio/AudioSession';
+import 'fastestsmallesttextencoderdecoder';
+import AudioSession, { AndroidAudioTypePresets, AndroidAudioTypeOptions } from './audio/AudioSession';
 import { PixelRatio, Platform } from 'react-native';
 
 /**
@@ -15,6 +16,8 @@ export function registerGlobals() {
   fixWebrtcAdapter();
   shimPromiseAllSettled();
   shimArrayAt();
+  shimAsyncIterator();
+  shimIterator();
 }
 
 function livekitRegisterGlobals() {
@@ -59,8 +62,20 @@ function shimArrayAt() {
   }
 }
 
+function shimAsyncIterator() {
+  var shim = require('well-known-symbols/Symbol.asyncIterator/shim');
+
+  shim();
+}
+
+function shimIterator() {
+  var shim = require('well-known-symbols/Symbol.iterator/shim');
+
+  shim();
+}
+
 export * from './components/VideoView';
 export * from './useParticipant';
 export * from './useRoom';
-export { AudioSession };
+export { AudioSession, AndroidAudioTypeOptions, AndroidAudioTypePresets };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["index.tsx"],"names":["registerGlobals","webrtcRegisterGlobals","setupURLPolyfill","AudioSession","PixelRatio","Platform","livekitRegisterGlobals","fixWebrtcAdapter","shimPromiseAllSettled","shimArrayAt","lkGlobal","platform","OS","devicePixelRatio","get","global","LiveKitReactNativeGlobal","window","navigator","undefined","userAgent","product","allSettled","require","shim","Array","prototype","at"],"mappings":"AAAA,SAASA,eAAe,IAAIC,qBAA5B,QAAyD,8BAAzD;AACA,SAASC,gBAAT,QAAiC,2BAAjC;AACA,OAAOC,YAAP,MAAyB,sBAAzB;AAEA,SAASC,UAAT,EAAqBC,QAArB,QAAqC,cAArC;;AAGA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASL,eAAT,GAA2B;AAChCC,EAAAA,qBAAqB;AACrBK,EAAAA,sBAAsB;AACtBJ,EAAAA,gBAAgB;AAChBK,EAAAA,gBAAgB;AAChBC,EAAAA,qBAAqB;AACrBC,EAAAA,WAAW;AACZ;;AACD,SAASH,sBAAT,GAAkC;AAChC,MAAII,QAAgC,GAAG;AACrCC,IAAAA,QAAQ,EAAEN,QAAQ,CAACO,EADkB;AAErCC,IAAAA,gBAAgB,EAAET,UAAU,CAACU,GAAX;AAFmB,GAAvC,CADgC,CAMhC;;AACAC,EAAAA,MAAM,CAACC,wBAAP,GAAkCN,QAAlC;AACD;;AAED,SAASH,gBAAT,GAA4B;AAAA;;AAC1B;AACA,MAAI,YAAAU,MAAM,UAAN,0CAAQC,SAAR,MAAsBC,SAA1B,EAAqC;AACnC;AACA,UAAM;AAAED,MAAAA;AAAF,QAAgBD,MAAtB;;AACA,QAAIC,SAAS,CAACE,SAAV,KAAwBD,SAA5B,EAAuC;AAAA;;AACrCD,MAAAA,SAAS,CAACE,SAAV,yBAAsBF,SAAS,CAACG,OAAhC,mEAA2C,SAA3C;AACD;AACF;AACF;;AAED,SAASb,qBAAT,GAAiC;AAC/B,MAAIc,UAAU,GAAGC,OAAO,CAAC,oBAAD,CAAxB;;AACAD,EAAAA,UAAU,CAACE,IAAX;AACD;;AAED,SAASf,WAAT,GAAuB;AACrB;AACA,MAAI,CAACgB,KAAK,CAACC,SAAN,CAAgBC,EAArB,EAAyB;AACvB,QAAIA,EAAE,GAAGJ,OAAO,CAAC,oBAAD,CAAhB;;AACAI,IAAAA,EAAE,CAACH,IAAH;AACD;AACF;;AAED,cAAc,wBAAd;AACA,cAAc,kBAAd;AACA,cAAc,WAAd;AACA,SAASrB,YAAT","sourcesContent":["import { registerGlobals as webrtcRegisterGlobals } from '@livekit/react-native-webrtc';\nimport { setupURLPolyfill } from 'react-native-url-polyfill';\nimport AudioSession from './audio/AudioSession';\nimport type { AudioConfiguration } from './audio/AudioSession';\nimport { PixelRatio, Platform } from 'react-native';\nimport type { LiveKitReactNativeInfo } from 'livekit-client';\n\n/**\n * Registers the required globals needed for LiveKit to work.\n *\n * Must be called before using LiveKit.\n */\nexport function registerGlobals() {\n  webrtcRegisterGlobals();\n  livekitRegisterGlobals();\n  setupURLPolyfill();\n  fixWebrtcAdapter();\n  shimPromiseAllSettled();\n  shimArrayAt();\n}\nfunction livekitRegisterGlobals() {\n  let lkGlobal: LiveKitReactNativeInfo = {\n    platform: Platform.OS,\n    devicePixelRatio: PixelRatio.get(),\n  };\n\n  // @ts-ignore\n  global.LiveKitReactNativeGlobal = lkGlobal;\n}\n\nfunction fixWebrtcAdapter() {\n  // @ts-ignore\n  if (window?.navigator !== undefined) {\n    // @ts-ignore\n    const { navigator } = window;\n    if (navigator.userAgent === undefined) {\n      navigator.userAgent = navigator.product ?? 'Unknown';\n    }\n  }\n}\n\nfunction shimPromiseAllSettled() {\n  var allSettled = require('promise.allsettled');\n  allSettled.shim();\n}\n\nfunction shimArrayAt() {\n  // Some versions of RN don't have Array.prototype.at, which is used by sdp-transform\n  if (!Array.prototype.at) {\n    var at = require('array.prototype.at');\n    at.shim();\n  }\n}\n\nexport * from './components/VideoView';\nexport * from './useParticipant';\nexport * from './useRoom';\nexport { AudioSession, AudioConfiguration };\n"]}
+{"version":3,"sources":["index.tsx"],"names":["registerGlobals","webrtcRegisterGlobals","setupURLPolyfill","AudioSession","AndroidAudioTypePresets","AndroidAudioTypeOptions","PixelRatio","Platform","livekitRegisterGlobals","fixWebrtcAdapter","shimPromiseAllSettled","shimArrayAt","shimAsyncIterator","shimIterator","lkGlobal","platform","OS","devicePixelRatio","get","global","LiveKitReactNativeGlobal","window","navigator","undefined","userAgent","product","allSettled","require","shim","Array","prototype","at"],"mappings":"AAAA,SAASA,eAAe,IAAIC,qBAA5B,QAAyD,8BAAzD;AACA,SAASC,gBAAT,QAAiC,2BAAjC;AACA,OAAO,mCAAP;AACA,OAAOC,YAAP,IACEC,uBADF,EAEEC,uBAFF,QAGO,sBAHP;AAKA,SAASC,UAAT,EAAqBC,QAArB,QAAqC,cAArC;;AAGA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASP,eAAT,GAA2B;AAChCC,EAAAA,qBAAqB;AACrBO,EAAAA,sBAAsB;AACtBN,EAAAA,gBAAgB;AAChBO,EAAAA,gBAAgB;AAChBC,EAAAA,qBAAqB;AACrBC,EAAAA,WAAW;AACXC,EAAAA,iBAAiB;AACjBC,EAAAA,YAAY;AACb;;AACD,SAASL,sBAAT,GAAkC;AAChC,MAAIM,QAAgC,GAAG;AACrCC,IAAAA,QAAQ,EAAER,QAAQ,CAACS,EADkB;AAErCC,IAAAA,gBAAgB,EAAEX,UAAU,CAACY,GAAX;AAFmB,GAAvC,CADgC,CAMhC;;AACAC,EAAAA,MAAM,CAACC,wBAAP,GAAkCN,QAAlC;AACD;;AAED,SAASL,gBAAT,GAA4B;AAAA;;AAC1B;AACA,MAAI,YAAAY,MAAM,UAAN,0CAAQC,SAAR,MAAsBC,SAA1B,EAAqC;AACnC;AACA,UAAM;AAAED,MAAAA;AAAF,QAAgBD,MAAtB;;AACA,QAAIC,SAAS,CAACE,SAAV,KAAwBD,SAA5B,EAAuC;AAAA;;AACrCD,MAAAA,SAAS,CAACE,SAAV,yBAAsBF,SAAS,CAACG,OAAhC,mEAA2C,SAA3C;AACD;AACF;AACF;;AAED,SAASf,qBAAT,GAAiC;AAC/B,MAAIgB,UAAU,GAAGC,OAAO,CAAC,oBAAD,CAAxB;;AACAD,EAAAA,UAAU,CAACE,IAAX;AACD;;AAED,SAASjB,WAAT,GAAuB;AACrB;AACA,MAAI,CAACkB,KAAK,CAACC,SAAN,CAAgBC,EAArB,EAAyB;AACvB,QAAIA,EAAE,GAAGJ,OAAO,CAAC,oBAAD,CAAhB;;AACAI,IAAAA,EAAE,CAACH,IAAH;AACD;AACF;;AAED,SAAShB,iBAAT,GAA6B;AAC3B,MAAIgB,IAAI,GAAGD,OAAO,CAAC,8CAAD,CAAlB;;AACAC,EAAAA,IAAI;AACL;;AAED,SAASf,YAAT,GAAwB;AACtB,MAAIe,IAAI,GAAGD,OAAO,CAAC,yCAAD,CAAlB;;AACAC,EAAAA,IAAI;AACL;;AAED,cAAc,wBAAd;AACA,cAAc,kBAAd;AACA,cAAc,WAAd;AACA,SACEzB,YADF,EAGEE,uBAHF,EAIED,uBAJF","sourcesContent":["import { registerGlobals as webrtcRegisterGlobals } from '@livekit/react-native-webrtc';\nimport { setupURLPolyfill } from 'react-native-url-polyfill';\nimport 'fastestsmallesttextencoderdecoder';\nimport AudioSession, {\n  AndroidAudioTypePresets,\n  AndroidAudioTypeOptions,\n} from './audio/AudioSession';\nimport type { AudioConfiguration } from './audio/AudioSession';\nimport { PixelRatio, Platform } from 'react-native';\nimport type { LiveKitReactNativeInfo } from 'livekit-client';\n\n/**\n * Registers the required globals needed for LiveKit to work.\n *\n * Must be called before using LiveKit.\n */\nexport function registerGlobals() {\n  webrtcRegisterGlobals();\n  livekitRegisterGlobals();\n  setupURLPolyfill();\n  fixWebrtcAdapter();\n  shimPromiseAllSettled();\n  shimArrayAt();\n  shimAsyncIterator();\n  shimIterator();\n}\nfunction livekitRegisterGlobals() {\n  let lkGlobal: LiveKitReactNativeInfo = {\n    platform: Platform.OS,\n    devicePixelRatio: PixelRatio.get(),\n  };\n\n  // @ts-ignore\n  global.LiveKitReactNativeGlobal = lkGlobal;\n}\n\nfunction fixWebrtcAdapter() {\n  // @ts-ignore\n  if (window?.navigator !== undefined) {\n    // @ts-ignore\n    const { navigator } = window;\n    if (navigator.userAgent === undefined) {\n      navigator.userAgent = navigator.product ?? 'Unknown';\n    }\n  }\n}\n\nfunction shimPromiseAllSettled() {\n  var allSettled = require('promise.allsettled');\n  allSettled.shim();\n}\n\nfunction shimArrayAt() {\n  // Some versions of RN don't have Array.prototype.at, which is used by sdp-transform\n  if (!Array.prototype.at) {\n    var at = require('array.prototype.at');\n    at.shim();\n  }\n}\n\nfunction shimAsyncIterator() {\n  var shim = require('well-known-symbols/Symbol.asyncIterator/shim');\n  shim();\n}\n\nfunction shimIterator() {\n  var shim = require('well-known-symbols/Symbol.iterator/shim');\n  shim();\n}\n\nexport * from './components/VideoView';\nexport * from './useParticipant';\nexport * from './useRoom';\nexport {\n  AudioSession,\n  AudioConfiguration,\n  AndroidAudioTypeOptions,\n  AndroidAudioTypePresets,\n};\n"]}

package/lib/typescript/audio/AudioSession.d.ts

@@ -8,17 +8,15 @@
  *   This is ignored when an output is manually selected with {@link AudioSession.selectAudioOutput}.
  *
  *   By default, the order is set to:
- *   1. `"speaker"`
- *   2. `"earpiece"`
- *   3. `"headset"`
- *   4. `"bluetooth"`
+ *   1. `"bluetooth"
+ *   2. `"headset"``
+ *   3. `"speaker"`
+ *   4. `"earpiece"`
  *
- * * audioMode - The audio mode to use for the audio session. Defaults to 'normal'.
+ * * audioTypeOptions - An {@link AndroidAudioTypeOptions} object which provides the
+ *   audio options to use on Android.
  *
- * * audioFocusMode - The focus mode to use for the audio session. Defaults to 'gain'.
- *
- *  See [AudioManager](https://developer.android.com/reference/android/media/AudioManager) for details
- *  on audio and focus modes.
+ *   See {@link AndroidAudioTypePresets} for pre-configured values.
  *
  * ----
  * iOS
@@ -30,13 +28,78 @@
 export declare type AudioConfiguration = {
     android?: {
         preferredOutputList?: ('speaker' | 'earpiece' | 'headset' | 'bluetooth')[];
-        audioMode?: 'normal' | 'callScreening' | 'inCall' | 'inCommunication' | 'ringtone';
-        audioFocusMode?: 'gain' | 'gainTransient' | 'gainTransientExclusive' | 'gainTransientMayDuck';
+        audioTypeOptions: AndroidAudioTypeOptions;
     };
     ios?: {
         defaultOutput?: 'speaker' | 'earpiece';
     };
 };
+export declare type AndroidAudioTypeOptions = {
+    /**
+     * Whether LiveKit should handle managing the audio focus or not.
+     *
+     * Defaults to true.
+     */
+    manageAudioFocus?: boolean;
+    /**
+     * Corresponds to {@link https://developer.android.com/reference/android/media/AudioManager#setMode(int)}
+     *
+     * Defaults to 'inCommunication'.
+     */
+    audioMode?: 'normal' | 'callScreening' | 'inCall' | 'inCommunication' | 'ringtone';
+    /**
+     * Corresponds to the duration hint when requesting audio focus.
+     *
+     * Defaults to 'gain'.
+     *
+     * See also {@link https://developer.android.com/reference/android/media/AudioManager#AUDIOFOCUS_GAIN}
+     */
+    audioFocusMode?: 'gain' | 'gainTransient' | 'gainTransientExclusive' | 'gainTransientMayDuck';
+    /**
+     * Corresponds to Android's AudioAttributes usage type.
+     *
+     * Defaults to 'voiceCommunication'.
+     *
+     * See also {@link https://developer.android.com/reference/android/media/AudioAttributes}
+     */
+    audioAttributesUsageType?: 'alarm' | 'assistanceAccessibility' | 'assistanceNavigationGuidance' | 'assistanceSonification' | 'assistant' | 'game' | 'media' | 'notification' | 'notificationEvent' | 'notificationRingtone' | 'unknown' | 'voiceCommunication' | 'voiceCommunicationSignalling';
+    /**
+     * Corresponds to Android's AndroidAttributes content type.
+     *
+     * Defaults to 'speech'.
+     *
+     * See also {@link https://developer.android.com/reference/android/media/AudioAttributes}
+     */
+    audioAttributesContentType?: 'movie' | 'music' | 'sonification' | 'speech' | 'unknown';
+    /**
+     * Corresponds to the stream type when requesting audio focus. Used on pre-O devices.
+     *
+     * Defaults to 'voiceCall'
+     *
+     * See also {@link https://developer.android.com/reference/android/media/AudioManager#STREAM_VOICE_CALL}
+     */
+    audioStreamType?: 'accessibility' | 'alarm' | 'dtmf' | 'music' | 'notification' | 'ring' | 'system' | 'voiceCall';
+    /**
+     * On certain Android devices, audio routing does not function properly and
+     * bluetooth microphones will not work unless audio mode is set to
+     * `inCommunication` or `inCall`. Audio routing is turned off those cases.
+     *
+     * If this set to true, will attempt to do audio routing regardless of audio mode.
+     *
+     * Defaults to false.
+     */
+    forceHandleAudioRouting?: boolean;
+};
+export declare const AndroidAudioTypePresets: {
+    /**
+     * A pre-configured AndroidAudioConfiguration for voice communication.
+     */
+    communication: AndroidAudioTypeOptions;
+    /**
+     * A pre-configured AndroidAudioConfiguration for media playback.
+     */
+    media: AndroidAudioTypeOptions;
+};
 export default class AudioSession {
     /**
      * Applies the provided audio configuration to the underlying AudioSession.
@@ -63,9 +126,6 @@ export default class AudioSession {
      * * "headset"
      * * "bluetooth"
      *
-     * Note: For applications targeting SDK versions over 30, the runtime BLUETOOTH_CONNECT
-     * permission must be requested to send audio to bluetooth headsets.
-     *
      * ----
      *
      * For iOS, due to OS limitations, the only available types are:

package/lib/typescript/index.d.ts

@@ -1,4 +1,5 @@
-import AudioSession from './audio/AudioSession';
+import 'fastestsmallesttextencoderdecoder';
+import AudioSession, { AndroidAudioTypePresets, AndroidAudioTypeOptions } from './audio/AudioSession';
 import type { AudioConfiguration } from './audio/AudioSession';
 /**
  * Registers the required globals needed for LiveKit to work.
@@ -9,4 +10,4 @@ export declare function registerGlobals(): void;
 export * from './components/VideoView';
 export * from './useParticipant';
 export * from './useRoom';
-export { AudioSession, AudioConfiguration };
+export { AudioSession, AudioConfiguration, AndroidAudioTypeOptions, AndroidAudioTypePresets, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livekit/react-native",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "LiveKit for React Native",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -43,9 +43,11 @@
   ],
   "dependencies": {
     "array.prototype.at": "^1.1.1",
+    "fastestsmallesttextencoderdecoder": "^1.0.22",
     "livekit-client": "^1.8.0",
     "promise.allsettled": "^1.0.5",
-    "react-native-url-polyfill": "^1.3.0"
+    "react-native-url-polyfill": "^1.3.0",
+    "well-known-symbols": "^4.0.0"
   },
   "devDependencies": {
     "@babel/core": "^7.20.0",
@@ -56,6 +58,7 @@
     "@react-native-community/eslint-config": "^3.2.0",
     "@release-it/conventional-changelog": "^4.2.0",
     "@tsconfig/react-native": "^2.0.2",
+    "@types/fastestsmallesttextencoderdecoder": "^1.0.0",
     "@types/jest": "^29.2.1",
     "@types/react": "^18.0.24",
     "@types/react-native": "^0.71.3",

package/src/audio/AudioSession.ts

@@ -26,17 +26,15 @@ const LivekitReactNative = NativeModules.LivekitReactNative
  *   This is ignored when an output is manually selected with {@link AudioSession.selectAudioOutput}.
  *
  *   By default, the order is set to:
- *   1. `"speaker"`
- *   2. `"earpiece"`
- *   3. `"headset"`
- *   4. `"bluetooth"`
+ *   1. `"bluetooth"
+ *   2. `"headset"``
+ *   3. `"speaker"`
+ *   4. `"earpiece"`
  *
- * * audioMode - The audio mode to use for the audio session. Defaults to 'normal'.
+ * * audioTypeOptions - An {@link AndroidAudioTypeOptions} object which provides the
+ *   audio options to use on Android.
  *
- * * audioFocusMode - The focus mode to use for the audio session. Defaults to 'gain'.
- *
- *  See [AudioManager](https://developer.android.com/reference/android/media/AudioManager) for details
- *  on audio and focus modes.
+ *   See {@link AndroidAudioTypePresets} for pre-configured values.
  *
  * ----
  * iOS
@@ -48,23 +46,139 @@ const LivekitReactNative = NativeModules.LivekitReactNative
 export type AudioConfiguration = {
   android?: {
     preferredOutputList?: ('speaker' | 'earpiece' | 'headset' | 'bluetooth')[];
-    audioMode?:
-      | 'normal'
-      | 'callScreening'
-      | 'inCall'
-      | 'inCommunication'
-      | 'ringtone';
-    audioFocusMode?:
-      | 'gain'
-      | 'gainTransient'
-      | 'gainTransientExclusive'
-      | 'gainTransientMayDuck';
+    audioTypeOptions: AndroidAudioTypeOptions;
   };
   ios?: {
     defaultOutput?: 'speaker' | 'earpiece';
   };
 };
 
+export type AndroidAudioTypeOptions = {
+  /**
+   * Whether LiveKit should handle managing the audio focus or not.
+   *
+   * Defaults to true.
+   */
+  manageAudioFocus?: boolean;
+
+  /**
+   * Corresponds to {@link https://developer.android.com/reference/android/media/AudioManager#setMode(int)}
+   *
+   * Defaults to 'inCommunication'.
+   */
+  audioMode?:
+    | 'normal'
+    | 'callScreening'
+    | 'inCall'
+    | 'inCommunication'
+    | 'ringtone';
+
+  /**
+   * Corresponds to the duration hint when requesting audio focus.
+   *
+   * Defaults to 'gain'.
+   *
+   * See also {@link https://developer.android.com/reference/android/media/AudioManager#AUDIOFOCUS_GAIN}
+   */
+  audioFocusMode?:
+    | 'gain'
+    | 'gainTransient'
+    | 'gainTransientExclusive'
+    | 'gainTransientMayDuck';
+
+  /**
+   * Corresponds to Android's AudioAttributes usage type.
+   *
+   * Defaults to 'voiceCommunication'.
+   *
+   * See also {@link https://developer.android.com/reference/android/media/AudioAttributes}
+   */
+  audioAttributesUsageType?:
+    | 'alarm'
+    | 'assistanceAccessibility'
+    | 'assistanceNavigationGuidance'
+    | 'assistanceSonification'
+    | 'assistant'
+    | 'game'
+    | 'media'
+    | 'notification'
+    | 'notificationEvent'
+    | 'notificationRingtone'
+    | 'unknown'
+    | 'voiceCommunication'
+    | 'voiceCommunicationSignalling';
+
+  /**
+   * Corresponds to Android's AndroidAttributes content type.
+   *
+   * Defaults to 'speech'.
+   *
+   * See also {@link https://developer.android.com/reference/android/media/AudioAttributes}
+   */
+  audioAttributesContentType?:
+    | 'movie'
+    | 'music'
+    | 'sonification'
+    | 'speech'
+    | 'unknown';
+
+  /**
+   * Corresponds to the stream type when requesting audio focus. Used on pre-O devices.
+   *
+   * Defaults to 'voiceCall'
+   *
+   * See also {@link https://developer.android.com/reference/android/media/AudioManager#STREAM_VOICE_CALL}
+   */
+  audioStreamType?:
+    | 'accessibility'
+    | 'alarm'
+    | 'dtmf'
+    | 'music'
+    | 'notification'
+    | 'ring'
+    | 'system'
+    | 'voiceCall';
+
+  /**
+   * On certain Android devices, audio routing does not function properly and
+   * bluetooth microphones will not work unless audio mode is set to
+   * `inCommunication` or `inCall`. Audio routing is turned off those cases.
+   *
+   * If this set to true, will attempt to do audio routing regardless of audio mode.
+   *
+   * Defaults to false.
+   */
+  forceHandleAudioRouting?: boolean;
+};
+
+export const AndroidAudioTypePresets: {
+  /**
+   * A pre-configured AndroidAudioConfiguration for voice communication.
+   */
+  communication: AndroidAudioTypeOptions;
+  /**
+   * A pre-configured AndroidAudioConfiguration for media playback.
+   */
+  media: AndroidAudioTypeOptions;
+} = {
+  communication: {
+    manageAudioFocus: true,
+    audioMode: 'inCommunication',
+    audioFocusMode: 'gain',
+    audioStreamType: 'voiceCall',
+    audioAttributesUsageType: 'voiceCommunication',
+    audioAttributesContentType: 'speech',
+  },
+  media: {
+    manageAudioFocus: true,
+    audioMode: 'normal',
+    audioFocusMode: 'gain',
+    audioStreamType: 'music',
+    audioAttributesUsageType: 'media',
+    audioAttributesContentType: 'unknown',
+  },
+} as const;
+
 export default class AudioSession {
   /**
    * Applies the provided audio configuration to the underlying AudioSession.
@@ -100,9 +214,6 @@ export default class AudioSession {
    * * "headset"
    * * "bluetooth"
    *
-   * Note: For applications targeting SDK versions over 30, the runtime BLUETOOTH_CONNECT
-   * permission must be requested to send audio to bluetooth headsets.
-   *
    * ----
    *
    * For iOS, due to OS limitations, the only available types are:

package/src/index.tsx

@@ -1,6 +1,10 @@
 import { registerGlobals as webrtcRegisterGlobals } from '@livekit/react-native-webrtc';
 import { setupURLPolyfill } from 'react-native-url-polyfill';
-import AudioSession from './audio/AudioSession';
+import 'fastestsmallesttextencoderdecoder';
+import AudioSession, {
+  AndroidAudioTypePresets,
+  AndroidAudioTypeOptions,
+} from './audio/AudioSession';
 import type { AudioConfiguration } from './audio/AudioSession';
 import { PixelRatio, Platform } from 'react-native';
 import type { LiveKitReactNativeInfo } from 'livekit-client';
@@ -17,6 +21,8 @@ export function registerGlobals() {
   fixWebrtcAdapter();
   shimPromiseAllSettled();
   shimArrayAt();
+  shimAsyncIterator();
+  shimIterator();
 }
 function livekitRegisterGlobals() {
   let lkGlobal: LiveKitReactNativeInfo = {
@@ -52,7 +58,22 @@ function shimArrayAt() {
   }
 }
 
+function shimAsyncIterator() {
+  var shim = require('well-known-symbols/Symbol.asyncIterator/shim');
+  shim();
+}
+
+function shimIterator() {
+  var shim = require('well-known-symbols/Symbol.iterator/shim');
+  shim();
+}
+
 export * from './components/VideoView';
 export * from './useParticipant';
 export * from './useRoom';
-export { AudioSession, AudioConfiguration };
+export {
+  AudioSession,
+  AudioConfiguration,
+  AndroidAudioTypeOptions,
+  AndroidAudioTypePresets,
+};