@livekit/react-native 1.2.0 → 1.4.0

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,47 @@ 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 function getDefaultAppleAudioConfigurationForMode(mode) {
+  let preferSpeakerOutput = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+
+  if (mode === 'remoteOnly') {
+    return {
+      audioCategory: 'playback',
+      audioCategoryOptions: ['mixWithOthers'],
+      audioMode: 'spokenAudio'
+    };
+  } else if (mode === 'localAndRemote' || mode === 'localOnly') {
+    return {
+      audioCategory: 'playAndRecord',
+      audioCategoryOptions: ['allowBluetooth', 'mixWithOthers'],
+      audioMode: preferSpeakerOutput ? 'videoChat' : 'voiceChat'
+    };
+  }
+
+  return {
+    audioCategory: 'soloAmbient',
+    audioCategoryOptions: [],
+    audioMode: 'default'
+  };
+}
 export default class AudioSession {}
 
 _defineProperty(AudioSession, "configureAudio", async config => {
@@ -74,4 +113,10 @@ _defineProperty(AudioSession, "showAudioRoutePicker", async () => {
     await LivekitReactNative.showAudioRoutePicker();
   }
 });
+
+_defineProperty(AudioSession, "setAppleAudioConfiguration", async config => {
+  if (Platform.OS === 'ios') {
+    await LivekitReactNative.setAppleAudioConfiguration(config);
+  }
+});
 //# sourceMappingURL=AudioSession.js.map

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","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"]}

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, AppleAudioCategory, AppleAudioCategoryOption, AppleAudioConfiguration, AppleAudioMode, AudioTrackState, getDefaultAppleAudioConfigurationForMode } 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,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 };
+export * from './logger';
+export * from './audio/AudioManager';
+export { AudioSession, AndroidAudioTypeOptions, AndroidAudioTypePresets, AppleAudioCategory, AppleAudioCategoryOption, AppleAudioConfiguration, AppleAudioMode, AudioTrackState, getDefaultAppleAudioConfigurationForMode };
 //# 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","AppleAudioCategory","AppleAudioCategoryOption","AppleAudioConfiguration","AppleAudioMode","AudioTrackState","getDefaultAppleAudioConfigurationForMode","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,EAGEC,kBAHF,EAIEC,wBAJF,EAKEC,uBALF,EAMEC,cANF,EAOEC,eAPF,EAQEC,wCARF,QASO,sBATP;AAWA,SAASC,UAAT,EAAqBC,QAArB,QAAqC,cAArC;;AAIA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASb,eAAT,GAA2B;AAChCC,EAAAA,qBAAqB;AACrBa,EAAAA,sBAAsB;AACtBZ,EAAAA,gBAAgB;AAChBa,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,cAAc,UAAd;AACA,cAAc,sBAAd;AAEA,SACE/B,YADF,EAGEE,uBAHF,EAIED,uBAJF,EAKEE,kBALF,EAMEC,wBANF,EAOEC,uBAPF,EAQEC,cARF,EASEC,eATF,EAUEC,wCAVF","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  AppleAudioCategory,\n  AppleAudioCategoryOption,\n  AppleAudioConfiguration,\n  AppleAudioMode,\n  AudioTrackState,\n  getDefaultAppleAudioConfigurationForMode,\n} from './audio/AudioSession';\nimport type { AudioConfiguration } from './audio/AudioSession';\nimport { PixelRatio, Platform } from 'react-native';\nimport type { LiveKitReactNativeInfo } from 'livekit-client';\nimport type { LogLevel, SetLogLevelOptions } from './logger';\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 * from './logger';\nexport * from './audio/AudioManager';\n\nexport {\n  AudioSession,\n  AudioConfiguration,\n  AndroidAudioTypeOptions,\n  AndroidAudioTypePresets,\n  AppleAudioCategory,\n  AppleAudioCategoryOption,\n  AppleAudioConfiguration,\n  AppleAudioMode,\n  AudioTrackState,\n  getDefaultAppleAudioConfigurationForMode,\n  LogLevel,\n  SetLogLevelOptions,\n};\n"]}

package/lib/module/logger.js

