Skip to main content
Version: 1.x.x

Release Notes - React Native

This page will keep you updated on all the releases of React Native SDK.

v2.0.0​

Release Date: 11th October 2026

Review the Migration Guide before upgrading.

npm install @videosdk.live/react-native-sdk@2.0.0

Change Log:

  • The meeting is now a room — MeetingProvider → RoomProvider, MeetingConsumer → RoomConsumer, useMeeting() → useRoom(), meetingId → roomId, name → optional participantName, webcamEnabled → optional camEnabled, localWebcamOn → isCamEnabled, localMicOn → isMicEnabled, enableWebcam() → enableCam(), disableWebcam() → disableCam(), onMeetingStateChanged → onRoomStateChanged, useStream() → useRTCStream() and Constants.errors → Constants.VideoSDKError. Nine error names changed from MEETING to ROOM, such as INVALID_ROOM_ID; their numeric codes are unchanged.
  • Other renames — getAudioDeviceList() → getMics(), switchAudioDevice() → setAudioDevice(), useKeyProvider() → BaseKeyProvider, onChatMessage → onDataReceived, RTCView's mirror → setMirror, and state callbacks pass state instead of status. The facingMode values "user" and "environment" are now "front" and "back".
  • Native setup — Uninstall @videosdk.live/react-native-webrtc and @videosdk.live/react-native-incallmanager, and delete every register() call. On Android, add the snapshot repository https://central.sonatype.com/repository/maven-snapshots/ to android/build.gradle. On iOS, add the VideoSDKRTC pod to your Podfile and set the deployment target to 18.0.
  • Ask for permission before you join — On Android, the SDK no longer asks for camera and microphone access. Call requestPermission() from useMediaDevice() before you join.
  • RoomProvider lifetime — RoomProvider leaves the room when it unmounts. Keep it mounted for as long as the call lasts.
  • Screen sharing — enableScreenShare() accepts a track created with createScreenShareVideoTrack(). System audio is set with withAudio, on Android only. On iOS, enableScreenShare() opens the system broadcast picker.
  • End-to-end encryption — The keyProvider prop is replaced by setKeyProvider() and setParticipantKey(); set the keys before you join. new BaseKeyProvider() takes no arguments, so remove discardFrameWhenCryptorNotReady. setKeyProvider(null) rejects with ERROR_INVALID_PARAMETER (3073); call removeKeyProvider() to turn encryption off.
  • Streams and tracks — The track factories return CustomStreamTrack objects, which have their own toURL() and are released with stop(). Render participant streams with new MediaStream([stream.track]).toURL(). A stopped or released track is refused with ERROR_INVALID_CUSTOM_VIDEO_TRACK (3029) for video or ERROR_INVALID_CUSTOM_AUDIO_TRACK (3030) for audio.
  • Video processors — Register a processor with VideoProcessorRegistry in your Android and iOS app code, then select it by name with setVideoProcessor().
  • Audio devices — onAudioDeviceChanged of useMediaDevice() receives a Map of device id to device instead of { selectedAudioDevice, availableDevices }.
  • Media relay — onMediaRelayRequestResponse reports decision as "ACCEPTED" or "REJECTED" (Constants.RelayDecision).
  • RTCView — The default objectFit is "cover".
  • Error handling — Camera and microphone failures use general error codes, such as 3017 and 3018, instead of ERROR_RN_* codes. A wrong-typed or missing argument to an SDK call rejects with ERROR_INVALID_PARAMETER (3073), and so does setLogLevel() with an unknown level.
  • Removed APIs — debugMode, register(), mediaDevices, permissions, useCharacter(), useConnection(), mainParticipant, onHlsStarted, onHlsStopped, useParticipant().switchTo(), and external video (startVideo(), stopVideo(), pauseVideo(), resumeVideo(), seekVideo(), onVideoStateChanged, onVideoSeeked). Virtual backgrounds are no longer available through @videosdk.live/react-native-media-effects.

New Features:

  • Realtime translation — useTranslation(), with the speakingLanguage and translationLanguage options on RoomProvider.
  • Camera effects — Auto-framing, low-light enhancement, style effects and colour filters with setVideoEffects(), getAppliedVideoEffectsConfig() and publishFramingSubject().
  • iOS video processors — Run your own frame processor on iOS as well as Android.
  • Image capture — Flash for still captures with captureImage({ flash: "ON" }) on the local participant.
  • Applied video settings — getAppliedVideoConfig() on useRoom() returns the camera settings in use.
  • Encryption keys — setParticipantKey() sets or rotates one participant's key, also during a room, and removeKeyProvider() turns encryption off.
  • External phone calls — onExternalCallRinging, onExternalCallAnswered, onExternalCallRejected and onExternalCallHangup on useRoom().

The Migration Guide lists every change and every new API.

v1.0.1​

Release Date: 14th August 2026

Improvements:

  • Downgraded the Android dependencies and Gradle version to improve compatibility with older versions of React Native, Expo, and Android.

