Release notes

v2.4.0

v2.4.0 was released on March 19, 2025. This release includes the following changes:

• Internal optimizations to support Agora Conversational AI Engine.
• Updates the built-in Web SDK to v4.23.2. For details on the changes between Web SDK v4.22.0 to v4.23.2, see the Web SDK release notes.
• Fixes an issue where network state changes could unexpectedly create new tracks.

v2.3.0

v2.3.0 was released on August 21, 2024.

This version updates the built-in Web SDK to v4.22.0. For more details on the changes between Web SDK v4.21.0 and 4.22 .0, see the Web SDK release notes.

v2.2.0

v2.2.0 was released on June 13, 2024.

This version updates the built-in Web SDK to v4.21.0. For more details on the changes between Web SDK v4.20.0 and 4.21.0, see the Web SDK release notes.

v2.1.0

v2.1.0 was released on January 5, 2024.

This version updates the built-in SDK for Web in the SDK for React JS to version 4.20.0. Check the related changes in the Web SDK release notes.

v2.0.0

v2.0.0 was released on December 22, 2023.

Compatibility changes

SDK structural optimization

The SDK for ReactJS is developed based on the SDK for Web v4.x. To further enhance usability, this version incorporates all Web SDK APIs into the ReactJS SDK, eliminating the need to integrate the Web SDK separately.

Upon upgrading to this version, make the following modifications:

• Reintegrate the React SDK. Taking npm as an example:

  # Remove existing dependencies
  npm uninstall agora-rtc-react agora-rtc-sdk-ng
  # Reinstall dependencies
  npm install agora-rtc-react

• Adjust the import of the AgoraRTC interface from the Web SDK. Taking the combined import of AgoraRTC and AgoraRTCProvider as an example:

  // Before this version
  import AgoraRTC from "agora-rtc-sdk-ng";
  import { AgoraRTCProvider } from "agora-rtc-react";
  // As of this version
  import AgoraRTC, { AgoraRTCProvider } from "agora-rtc-react"

NetworkQuality renaming

To avoid redundancy with the Web SDK's API, this version makes the following changes to the ReactJS SDK's NetworkQuality interface:

• Rename NetworkQuality to NetworkQualityEx and have NetworkQualityEx inherit the NetworkQuality interface from the Web SDK.
• Rename the uplink and downlink properties to uplinkNetworkQuality and downlinkNetworkQuality, respectively.

If you use the NetworkQuality interface from the ReactJS SDK, make the necessary code modifications after upgrading to this version.

Improvements

This version adds the cameraVideoTrackConfig parameter to useLocalCameraTrack, enabling you to set video capture configurations such as capture devices and encoder when creating a camera video track.

Fixed issues

This version fixed the issue that the SDK threw the error CAN_NOT_PUBLISH_MULTIPLE_VIDEO_TRACKS in Firefox's developer mode.

API Changes

Added

• cameraVideoTrackConfig to useLocalCameraTrack

Modified

• NetworkQuality to NetworkQualityEx
  • uplink to uplinkNetworkQuality
  • downlink to downlinkNetworkQuality