@@ -0,0 +1,18 @@
+import { setLogLevel as setClientSdkLogLevel } from 'livekit-client';
+import loglevel from 'loglevel';
+export const log = loglevel.getLogger('lk-react-native');
+log.setDefaultLevel('WARN');
+
+/**
+ * Set the log level for both the `@livekit/react-native` package and the `@livekit-client` package.
+ * To set the `@livekit-client` log independently, use the `liveKitClientLogLevel` prop on the `options` object.
+ * @public
+ */
+export function setLogLevel(level) {
+  var _options$liveKitClien;
+
+  let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  log.setLevel(level);
+  setClientSdkLogLevel((_options$liveKitClien = options.liveKitClientLogLevel) !== null && _options$liveKitClien !== void 0 ? _options$liveKitClien : level);
+}
+//# sourceMappingURL=logger.js.map

package/lib/module/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["logger.ts"],"names":["setLogLevel","setClientSdkLogLevel","loglevel","log","getLogger","setDefaultLevel","level","options","setLevel","liveKitClientLogLevel"],"mappings":"AAAA,SAASA,WAAW,IAAIC,oBAAxB,QAAoD,gBAApD;AACA,OAAOC,QAAP,MAAqB,UAArB;AAEA,OAAO,MAAMC,GAAG,GAAGD,QAAQ,CAACE,SAAT,CAAmB,iBAAnB,CAAZ;AACPD,GAAG,CAACE,eAAJ,CAAoB,MAApB;;AAOA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASL,WAAT,CACLM,KADK,EAGC;AAAA;;AAAA,MADNC,OACM,uEADwB,EACxB;AACNJ,EAAAA,GAAG,CAACK,QAAJ,CAAaF,KAAb;AACAL,EAAAA,oBAAoB,0BAACM,OAAO,CAACE,qBAAT,yEAAkCH,KAAlC,CAApB;AACD","sourcesContent":["import { setLogLevel as setClientSdkLogLevel } from 'livekit-client';\nimport loglevel from 'loglevel';\n\nexport const log = loglevel.getLogger('lk-react-native');\nlog.setDefaultLevel('WARN');\n\nexport type LogLevel = Parameters<typeof setClientSdkLogLevel>[0];\nexport type SetLogLevelOptions = {\n  liveKitClientLogLevel?: LogLevel;\n};\n\n/**\n * Set the log level for both the `@livekit/react-native` package and the `@livekit-client` package.\n * To set the `@livekit-client` log independently, use the `liveKitClientLogLevel` prop on the `options` object.\n * @public\n */\nexport function setLogLevel(\n  level: LogLevel,\n  options: SetLogLevelOptions = {}\n): void {\n  log.setLevel(level);\n  setClientSdkLogLevel(options.liveKitClientLogLevel ?? level);\n}\n"]}

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

@@ -0,0 +1,11 @@
+import { type Room } from 'livekit-client';
+import { type AppleAudioConfiguration, type AudioTrackState } from './AudioSession';
+/**
+ * Handles setting the appropriate AVAudioSession options automatically
+ * depending on the audio track states of the Room.
+ *
+ * @param room
+ * @param preferSpeakerOutput
+ * @param onConfigureNativeAudio
+ */
+export declare function useIOSAudioManagement(room: Room, preferSpeakerOutput?: boolean, onConfigureNativeAudio?: (trackState: AudioTrackState, preferSpeakerOutput: boolean) => AppleAudioConfiguration): void;

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,88 @@
 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 declare type AppleAudioMode = 'default' | 'gameChat' | 'measurement' | 'moviePlayback' | 'spokenAudio' | 'videoChat' | 'videoRecording' | 'voiceChat' | 'voicePrompt';
