known-issues

This page provides an overview of known issues in the React Native SDK along with guidance or workarounds where available.

Issue: Audio Session Management Conflict in HLS

VideoSDK uses InCallManager to manage the iOS AVAudioSession because the SDK needs it for audio route handling (mic, speaker, Bluetooth). react-native-video also manages the audio session, which can cause conflicts when both libraries try to configure it. This may result in the mic dropping, Bluetooth routing resetting, or the app becoming unresponsive.

Fix: Set disableAudioSessionManagement={true} to prevent react-native-video from managing the audio session. For audio output changes, use VideoSDK's switchAudioDevice() method.

import Video from 'react-native-video';

<Video
  source={{ uri: hlsUrls.playbackHlsUrl }}
  style={{ flex: 1 }}
  paused={pause}
  disableAudioSessionManagement={true}
/>

This is iOS-only - Android uses AudioManager and does not have the same conflict. If you use another native module that also configures the audio session (for example, react-native-track-player), apply the same principle: only one library should manage the audio session during the meeting.

Issue: New Architecture in React Native

• Full compatibility with the New Architecture is currently under development. The team is actively working to ensure complete support and will provide updates as progress continues.
• Starting from Expo SDK 0.54 and React Native 0.81 and above, the New Architecture is required for proper functionality.

Fixes

• New Architecture issue has been fixed from 0.4.2 version.