v1.0.0​

Release Date: 7th August 2026

Major release - contains breaking changes. See the Migration Guide.

Change Log:

  • New PubSub: usePubSub rebuilt for higher throughput and better backpressure handling.
    • New signature usePubSub(topic, listeners?, properties?) - listeners and properties are now separate positional arguments.
    • onBatchReceived for high-throughput topics; onMessageDrop reports when messages were shed.
    • Backpressure control via realtimeOverflow ("queue" | "drop"), maxQueue, newMessageLimit, oldMessageLimit.
    • onOldMessagesReceived now receives a second argument { isLast }.
  • Promise-based API: Every method returned from useMeeting, useParticipant, useMediaStream, etc. now returns a Promise and throws on failure with code, name, and message - errors surface at the call site instead of only on onError.
  • Consistent tracks across events: The SDK now persists your custom track config for the lifetime of the meeting - pass it once and it's reused on later enableWebcam() / unmuteMic() calls, and preserved across mode changes and reconnects.
  • Introduced ERROR_OPERATION_TIMED_OUT (3079), raised by any method whose request goes unanswered - whether the server did not respond in time or the connection dropped before the request could be sent.

Breaking Changes:

  • All methods return Promises - add await and try / catch; errors expose .code, .name, .message.
  • usePubSub(topic, options) → usePubSub(topic, listeners, properties); listeners and properties are now separate arguments.
  • Removed publishAudio / publishVideo / publishScreenShare and the unpublish* aliases - use unmuteMic / enableWebcam / enableScreenShare and their disable counterparts.

Bug Fixes:

  • Fixed an issue where selectedWebcam and selectedMic were not being set correctly during join.
  • Fixed stream-enabled and stream-disabled events firing before the previous media operation completed, allowing media operations such as disableWebcam() to be safely called directly from the event handler.

Docs: Migration Guide

v0.11.1​

Release Date: 23rd June 2026

Change Log:

  • When a meeting fails to join during the join() method, the SDK now triggers the onError callback from useMeeting with the corresponding error code and message, transitions to the FAILED state, and aborts the join process.

v0.11.0​

Release Date: 5th June 2026

Change Log:

  • Added support for selectable video codecs in createCameraVideoTrack(). The new codec option supports VP8, VP9, AV1, and H264 through VideoSDK.Constants.VideoCodec.
  • Added the following Agent Participant APIs:
    • consumeWebcamStreams()
    • consumeMicStreams()
    • stopConsumingWebcamStreams()
    • stopConsumingMicStreams()
  • Introduced the runPreCallTest() method to evaluate a user's environment before joining a meeting.
  • Removed the deprecated getNetworkStats() method; use runPreCallTest() for richer media and network diagnostics.

Bug Fixes:

  • Fixed an issue in createMicrophoneAudioTrack() where the selected audio profile was not applied correctly.
  • Fixed an issue in the useAgentParticipant() hook where passing a regular participant ID (or vice versa) could result in an unexpected error.
  • Fixed an issue with the crash of the captureImage() method.

Docs :

  1. Codec
  2. runPreCallTest()

v0.10.1​

Release Date: 24th April 2026

Change Log:

  • Removed the requirement for Bluetooth permissions to join a meeting.
  • Agent transcript segments now include a new type field.

v0.10.0​

Release Date: 13th April 2026

Bug Fixes:

v0.9.0​

Release Date: 18th March 2026

Changelog

  • Introduced useAgentParticipant hook for working with AI agents in a room. Agents can be identified using the isAgent property when they join.

    Docs: AgentParticipant

  • Added AgentState enum (IDLE, LISTENING, THINKING, SPEAKING) to represent the agent lifecycle.

    Docs: AgentState

  • Added callbacks for agent updates:

v0.8.0​

Release Date: 19th Feb 2026

Changelog

  • Configurable Log Level: Introduced the setLogLevel method in VideoSDK, enabling developers to control log verbosity. This improves debugging efficiency during development.

Documentation

v0.7.3​

Release Date: 13th December 2025

Bug Fix:

  • Fixed an issue where users did not receive remote participants’ media streams after reconnecting.

v0.7.1​

Release Date: 5th December 2025

Bug Fix:

  • Resolved an issue where the camera failed to enable when multistream was set to false.

v0.7.0​

Release Date : 3rd December 2025

Bug Fixed :

  • Resolved an issue where the onMeetingLeft event was not triggered when a local participant left due to a duplicate participant scenario.
  • Fixed the onMeetingStateChanged event behavior for SIGNALLING_ONLY and RECV_ONLY modes.