+export declare type AppleAudioCategory = 'soloAmbient' | 'playback' | 'record' | 'playAndRecord' | 'multiRoute';
+export declare type AppleAudioCategoryOption = 'mixWithOthers' | 'duckOthers' | 'interruptSpokenAudioAndMixWithOthers' | 'allowBluetooth' | 'allowBluetoothA2DP' | 'allowAirPlay' | 'defaultToSpeaker';
+export declare type AppleAudioConfiguration = {
+    audioCategory?: AppleAudioCategory;
+    audioCategoryOptions?: AppleAudioCategoryOption[];
+    audioMode?: AppleAudioMode;
+};
+export declare type AudioTrackState = 'none' | 'remoteOnly' | 'localOnly' | 'localAndRemote';
+export declare function getDefaultAppleAudioConfigurationForMode(mode: AudioTrackState, preferSpeakerOutput?: boolean): AppleAudioConfiguration;
 export default class AudioSession {
     /**
      * Applies the provided audio configuration to the underlying AudioSession.
@@ -63,9 +136,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:
@@ -94,4 +164,5 @@ export default class AudioSession {
      * Displays an AVRoutePickerView for the user to choose their audio output.
      */
     static showAudioRoutePicker: () => Promise<void>;
+    static setAppleAudioConfiguration: (config: AppleAudioConfiguration) => Promise<void>;
 }

package/lib/typescript/index.d.ts

@@ -1,5 +1,7 @@
-import AudioSession from './audio/AudioSession';
+import 'fastestsmallesttextencoderdecoder';
+import AudioSession, { AndroidAudioTypePresets, AndroidAudioTypeOptions, AppleAudioCategory, AppleAudioCategoryOption, AppleAudioConfiguration, AppleAudioMode, AudioTrackState, getDefaultAppleAudioConfigurationForMode } from './audio/AudioSession';
 import type { AudioConfiguration } from './audio/AudioSession';
+import type { LogLevel, SetLogLevelOptions } from './logger';
 /**
  * Registers the required globals needed for LiveKit to work.
  *
@@ -9,4 +11,6 @@ export declare function registerGlobals(): void;
 export * from './components/VideoView';
 export * from './useParticipant';
 export * from './useRoom';
-export { AudioSession, AudioConfiguration };
+export * from './logger';
+export * from './audio/AudioManager';
+export { AudioSession, AudioConfiguration, AndroidAudioTypeOptions, AndroidAudioTypePresets, AppleAudioCategory, AppleAudioCategoryOption, AppleAudioConfiguration, AppleAudioMode, AudioTrackState, getDefaultAppleAudioConfigurationForMode, LogLevel, SetLogLevelOptions, };

package/lib/typescript/logger.d.ts

@@ -0,0 +1,13 @@
+import { setLogLevel as setClientSdkLogLevel } from 'livekit-client';
+import loglevel from 'loglevel';
+export declare const log: loglevel.Logger;
+export declare type LogLevel = Parameters<typeof setClientSdkLogLevel>[0];
+export declare type SetLogLevelOptions = {
+    liveKitClientLogLevel?: LogLevel;
+};
+/**
+ * Set the log level for both the `@livekit/react-native` package and the `@livekit-client` package.
+ * To set the `@livekit-client` log independently, use the `liveKitClientLogLevel` prop on the `options` object.
+ * @public
+ */
+export declare function setLogLevel(level: LogLevel, options?: SetLogLevelOptions): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livekit/react-native",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "LiveKit for React Native",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -43,19 +43,23 @@
   ],
   "dependencies": {
     "array.prototype.at": "^1.1.1",
-    "livekit-client": "^1.8.0",
+    "fastestsmallesttextencoderdecoder": "^1.0.22",
+    "livekit-client": "^1.15.0",
+    "loglevel": "^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",
     "@babel/preset-env": "^7.20.0",
     "@babel/runtime": "^7.20.0",
     "@commitlint/config-conventional": "^16.2.1",
-    "@livekit/react-native-webrtc": "^104.0.1",
+    "@livekit/react-native-webrtc": "^114.0.0",
     "@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",
@@ -69,7 +73,7 @@
     "pod-install": "^0.1.0",
     "prettier": "^2.5.1",
     "react": "18.0.0",
-    "react-native": "0.69.5",
+    "react-native": "0.71.13",
     "react-native-builder-bob": "^0.18.2",
     "release-it": "^14.2.2",
     "typedoc": "^0.23.14",

package/src/audio/AudioManager.ts

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