@livekit/react-native 1.4.0 → 1.4.3

package/README.md

@@ -37,7 +37,8 @@ Once the `@livekit/react-native-webrtc` dependency is installed, one last step i
 
 In your [MainApplication.java](https://github.com/livekit/client-sdk-react-native/blob/main/example/android/app/src/main/java/com/example/livekitreactnative/MainApplication.java) file:
 
-```
+#### Java
+```java
 import com.livekit.reactnative.LiveKitReactNative;
 import com.livekit.reactnative.audio.AudioType;
 
@@ -55,11 +56,30 @@ public class MainApplication extends Application implements ReactApplication {
 }
 ```
 
+Or in your **MainApplication.kt** if you are using RN 0.73+
+#### Kotlin
+```kotlin
+import com.livekit.reactnative.LiveKitReactNative
+import com.livekit.reactnative.audio.AudioType
+
+class MainActivity : ReactActivity() {
+  override fun onCreate(savedInstanceState: Bundle?) {
+    // Place this above any other RN related initialization
+    // When AudioType is omitted, it'll default to CommunicationAudioType
+    // use MediaAudioType if user is only consuming audio, and not publishing
+    LiveKitReactNative.setup(this, AudioType.CommunicationAudioType())
+
+    //...
+  }
+}
+```
+----
+
 ### iOS
 
 In your [AppDelegate.m](https://github.com/livekit/client-sdk-react-native/blob/main/example/ios/LivekitReactNativeExample/AppDelegate.mm) file:
 
-```
+```objc
 #import "LivekitReactNative.h"
 
 @implementation AppDelegate
@@ -207,9 +227,8 @@ Android screenshare requires a foreground service with type `mediaProjection` to
 The example app uses [@voximplant/react-native-foreground-service](https://github.com/voximplant/react-native-foreground-service) for this.
 Ensure that the service is labelled a `mediaProjection` service like so:
 
-```
-<service android:name="com.voximplant.foregroundservice.VIForegroundService"
-  android:foregroundServiceType="mediaProjection" />
+```xml
+<service android:name="com.voximplant.foregroundservice.VIForegroundService" android:foregroundServiceType="mediaProjection" />
 ```
 
 Once setup, start the foreground service prior to using screenshare.

package/ios/LivekitReactNative.h

@@ -5,6 +5,7 @@
 //  Created by David Liu on 9/4/22.
 //  Copyright © 2022 LiveKit. All rights reserved.
 //
+#import <React/RCTBridgeModule.h>
 
 @interface LivekitReactNative : NSObject <RCTBridgeModule>
 

package/ios/LivekitReactNative.m

@@ -1,4 +1,3 @@
-#import <React/RCTBridgeModule.h>
 #import "AudioUtils.h"
 #import "LivekitReactNative.h"
 #import "WebRTCModule.h"

package/lib/commonjs/audio/AudioManager.js

@@ -25,7 +25,7 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
  *
  * @param room
  * @param preferSpeakerOutput
- * @param onConfigureNativeAudio
+ * @param onConfigureNativeAudio A custom method for determining options used.
  */
 function useIOSAudioManagement(room) {
   let preferSpeakerOutput = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;

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

@@ -1 +1 @@
-{"version":3,"sources":["AudioManager.ts"],"names":["useIOSAudioManagement","room","preferSpeakerOutput","onConfigureNativeAudio","localTrackCount","setLocalTrackCount","remoteTrackCount","setRemoteTrackCount","trackState","computeAudioTrackState","Platform","OS","getLocalAudioTrackCount","getRemoteAudioTrackCount","onLocalPublished","onLocalUnpublished","log","warn","Math","max","onRemotePublished","onRemoteUnpublished","on","RoomEvent","LocalTrackPublished","LocalTrackUnpublished","TrackPublished","TrackUnpublished","off","configFunc","getDefaultAppleAudioConfigurationForMode","audioConfig","AudioSession","setAppleAudioConfiguration","localTracks","remoteTracks","localParticipant","audioTracks","entries","length","participants","forEach","participant"],"mappings":";;;;;;;AAAA;;AACA;;AACA;;AACA;;AAKA;;;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,qBAAT,CACLC,IADK,EAOL;AAAA,MALAC,mBAKA,uEAL+B,IAK/B;AAAA,MAJAC,sBAIA;AACA,QAAM,CAACC,eAAD,EAAkBC,kBAAlB,IAAwC,qBAAS,CAAT,CAA9C;AACA,QAAM,CAACC,gBAAD,EAAmBC,mBAAnB,IAA0C,qBAAS,CAAT,CAAhD;AACA,QAAMC,UAAU,GAAG,oBACjB,MAAMC,sBAAsB,CAACL,eAAD,EAAkBE,gBAAlB,CADX,EAEjB,CAACF,eAAD,EAAkBE,gBAAlB,CAFiB,CAAnB;AAKA,wBAAU,MAAM;AACd,QAAII,sBAASC,EAAT,KAAgB,KAApB,EAA2B;AACzB,aAAO,MAAM,CAAE,CAAf;AACD;;AAEDN,IAAAA,kBAAkB,CAACO,uBAAuB,CAACX,IAAD,CAAxB,CAAlB;AACAM,IAAAA,mBAAmB,CAACM,wBAAwB,CAACZ,IAAD,CAAzB,CAAnB;;AAEA,QAAIa,gBAAgB,GAAG,MAAM;AAC3BT,MAAAA,kBAAkB,CAACD,eAAe,GAAG,CAAnB,CAAlB;AACD,KAFD;;AAGA,QAAIW,kBAAkB,GAAG,MAAM;AAC7B,UAAIX,eAAe,GAAG,CAAlB,GAAsB,CAA1B,EAA6B;AAC3BY,cAAIC,IAAJ,CACE,iFADF;AAGD;;AACDZ,MAAAA,kBAAkB,CAACa,IAAI,CAACC,GAAL,CAASf,eAAe,GAAG,CAA3B,EAA8B,CAA9B,CAAD,CAAlB;AACD,KAPD;;AAQA,QAAIgB,iBAAiB,GAAG,MAAM;AAC5Bb,MAAAA,mBAAmB,CAACD,gBAAgB,GAAG,CAApB,CAAnB;AACD,KAFD;;AAGA,QAAIe,mBAAmB,GAAG,MAAM;AAC9B,UAAIf,gBAAgB,GAAG,CAAnB,GAAuB,CAA3B,EAA8B;AAC5BU,cAAIC,IAAJ,CACE,kFADF;AAGD;;AACDV,MAAAA,mBAAmB,CAACW,IAAI,CAACC,GAAL,CAASb,gBAAgB,GAAG,CAA5B,EAA+B,CAA/B,CAAD,CAAnB;AACD,KAPD;;AASAL,IAAAA,IAAI,CACDqB,EADH,CACMC,yBAAUC,mBADhB,EACqCV,gBADrC,EAEGQ,EAFH,CAEMC,yBAAUE,qBAFhB,EAEuCV,kBAFvC,EAGGO,EAHH,CAGMC,yBAAUG,cAHhB,EAGgCN,iBAHhC,EAIGE,EAJH,CAIMC,yBAAUI,gBAJhB,EAIkCN,mBAJlC;AAMA,WAAO,MAAM;AACXpB,MAAAA,IAAI,CACD2B,GADH,CACOL,yBAAUC,mBADjB,EACsCV,gBADtC,EAEGc,GAFH,CAEOL,yBAAUE,qBAFjB,EAEwCV,kBAFxC,EAGGa,GAHH,CAGOL,yBAAUG,cAHjB,EAGiCN,iBAHjC,EAIGQ,GAJH,CAIOL,yBAAUI,gBAJjB,EAImCN,mBAJnC;AAKD,KAND;AAOD,GA5CD,EA4CG,CAACpB,IAAD,EAAOG,eAAP,EAAwBE,gBAAxB,CA5CH;AA8CA,wBAAU,MAAM;AACd,QAAII,sBAASC,EAAT,KAAgB,KAApB,EAA2B;AACzB;AACD;;AAED,QAAIkB,UAAU,GACZ1B,sBADY,aACZA,sBADY,cACZA,sBADY,GACc2B,sDAD5B;AAEA,QAAIC,WAAW,GAAGF,UAAU,CAACrB,UAAD,EAAaN,mBAAb,CAA5B;;AAEA8B,0BAAaC,0BAAb,CAAwCF,WAAxC;AACD,GAVD,EAUG,CAACvB,UAAD,EAAaL,sBAAb,EAAqCD,mBAArC,CAVH;AAWD;;AAED,SAASO,sBAAT,CACEyB,WADF,EAEEC,YAFF,EAGmB;AACjB,MAAID,WAAW,GAAG,CAAd,IAAmBC,YAAY,GAAG,CAAtC,EAAyC;AACvC,WAAO,gBAAP;AACD,GAFD,MAEO,IAAID,WAAW,GAAG,CAAd,IAAmBC,YAAY,KAAK,CAAxC,EAA2C;AAChD,WAAO,WAAP;AACD,GAFM,MAEA,IAAID,WAAW,KAAK,CAAhB,IAAqBC,YAAY,GAAG,CAAxC,EAA2C;AAChD,WAAO,YAAP;AACD,GAFM,MAEA;AACL,WAAO,MAAP;AACD;AACF;;AAED,SAASvB,uBAAT,CAAiCX,IAAjC,EAAqD;AACnD,SAAOA,IAAI,CAACmC,gBAAL,CAAsBC,WAAtB,CAAkCC,OAAlC,CAA0CC,MAAjD;AACD;;AAED,SAAS1B,wBAAT,CAAkCZ,IAAlC,EAAsD;AACpD,MAAIoC,WAAW,GAAG,CAAlB;AACApC,EAAAA,IAAI,CAACuC,YAAL,CAAkBC,OAAlB,CAA2BC,WAAD,IAAiB;AACzCL,IAAAA,WAAW,IAAIK,WAAW,CAACL,WAAZ,CAAwBC,OAAxB,CAAgCC,MAA/C;AACD,GAFD;AAIA,SAAOF,WAAP;AACD","sourcesContent":["import { useState, useEffect, useMemo } from 'react';\nimport { Platform } from 'react-native';\nimport { RoomEvent, type Room } from 'livekit-client';\nimport AudioSession, {\n  getDefaultAppleAudioConfigurationForMode,\n  type AppleAudioConfiguration,\n  type AudioTrackState,\n} from './AudioSession';\nimport { log } from '..';\n\n/**\n * Handles setting the appropriate AVAudioSession options automatically\n * depending on the audio track states of the Room.\n *\n * @param room\n * @param preferSpeakerOutput\n * @param onConfigureNativeAudio\n */\nexport function useIOSAudioManagement(\n  room: Room,\n  preferSpeakerOutput: boolean = true,\n  onConfigureNativeAudio?: (\n    trackState: AudioTrackState,\n    preferSpeakerOutput: boolean\n  ) => AppleAudioConfiguration\n) {\n  const [localTrackCount, setLocalTrackCount] = useState(0);\n  const [remoteTrackCount, setRemoteTrackCount] = useState(0);\n  const trackState = useMemo(\n    () => computeAudioTrackState(localTrackCount, remoteTrackCount),\n    [localTrackCount, remoteTrackCount]\n  );\n\n  useEffect(() => {\n    if (Platform.OS !== 'ios') {\n      return () => {};\n    }\n\n    setLocalTrackCount(getLocalAudioTrackCount(room));\n    setRemoteTrackCount(getRemoteAudioTrackCount(room));\n\n    let onLocalPublished = () => {\n      setLocalTrackCount(localTrackCount + 1);\n    };\n    let onLocalUnpublished = () => {\n      if (localTrackCount - 1 < 0) {\n        log.warn(\n          'mismatched local audio track count! attempted to reduce track count below zero.'\n        );\n      }\n      setLocalTrackCount(Math.max(localTrackCount - 1, 0));\n    };\n    let onRemotePublished = () => {\n      setRemoteTrackCount(remoteTrackCount + 1);\n    };\n    let onRemoteUnpublished = () => {\n      if (remoteTrackCount - 1 < 0) {\n        log.warn(\n          'mismatched remote audio track count! attempted to reduce track count below zero.'\n        );\n      }\n      setRemoteTrackCount(Math.max(remoteTrackCount - 1, 0));\n    };\n\n    room\n      .on(RoomEvent.LocalTrackPublished, onLocalPublished)\n      .on(RoomEvent.LocalTrackUnpublished, onLocalUnpublished)\n      .on(RoomEvent.TrackPublished, onRemotePublished)\n      .on(RoomEvent.TrackUnpublished, onRemoteUnpublished);\n\n    return () => {\n      room\n        .off(RoomEvent.LocalTrackPublished, onLocalPublished)\n        .off(RoomEvent.LocalTrackUnpublished, onLocalUnpublished)\n        .off(RoomEvent.TrackPublished, onRemotePublished)\n        .off(RoomEvent.TrackUnpublished, onRemoteUnpublished);\n    };\n  }, [room, localTrackCount, remoteTrackCount]);\n\n  useEffect(() => {\n    if (Platform.OS !== 'ios') {\n      return;\n    }\n\n    let configFunc =\n      onConfigureNativeAudio ?? getDefaultAppleAudioConfigurationForMode;\n    let audioConfig = configFunc(trackState, preferSpeakerOutput);\n\n    AudioSession.setAppleAudioConfiguration(audioConfig);\n  }, [trackState, onConfigureNativeAudio, preferSpeakerOutput]);\n}\n\nfunction computeAudioTrackState(\n  localTracks: number,\n  remoteTracks: number\n): AudioTrackState {\n  if (localTracks > 0 && remoteTracks > 0) {\n    return 'localAndRemote';\n  } else if (localTracks > 0 && remoteTracks === 0) {\n    return 'localOnly';\n  } else if (localTracks === 0 && remoteTracks > 0) {\n    return 'remoteOnly';\n  } else {\n    return 'none';\n  }\n}\n\nfunction getLocalAudioTrackCount(room: Room): number {\n  return room.localParticipant.audioTracks.entries.length;\n}\n\nfunction getRemoteAudioTrackCount(room: Room): number {\n  var audioTracks = 0;\n  room.participants.forEach((participant) => {\n    audioTracks += participant.audioTracks.entries.length;\n  });\n\n  return audioTracks;\n}\n"]}
+{"version":3,"sources":["AudioManager.ts"],"names":["useIOSAudioManagement","room","preferSpeakerOutput","onConfigureNativeAudio","localTrackCount","setLocalTrackCount","remoteTrackCount","setRemoteTrackCount","trackState","computeAudioTrackState","Platform","OS","getLocalAudioTrackCount","getRemoteAudioTrackCount","onLocalPublished","onLocalUnpublished","log","warn","Math","max","onRemotePublished","onRemoteUnpublished","on","RoomEvent","LocalTrackPublished","LocalTrackUnpublished","TrackPublished","TrackUnpublished","off","configFunc","getDefaultAppleAudioConfigurationForMode","audioConfig","AudioSession","setAppleAudioConfiguration","localTracks","remoteTracks","localParticipant","audioTracks","entries","length","participants","forEach","participant"],"mappings":";;;;;;;AAAA;;AACA;;AACA;;AACA;;AAKA;;;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,qBAAT,CACLC,IADK,EAOL;AAAA,MALAC,mBAKA,uEAL+B,IAK/B;AAAA,MAJAC,sBAIA;AACA,QAAM,CAACC,eAAD,EAAkBC,kBAAlB,IAAwC,qBAAS,CAAT,CAA9C;AACA,QAAM,CAACC,gBAAD,EAAmBC,mBAAnB,IAA0C,qBAAS,CAAT,CAAhD;AACA,QAAMC,UAAU,GAAG,oBACjB,MAAMC,sBAAsB,CAACL,eAAD,EAAkBE,gBAAlB,CADX,EAEjB,CAACF,eAAD,EAAkBE,gBAAlB,CAFiB,CAAnB;AAKA,wBAAU,MAAM;AACd,QAAII,sBAASC,EAAT,KAAgB,KAApB,EAA2B;AACzB,aAAO,MAAM,CAAE,CAAf;AACD;;AAEDN,IAAAA,kBAAkB,CAACO,uBAAuB,CAACX,IAAD,CAAxB,CAAlB;AACAM,IAAAA,mBAAmB,CAACM,wBAAwB,CAACZ,IAAD,CAAzB,CAAnB;;AAEA,QAAIa,gBAAgB,GAAG,MAAM;AAC3BT,MAAAA,kBAAkB,CAACD,eAAe,GAAG,CAAnB,CAAlB;AACD,KAFD;;AAGA,QAAIW,kBAAkB,GAAG,MAAM;AAC7B,UAAIX,eAAe,GAAG,CAAlB,GAAsB,CAA1B,EAA6B;AAC3BY,cAAIC,IAAJ,CACE,iFADF;AAGD;;AACDZ,MAAAA,kBAAkB,CAACa,IAAI,CAACC,GAAL,CAASf,eAAe,GAAG,CAA3B,EAA8B,CAA9B,CAAD,CAAlB;AACD,KAPD;;AAQA,QAAIgB,iBAAiB,GAAG,MAAM;AAC5Bb,MAAAA,mBAAmB,CAACD,gBAAgB,GAAG,CAApB,CAAnB;AACD,KAFD;;AAGA,QAAIe,mBAAmB,GAAG,MAAM;AAC9B,UAAIf,gBAAgB,GAAG,CAAnB,GAAuB,CAA3B,EAA8B;AAC5BU,cAAIC,IAAJ,CACE,kFADF;AAGD;;AACDV,MAAAA,mBAAmB,CAACW,IAAI,CAACC,GAAL,CAASb,gBAAgB,GAAG,CAA5B,EAA+B,CAA/B,CAAD,CAAnB;AACD,KAPD;;AASAL,IAAAA,IAAI,CACDqB,EADH,CACMC,yBAAUC,mBADhB,EACqCV,gBADrC,EAEGQ,EAFH,CAEMC,yBAAUE,qBAFhB,EAEuCV,kBAFvC,EAGGO,EAHH,CAGMC,yBAAUG,cAHhB,EAGgCN,iBAHhC,EAIGE,EAJH,CAIMC,yBAAUI,gBAJhB,EAIkCN,mBAJlC;AAMA,WAAO,MAAM;AACXpB,MAAAA,IAAI,CACD2B,GADH,CACOL,yBAAUC,mBADjB,EACsCV,gBADtC,EAEGc,GAFH,CAEOL,yBAAUE,qBAFjB,EAEwCV,kBAFxC,EAGGa,GAHH,CAGOL,yBAAUG,cAHjB,EAGiCN,iBAHjC,EAIGQ,GAJH,CAIOL,yBAAUI,gBAJjB,EAImCN,mBAJnC;AAKD,KAND;AAOD,GA5CD,EA4CG,CAACpB,IAAD,EAAOG,eAAP,EAAwBE,gBAAxB,CA5CH;AA8CA,wBAAU,MAAM;AACd,QAAII,sBAASC,EAAT,KAAgB,KAApB,EAA2B;AACzB;AACD;;AAED,QAAIkB,UAAU,GACZ1B,sBADY,aACZA,sBADY,cACZA,sBADY,GACc2B,sDAD5B;AAEA,QAAIC,WAAW,GAAGF,UAAU,CAACrB,UAAD,EAAaN,mBAAb,CAA5B;;AAEA8B,0BAAaC,0BAAb,CAAwCF,WAAxC;AACD,GAVD,EAUG,CAACvB,UAAD,EAAaL,sBAAb,EAAqCD,mBAArC,CAVH;AAWD;;AAED,SAASO,sBAAT,CACEyB,WADF,EAEEC,YAFF,EAGmB;AACjB,MAAID,WAAW,GAAG,CAAd,IAAmBC,YAAY,GAAG,CAAtC,EAAyC;AACvC,WAAO,gBAAP;AACD,GAFD,MAEO,IAAID,WAAW,GAAG,CAAd,IAAmBC,YAAY,KAAK,CAAxC,EAA2C;AAChD,WAAO,WAAP;AACD,GAFM,MAEA,IAAID,WAAW,KAAK,CAAhB,IAAqBC,YAAY,GAAG,CAAxC,EAA2C;AAChD,WAAO,YAAP;AACD,GAFM,MAEA;AACL,WAAO,MAAP;AACD;AACF;;AAED,SAASvB,uBAAT,CAAiCX,IAAjC,EAAqD;AACnD,SAAOA,IAAI,CAACmC,gBAAL,CAAsBC,WAAtB,CAAkCC,OAAlC,CAA0CC,MAAjD;AACD;;AAED,SAAS1B,wBAAT,CAAkCZ,IAAlC,EAAsD;AACpD,MAAIoC,WAAW,GAAG,CAAlB;AACApC,EAAAA,IAAI,CAACuC,YAAL,CAAkBC,OAAlB,CAA2BC,WAAD,IAAiB;AACzCL,IAAAA,WAAW,IAAIK,WAAW,CAACL,WAAZ,CAAwBC,OAAxB,CAAgCC,MAA/C;AACD,GAFD;AAIA,SAAOF,WAAP;AACD","sourcesContent":["import { useState, useEffect, useMemo } from 'react';\nimport { Platform } from 'react-native';\nimport { RoomEvent, type Room } from 'livekit-client';\nimport AudioSession, {\n  getDefaultAppleAudioConfigurationForMode,\n  type AppleAudioConfiguration,\n  type AudioTrackState,\n} from './AudioSession';\nimport { log } from '..';\n\n/**\n * Handles setting the appropriate AVAudioSession options automatically\n * depending on the audio track states of the Room.\n *\n * @param room\n * @param preferSpeakerOutput\n * @param onConfigureNativeAudio A custom method for determining options used.\n */\nexport function useIOSAudioManagement(\n  room: Room,\n  preferSpeakerOutput: boolean = true,\n  onConfigureNativeAudio?: (\n    trackState: AudioTrackState,\n    preferSpeakerOutput: boolean\n  ) => AppleAudioConfiguration\n) {\n  const [localTrackCount, setLocalTrackCount] = useState(0);\n  const [remoteTrackCount, setRemoteTrackCount] = useState(0);\n  const trackState = useMemo(\n    () => computeAudioTrackState(localTrackCount, remoteTrackCount),\n    [localTrackCount, remoteTrackCount]\n  );\n\n  useEffect(() => {\n    if (Platform.OS !== 'ios') {\n      return () => {};\n    }\n\n    setLocalTrackCount(getLocalAudioTrackCount(room));\n    setRemoteTrackCount(getRemoteAudioTrackCount(room));\n\n    let onLocalPublished = () => {\n      setLocalTrackCount(localTrackCount + 1);\n    };\n    let onLocalUnpublished = () => {\n      if (localTrackCount - 1 < 0) {\n        log.warn(\n          'mismatched local audio track count! attempted to reduce track count below zero.'\n        );\n      }\n      setLocalTrackCount(Math.max(localTrackCount - 1, 0));\n    };\n    let onRemotePublished = () => {\n      setRemoteTrackCount(remoteTrackCount + 1);\n    };\n    let onRemoteUnpublished = () => {\n      if (remoteTrackCount - 1 < 0) {\n        log.warn(\n          'mismatched remote audio track count! attempted to reduce track count below zero.'\n        );\n      }\n      setRemoteTrackCount(Math.max(remoteTrackCount - 1, 0));\n    };\n\n    room\n      .on(RoomEvent.LocalTrackPublished, onLocalPublished)\n      .on(RoomEvent.LocalTrackUnpublished, onLocalUnpublished)\n      .on(RoomEvent.TrackPublished, onRemotePublished)\n      .on(RoomEvent.TrackUnpublished, onRemoteUnpublished);\n\n    return () => {\n      room\n        .off(RoomEvent.LocalTrackPublished, onLocalPublished)\n        .off(RoomEvent.LocalTrackUnpublished, onLocalUnpublished)\n        .off(RoomEvent.TrackPublished, onRemotePublished)\n        .off(RoomEvent.TrackUnpublished, onRemoteUnpublished);\n    };\n  }, [room, localTrackCount, remoteTrackCount]);\n\n  useEffect(() => {\n    if (Platform.OS !== 'ios') {\n      return;\n    }\n\n    let configFunc =\n      onConfigureNativeAudio ?? getDefaultAppleAudioConfigurationForMode;\n    let audioConfig = configFunc(trackState, preferSpeakerOutput);\n\n    AudioSession.setAppleAudioConfiguration(audioConfig);\n  }, [trackState, onConfigureNativeAudio, preferSpeakerOutput]);\n}\n\nfunction computeAudioTrackState(\n  localTracks: number,\n  remoteTracks: number\n): AudioTrackState {\n  if (localTracks > 0 && remoteTracks > 0) {\n    return 'localAndRemote';\n  } else if (localTracks > 0 && remoteTracks === 0) {\n    return 'localOnly';\n  } else if (localTracks === 0 && remoteTracks > 0) {\n    return 'remoteOnly';\n  } else {\n    return 'none';\n  }\n}\n\nfunction getLocalAudioTrackCount(room: Room): number {\n  return room.localParticipant.audioTracks.entries.length;\n}\n\nfunction getRemoteAudioTrackCount(room: Room): number {\n  var audioTracks = 0;\n  room.participants.forEach((participant) => {\n    audioTracks += participant.audioTracks.entries.length;\n  });\n\n  return audioTracks;\n}\n"]}

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","AndroidAudioTypePresets","communication","manageAudioFocus","audioMode","audioFocusMode","audioStreamType","audioAttributesUsageType","audioAttributesContentType","media","getDefaultAppleAudioConfigurationForMode","mode","preferSpeakerOutput","audioCategory","audioCategoryOptions","AudioSession","config","configureAudio","startAudioSession","stopAudioSession","OS","getAudioOutputs","deviceId","selectAudioOutput","showAudioRoutePicker","setAppleAudioConfiguration"],"mappings":"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","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 type AppleAudioMode =\n  | 'default'\n  | 'gameChat'\n  | 'measurement'\n  | 'moviePlayback'\n  | 'spokenAudio'\n  | 'videoChat'\n  | 'videoRecording'\n  | 'voiceChat'\n  | 'voicePrompt';\n\nexport type AppleAudioCategory =\n  | 'soloAmbient'\n  | 'playback'\n  | 'record'\n  | 'playAndRecord'\n  | 'multiRoute';\n\nexport type AppleAudioCategoryOption =\n  | 'mixWithOthers'\n  | 'duckOthers'\n  | 'interruptSpokenAudioAndMixWithOthers'\n  | 'allowBluetooth'\n  | 'allowBluetoothA2DP'\n  | 'allowAirPlay'\n  | 'defaultToSpeaker';\n\nexport type AppleAudioConfiguration = {\n  audioCategory?: AppleAudioCategory;\n  audioCategoryOptions?: AppleAudioCategoryOption[];\n  audioMode?: AppleAudioMode;\n};\n\nexport type AudioTrackState =\n  | 'none'\n  | 'remoteOnly'\n  | 'localOnly'\n  | 'localAndRemote';\n\nexport function getDefaultAppleAudioConfigurationForMode(\n  mode: AudioTrackState,\n  preferSpeakerOutput: boolean = true\n): AppleAudioConfiguration {\n  if (mode === 'remoteOnly') {\n    return {\n      audioCategory: 'playback',\n      audioCategoryOptions: ['mixWithOthers'],\n      audioMode: 'spokenAudio',\n    };\n  } else if (mode === 'localAndRemote' || mode === 'localOnly') {\n    return {\n      audioCategory: 'playAndRecord',\n      audioCategoryOptions: ['allowBluetooth', 'mixWithOthers'],\n      audioMode: preferSpeakerOutput ? 'videoChat' : 'voiceChat',\n    };\n  }\n\n  return {\n    audioCategory: 'soloAmbient',\n    audioCategoryOptions: [],\n    audioMode: 'default',\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   * ----\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  static setAppleAudioConfiguration = async (\n    config: AppleAudioConfiguration\n  ) => {\n    if (Platform.OS === 'ios') {\n      await LivekitReactNative.setAppleAudioConfiguration(config);\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","getDefaultAppleAudioConfigurationForMode","mode","preferSpeakerOutput","audioCategory","audioCategoryOptions","AudioSession","config","configureAudio","startAudioSession","stopAudioSession","OS","getAudioOutputs","deviceId","selectAudioOutput","showAudioRoutePicker","setAppleAudioConfiguration"],"mappings":"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","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 type AppleAudioMode =\n  | 'default'\n  | 'gameChat'\n  | 'measurement'\n  | 'moviePlayback'\n  | 'spokenAudio'\n  | 'videoChat'\n  | 'videoRecording'\n  | 'voiceChat'\n  | 'voicePrompt';\n\nexport type AppleAudioCategory =\n  | 'soloAmbient'\n  | 'playback'\n  | 'record'\n  | 'playAndRecord'\n  | 'multiRoute';\n\nexport type AppleAudioCategoryOption =\n  | 'mixWithOthers'\n  | 'duckOthers'\n  | 'interruptSpokenAudioAndMixWithOthers'\n  | 'allowBluetooth'\n  | 'allowBluetoothA2DP'\n  | 'allowAirPlay'\n  | 'defaultToSpeaker';\n\nexport type AppleAudioConfiguration = {\n  audioCategory?: AppleAudioCategory;\n  audioCategoryOptions?: AppleAudioCategoryOption[];\n  audioMode?: AppleAudioMode;\n};\n\nexport type AudioTrackState =\n  | 'none'\n  | 'remoteOnly'\n  | 'localOnly'\n  | 'localAndRemote';\n\nexport function getDefaultAppleAudioConfigurationForMode(\n  mode: AudioTrackState,\n  preferSpeakerOutput: boolean = true\n): AppleAudioConfiguration {\n  if (mode === 'remoteOnly') {\n    return {\n      audioCategory: 'playback',\n      audioCategoryOptions: ['mixWithOthers'],\n      audioMode: 'spokenAudio',\n    };\n  } else if (mode === 'localAndRemote' || mode === 'localOnly') {\n    return {\n      audioCategory: 'playAndRecord',\n      audioCategoryOptions: ['allowBluetooth', 'mixWithOthers'],\n      audioMode: preferSpeakerOutput ? 'videoChat' : 'voiceChat',\n    };\n  }\n\n  return {\n    audioCategory: 'soloAmbient',\n    audioCategoryOptions: [],\n    audioMode: 'default',\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   * See also useIOSAudioManagement for automatic configuration of iOS audio options.\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  static setAppleAudioConfiguration = async (\n    config: AppleAudioConfiguration\n  ) => {\n    if (Platform.OS === 'ios') {\n      await LivekitReactNative.setAppleAudioConfiguration(config);\n    }\n  };\n}\n"]}

package/lib/module/audio/AudioManager.js

@@ -9,7 +9,7 @@ import { log } from '..';
  *
  * @param room
  * @param preferSpeakerOutput
- * @param onConfigureNativeAudio
+ * @param onConfigureNativeAudio A custom method for determining options used.
  */
 
 export function useIOSAudioManagement(room) {

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

@@ -1 +1 @@
-{"version":3,"sources":["AudioManager.ts"],"names":["useState","useEffect","useMemo","Platform","RoomEvent","AudioSession","getDefaultAppleAudioConfigurationForMode","log","useIOSAudioManagement","room","preferSpeakerOutput","onConfigureNativeAudio","localTrackCount","setLocalTrackCount","remoteTrackCount","setRemoteTrackCount","trackState","computeAudioTrackState","OS","getLocalAudioTrackCount","getRemoteAudioTrackCount","onLocalPublished","onLocalUnpublished","warn","Math","max","onRemotePublished","onRemoteUnpublished","on","LocalTrackPublished","LocalTrackUnpublished","TrackPublished","TrackUnpublished","off","configFunc","audioConfig","setAppleAudioConfiguration","localTracks","remoteTracks","localParticipant","audioTracks","entries","length","participants","forEach","participant"],"mappings":"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","sourcesContent":["import { useState, useEffect, useMemo } from 'react';\nimport { Platform } from 'react-native';\nimport { RoomEvent, type Room } from 'livekit-client';\nimport AudioSession, {\n  getDefaultAppleAudioConfigurationForMode,\n  type AppleAudioConfiguration,\n  type AudioTrackState,\n} from './AudioSession';\nimport { log } from '..';\n\n/**\n * Handles setting the appropriate AVAudioSession options automatically\n * depending on the audio track states of the Room.\n *\n * @param room\n * @param preferSpeakerOutput\n * @param onConfigureNativeAudio\n */\nexport function useIOSAudioManagement(\n  room: Room,\n  preferSpeakerOutput: boolean = true,\n  onConfigureNativeAudio?: (\n    trackState: AudioTrackState,\n    preferSpeakerOutput: boolean\n  ) => AppleAudioConfiguration\n) {\n  const [localTrackCount, setLocalTrackCount] = useState(0);\n  const [remoteTrackCount, setRemoteTrackCount] = useState(0);\n  const trackState = useMemo(\n    () => computeAudioTrackState(localTrackCount, remoteTrackCount),\n    [localTrackCount, remoteTrackCount]\n  );\n\n  useEffect(() => {\n    if (Platform.OS !== 'ios') {\n      return () => {};\n    }\n\n    setLocalTrackCount(getLocalAudioTrackCount(room));\n    setRemoteTrackCount(getRemoteAudioTrackCount(room));\n\n    let onLocalPublished = () => {\n      setLocalTrackCount(localTrackCount + 1);\n    };\n    let onLocalUnpublished = () => {\n      if (localTrackCount - 1 < 0) {\n        log.warn(\n          'mismatched local audio track count! attempted to reduce track count below zero.'\n        );\n      }\n      setLocalTrackCount(Math.max(localTrackCount - 1, 0));\n    };\n    let onRemotePublished = () => {\n      setRemoteTrackCount(remoteTrackCount + 1);\n    };\n    let onRemoteUnpublished = () => {\n      if (remoteTrackCount - 1 < 0) {\n        log.warn(\n          'mismatched remote audio track count! attempted to reduce track count below zero.'\n        );\n      }\n      setRemoteTrackCount(Math.max(remoteTrackCount - 1, 0));\n    };\n\n    room\n      .on(RoomEvent.LocalTrackPublished, onLocalPublished)\n      .on(RoomEvent.LocalTrackUnpublished, onLocalUnpublished)\n      .on(RoomEvent.TrackPublished, onRemotePublished)\n      .on(RoomEvent.TrackUnpublished, onRemoteUnpublished);\n\n    return () => {\n      room\n        .off(RoomEvent.LocalTrackPublished, onLocalPublished)\n        .off(RoomEvent.LocalTrackUnpublished, onLocalUnpublished)\n        .off(RoomEvent.TrackPublished, onRemotePublished)\n        .off(RoomEvent.TrackUnpublished, onRemoteUnpublished);\n    };\n  }, [room, localTrackCount, remoteTrackCount]);\n\n  useEffect(() => {\n    if (Platform.OS !== 'ios') {\n      return;\n    }\n\n    let configFunc =\n      onConfigureNativeAudio ?? getDefaultAppleAudioConfigurationForMode;\n    let audioConfig = configFunc(trackState, preferSpeakerOutput);\n\n    AudioSession.setAppleAudioConfiguration(audioConfig);\n  }, [trackState, onConfigureNativeAudio, preferSpeakerOutput]);\n}\n\nfunction computeAudioTrackState(\n  localTracks: number,\n  remoteTracks: number\n): AudioTrackState {\n  if (localTracks > 0 && remoteTracks > 0) {\n    return 'localAndRemote';\n  } else if (localTracks > 0 && remoteTracks === 0) {\n    return 'localOnly';\n  } else if (localTracks === 0 && remoteTracks > 0) {\n    return 'remoteOnly';\n  } else {\n    return 'none';\n  }\n}\n\nfunction getLocalAudioTrackCount(room: Room): number {\n  return room.localParticipant.audioTracks.entries.length;\n}\n\nfunction getRemoteAudioTrackCount(room: Room): number {\n  var audioTracks = 0;\n  room.participants.forEach((participant) => {\n    audioTracks += participant.audioTracks.entries.length;\n  });\n\n  return audioTracks;\n}\n"]}
+{"version":3,"sources":["AudioManager.ts"],"names":["useState","useEffect","useMemo","Platform","RoomEvent","AudioSession","getDefaultAppleAudioConfigurationForMode","log","useIOSAudioManagement","room","preferSpeakerOutput","onConfigureNativeAudio","localTrackCount","setLocalTrackCount","remoteTrackCount","setRemoteTrackCount","trackState","computeAudioTrackState","OS","getLocalAudioTrackCount","getRemoteAudioTrackCount","onLocalPublished","onLocalUnpublished","warn","Math","max","onRemotePublished","onRemoteUnpublished","on","LocalTrackPublished","LocalTrackUnpublished","TrackPublished","TrackUnpublished","off","configFunc","audioConfig","setAppleAudioConfiguration","localTracks","remoteTracks","localParticipant","audioTracks","entries","length","participants","forEach","participant"],"mappings":"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","sourcesContent":["import { useState, useEffect, useMemo } from 'react';\nimport { Platform } from 'react-native';\nimport { RoomEvent, type Room } from 'livekit-client';\nimport AudioSession, {\n  getDefaultAppleAudioConfigurationForMode,\n  type AppleAudioConfiguration,\n  type AudioTrackState,\n} from './AudioSession';\nimport { log } from '..';\n\n/**\n * Handles setting the appropriate AVAudioSession options automatically\n * depending on the audio track states of the Room.\n *\n * @param room\n * @param preferSpeakerOutput\n * @param onConfigureNativeAudio A custom method for determining options used.\n */\nexport function useIOSAudioManagement(\n  room: Room,\n  preferSpeakerOutput: boolean = true,\n  onConfigureNativeAudio?: (\n    trackState: AudioTrackState,\n    preferSpeakerOutput: boolean\n  ) => AppleAudioConfiguration\n) {\n  const [localTrackCount, setLocalTrackCount] = useState(0);\n  const [remoteTrackCount, setRemoteTrackCount] = useState(0);\n  const trackState = useMemo(\n    () => computeAudioTrackState(localTrackCount, remoteTrackCount),\n    [localTrackCount, remoteTrackCount]\n  );\n\n  useEffect(() => {\n    if (Platform.OS !== 'ios') {\n      return () => {};\n    }\n\n    setLocalTrackCount(getLocalAudioTrackCount(room));\n    setRemoteTrackCount(getRemoteAudioTrackCount(room));\n\n    let onLocalPublished = () => {\n      setLocalTrackCount(localTrackCount + 1);\n    };\n    let onLocalUnpublished = () => {\n      if (localTrackCount - 1 < 0) {\n        log.warn(\n          'mismatched local audio track count! attempted to reduce track count below zero.'\n        );\n      }\n      setLocalTrackCount(Math.max(localTrackCount - 1, 0));\n    };\n    let onRemotePublished = () => {\n      setRemoteTrackCount(remoteTrackCount + 1);\n    };\n    let onRemoteUnpublished = () => {\n      if (remoteTrackCount - 1 < 0) {\n        log.warn(\n          'mismatched remote audio track count! attempted to reduce track count below zero.'\n        );\n      }\n      setRemoteTrackCount(Math.max(remoteTrackCount - 1, 0));\n    };\n\n    room\n      .on(RoomEvent.LocalTrackPublished, onLocalPublished)\n      .on(RoomEvent.LocalTrackUnpublished, onLocalUnpublished)\n      .on(RoomEvent.TrackPublished, onRemotePublished)\n      .on(RoomEvent.TrackUnpublished, onRemoteUnpublished);\n\n    return () => {\n      room\n        .off(RoomEvent.LocalTrackPublished, onLocalPublished)\n        .off(RoomEvent.LocalTrackUnpublished, onLocalUnpublished)\n        .off(RoomEvent.TrackPublished, onRemotePublished)\n        .off(RoomEvent.TrackUnpublished, onRemoteUnpublished);\n    };\n  }, [room, localTrackCount, remoteTrackCount]);\n\n  useEffect(() => {\n    if (Platform.OS !== 'ios') {\n      return;\n    }\n\n    let configFunc =\n      onConfigureNativeAudio ?? getDefaultAppleAudioConfigurationForMode;\n    let audioConfig = configFunc(trackState, preferSpeakerOutput);\n\n    AudioSession.setAppleAudioConfiguration(audioConfig);\n  }, [trackState, onConfigureNativeAudio, preferSpeakerOutput]);\n}\n\nfunction computeAudioTrackState(\n  localTracks: number,\n  remoteTracks: number\n): AudioTrackState {\n  if (localTracks > 0 && remoteTracks > 0) {\n    return 'localAndRemote';\n  } else if (localTracks > 0 && remoteTracks === 0) {\n    return 'localOnly';\n  } else if (localTracks === 0 && remoteTracks > 0) {\n    return 'remoteOnly';\n  } else {\n    return 'none';\n  }\n}\n\nfunction getLocalAudioTrackCount(room: Room): number {\n  return room.localParticipant.audioTracks.entries.length;\n}\n\nfunction getRemoteAudioTrackCount(room: Room): number {\n  var audioTracks = 0;\n  room.participants.forEach((participant) => {\n    audioTracks += participant.audioTracks.entries.length;\n  });\n\n  return audioTracks;\n}\n"]}

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","AndroidAudioTypePresets","communication","manageAudioFocus","audioMode","audioFocusMode","audioStreamType","audioAttributesUsageType","audioAttributesContentType","media","getDefaultAppleAudioConfigurationForMode","mode","preferSpeakerOutput","audioCategory","audioCategoryOptions","AudioSession","config","configureAudio","startAudioSession","stopAudioSession","OS","getAudioOutputs","deviceId","selectAudioOutput","showAudioRoutePicker","setAppleAudioConfiguration"],"mappings":"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","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 type AppleAudioMode =\n  | 'default'\n  | 'gameChat'\n  | 'measurement'\n  | 'moviePlayback'\n  | 'spokenAudio'\n  | 'videoChat'\n  | 'videoRecording'\n  | 'voiceChat'\n  | 'voicePrompt';\n\nexport type AppleAudioCategory =\n  | 'soloAmbient'\n  | 'playback'\n  | 'record'\n  | 'playAndRecord'\n  | 'multiRoute';\n\nexport type AppleAudioCategoryOption =\n  | 'mixWithOthers'\n  | 'duckOthers'\n  | 'interruptSpokenAudioAndMixWithOthers'\n  | 'allowBluetooth'\n  | 'allowBluetoothA2DP'\n  | 'allowAirPlay'\n  | 'defaultToSpeaker';\n\nexport type AppleAudioConfiguration = {\n  audioCategory?: AppleAudioCategory;\n  audioCategoryOptions?: AppleAudioCategoryOption[];\n  audioMode?: AppleAudioMode;\n};\n\nexport type AudioTrackState =\n  | 'none'\n  | 'remoteOnly'\n  | 'localOnly'\n  | 'localAndRemote';\n\nexport function getDefaultAppleAudioConfigurationForMode(\n  mode: AudioTrackState,\n  preferSpeakerOutput: boolean = true\n): AppleAudioConfiguration {\n  if (mode === 'remoteOnly') {\n    return {\n      audioCategory: 'playback',\n      audioCategoryOptions: ['mixWithOthers'],\n      audioMode: 'spokenAudio',\n    };\n  } else if (mode === 'localAndRemote' || mode === 'localOnly') {\n    return {\n      audioCategory: 'playAndRecord',\n      audioCategoryOptions: ['allowBluetooth', 'mixWithOthers'],\n      audioMode: preferSpeakerOutput ? 'videoChat' : 'voiceChat',\n    };\n  }\n\n  return {\n    audioCategory: 'soloAmbient',\n    audioCategoryOptions: [],\n    audioMode: 'default',\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   * ----\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  static setAppleAudioConfiguration = async (\n    config: AppleAudioConfiguration\n  ) => {\n    if (Platform.OS === 'ios') {\n      await LivekitReactNative.setAppleAudioConfiguration(config);\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","getDefaultAppleAudioConfigurationForMode","mode","preferSpeakerOutput","audioCategory","audioCategoryOptions","AudioSession","config","configureAudio","startAudioSession","stopAudioSession","OS","getAudioOutputs","deviceId","selectAudioOutput","showAudioRoutePicker","setAppleAudioConfiguration"],"mappings":"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","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 type AppleAudioMode =\n  | 'default'\n  | 'gameChat'\n  | 'measurement'\n  | 'moviePlayback'\n  | 'spokenAudio'\n  | 'videoChat'\n  | 'videoRecording'\n  | 'voiceChat'\n  | 'voicePrompt';\n\nexport type AppleAudioCategory =\n  | 'soloAmbient'\n  | 'playback'\n  | 'record'\n  | 'playAndRecord'\n  | 'multiRoute';\n\nexport type AppleAudioCategoryOption =\n  | 'mixWithOthers'\n  | 'duckOthers'\n  | 'interruptSpokenAudioAndMixWithOthers'\n  | 'allowBluetooth'\n  | 'allowBluetoothA2DP'\n  | 'allowAirPlay'\n  | 'defaultToSpeaker';\n\nexport type AppleAudioConfiguration = {\n  audioCategory?: AppleAudioCategory;\n  audioCategoryOptions?: AppleAudioCategoryOption[];\n  audioMode?: AppleAudioMode;\n};\n\nexport type AudioTrackState =\n  | 'none'\n  | 'remoteOnly'\n  | 'localOnly'\n  | 'localAndRemote';\n\nexport function getDefaultAppleAudioConfigurationForMode(\n  mode: AudioTrackState,\n  preferSpeakerOutput: boolean = true\n): AppleAudioConfiguration {\n  if (mode === 'remoteOnly') {\n    return {\n      audioCategory: 'playback',\n      audioCategoryOptions: ['mixWithOthers'],\n      audioMode: 'spokenAudio',\n    };\n  } else if (mode === 'localAndRemote' || mode === 'localOnly') {\n    return {\n      audioCategory: 'playAndRecord',\n      audioCategoryOptions: ['allowBluetooth', 'mixWithOthers'],\n      audioMode: preferSpeakerOutput ? 'videoChat' : 'voiceChat',\n    };\n  }\n\n  return {\n    audioCategory: 'soloAmbient',\n    audioCategoryOptions: [],\n    audioMode: 'default',\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   * See also useIOSAudioManagement for automatic configuration of iOS audio options.\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  static setAppleAudioConfiguration = async (\n    config: AppleAudioConfiguration\n  ) => {\n    if (Platform.OS === 'ios') {\n      await LivekitReactNative.setAppleAudioConfiguration(config);\n    }\n  };\n}\n"]}

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

@@ -6,6 +6,6 @@ import { type AppleAudioConfiguration, type AudioTrackState } from './AudioSessi
  *
  * @param room
  * @param preferSpeakerOutput
- * @param onConfigureNativeAudio
+ * @param onConfigureNativeAudio A custom method for determining options used.
  */
 export declare function useIOSAudioManagement(room: Room, preferSpeakerOutput?: boolean, onConfigureNativeAudio?: (trackState: AudioTrackState, preferSpeakerOutput: boolean) => AppleAudioConfiguration): void;

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

@@ -115,6 +115,8 @@ export default class AudioSession {
      * Applies the provided audio configuration to the underlying AudioSession.
      *
      * Must be called prior to connecting to a Room for the configuration to apply correctly.
+     *
+     * See also useIOSAudioManagement for automatic configuration of iOS audio options.
      */
     static configureAudio: (config: AudioConfiguration) => Promise<void>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livekit/react-native",
-  "version": "1.4.0",
+  "version": "1.4.3",
   "description": "LiveKit for React Native",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -80,7 +80,7 @@
     "typescript": "4.8.4"
   },
   "peerDependencies": {
-    "@livekit/react-native-webrtc": "^104.0.1",
+    "@livekit/react-native-webrtc": "^114.0.0",
     "react": "*",
     "react-native": "*"
   },

package/src/audio/AudioManager.ts

@@ -14,7 +14,7 @@ import { log } from '..';
  *
  * @param room
  * @param preferSpeakerOutput
- * @param onConfigureNativeAudio
+ * @param onConfigureNativeAudio A custom method for determining options used.
  */
 export function useIOSAudioManagement(
   room: Room,

package/src/audio/AudioSession.ts

@@ -248,6 +248,8 @@ export default class AudioSession {
    * Applies the provided audio configuration to the underlying AudioSession.
    *
    * Must be called prior to connecting to a Room for the configuration to apply correctly.
+   *
+   * See also useIOSAudioManagement for automatic configuration of iOS audio options.
    */
   static configureAudio = async (config: AudioConfiguration) => {
     await LivekitReactNative.configureAudio(config);