Change Log:

  • Updated the publish method in PubSub to accept only string messages. An error will now be thrown if any data type other than the string is passed.
  • Removed unsupported encoderConfig.
  • Updated the default encoderConfig value in createCameraVideoTrack() to h720p_w1280p.
  • Introduces advanced video track optimization features, enabling greater flexibility and control over quality and bandwidth. Below are the new parameters added to createCameraVideoTrack().

    • BitrateMode

      • Added the BitrateMode parameter to manage video quality and bandwidth usage easily.
      • Developers can now select from three modes based on their requirements:
        • bandwidth_optimized
        • balanced (default)
        • high_quality
        • Docs: BitrateMode

    • maxLayer

      • Introduced the maxLayer parameter to allow developers to specify the maximum number of simulcast layers published for a video track.
      • Docs: maxLayer

0.6.0​

Release Date : 21th November 2025

Change Log :

  • All trace messages are now user-facing, with improved clarity and readability.

v0.5.0​

Release Date : 6th November 2025

Change log :

  1. Realtime store – Introduced support for storing, updating, retrieving, and observing custom key-value data within a meeting in real time.

  2. meetingleft resons – Added detailed parameters to indicate the reason why a local participant left the meeting.

  3. participantleft resons – Added detailed parameters to specify the reason why a remote participant left the meeting.

  4. Adaptive Subscriptions (BETA) - Added support for dynamically adjusting media subscriptions to optimize bandwidth and performance.

  5. onQualityLimitation Event - Enables detection of bandwidth constraints, network congestion, or CPU limitations during a meeting, helping monitor local call quality in real time.

  6. useStream Hook – Introduced a new React Native hook providing direct access to media stream methods and properties for easier stream management.

  7. onStreamStateChanged Event - Added an event to detect changes in stream state (e.g., freeze, stuck, recovery) for improved monitoring of remote participants’ stream health.

docs:

  1. RealtimeStore
  2. onMeetingLeft
  3. onParticipantLeft
  4. Adaptive Subscriptions
  5. onQualityLimitation
  6. useStream
  7. onStreamStateChanged

v0.4.2​

Release Date : 29th October 2025

Improvement :

  • Made compatible with React Native 0.82+ and Expo SDK 54+.

v0.4.1​

Release Date : 14th October 2025

Bug Fixes:

  • Resolved an issue with the defaultCamera parameter in MeetingProvider.
  • Fixed the behavior of changeWebcam() to handle cases where no parameter is provided.

v0.4.0​

Release Date : 29th Sep 2025

Change Log :

  • Added support for screen share audio on Android.

Bug Fixes:

  • Resolved crashes related to FOREGROUND_SERVICE_IMMEDIATE and security vulnerabilities during screen share on Android.
  • Fixed initialization of the key provider for E2EE.
  • Corrected an issue where meeting statistics were not emitted on Android devices.

Docs:

v0.3.12​

Release Date : 9th August 2025

Change Log :

  • Introduced a new custom track profile h360p_w640p_150kbps, optimized for low-bitrate consumption at 360p resolution.

v0.3.9​

Release Date : 25th July 2025

Bug Fixes:

  • Resolved conflicts between WebRTC versions on the React Native iOS side.

v0.3.8​

Release Date : 15th July 2025

Bug Fixes:

  • Added proper mediaProjection support and required permissions to enable screen sharing on Android Q and above.
  • Updated compileSdkVersion, targetSdkVersion, and minSdkVersion for full compatibility with Android API level 34.

v0.3.7​

Release Date : 25th June 2025

Change Log :

  • Resolved a dependency issue causing failures in locating the library com.github.jiangdongguo.AndroidUSBCamera:libausbc:3.3.3.

v0.3.6​

Release Date : 18th June 2025

Change Log :

  • Fixed an error where the document property was not found when invoking the setQuality method.

v0.3.5​

Release Date : 13th June 2025

Change Log :

  • Added PiP support for iOS.

Docs:

v0.3.4​

Release Date : 20th May 2025

Change Log :

  1. Fast Channel Switching – Enables instant transitions between live streams with minimal latency.
  2. Media Relay Support – Allows hosts to share their media with other live streams for collaborative broadcasts.

Docs:

v0.3.1​

Release Date : 24th April 2025

Change Log :

  • Added support for End-to-End Encryption (E2EE) to ensure secure media transmission between participants.

Docs: E2EE

v0.3.0​

Release Date : 21st April 2025

Change Log :

  • Added pauseAllStreams() and resumeAllStreams() methods in useMeeting.
  • Added onPausedAllStreams and onResumedAllStreams event listeners.

Docs:

v0.2.0​

Release Date : 21st Jan 2025

Change Log :

  • Replaced CONFERENCE with SEND_AND_RECV and VIEWER with SIGNALLING_ONLY.
  • Added RECV_ONLY for live streaming.
  • Enabled seamless role switching using changeMode() in useMeeting.

Docs: Quick Start for Interactive Live Streaming

v0.1.19​

Release Date : 24th Oct 2024

Change Log :

  • Introduced the useWhiteboard hook for managing collaborative sessions.
  • Removed the default foreground service steps in the base implementation; add the screen share steps if required.

Got a Question? Ask us on discord

Tags:
Last updated on by Vaibhavdixit14
Previous
Supported Device OS
Next

Was this helpful?

Not helpfulHelpful