# 发版说明 (/zh-CN/realtime-media/rtc/reference/release-notes/react) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## v2.5.1 [#v251] 该版本于 2025 年 12 月 17 日发布。 该版本将 React SDK 中内置的 Web SDK 更新为 4.24.2 版本。相关改动可以查看 [Web SDK 发版说明](/zh-CN/realtime-media/rtc/reference/release-notes/web#v4.24.2)。 ## v2.5.0 [#v250] 该版本于 2025 年 8 月 13 日发布。 该版本将 React SDK 中内置的 Web SDK 更新为 4.24.0 版本。相关改动可以查看 [Web SDK 发版说明](/zh-CN/realtime-media/rtc/reference/release-notes/web#v4.24.0)。 ## v2.4.0 [#v240-1] 该版本于 2025 年 3 月 18 日发布。主要改动点如下: - 为支持[声网对话式 AI 引擎](/zh-CN/ai)作了一些内部改进。 - 将 React SDK 中内置的 Web SDK 更新为 4.23.2 版本。相关改动可以查看 [Web SDK 发版说明](/zh-CN/realtime-media/rtc/reference/release-notes/web)。 - 修复了网络状态发生改变可能意外创建新 Track 的问题。 ## v2.3.0 [#v230] 该版本于 2024 年 8 月 21 日发布。 该版本将 React SDK 中内置的 Web SDK 更新为 4.22.0 版本。相关改动可以查看 [Web SDK 发版说明](/zh-CN/realtime-media/rtc/reference/release-notes/web#v4.22.0)。 ## v2.2.0 [#v220] 该版本于 2024 年 6 月 13 日发布。 此版本对 React SDK 进行了升级,将内置的 Web SDK 更新至 4.21.0 版本。如需了解 Web SDK 4.20.0 到 4.21.0 版本间的变更详情,可以查看 [Web SDK 发版说明](/zh-CN/realtime-media/rtc/reference/release-notes/web)。 ## v2.1.0 [#v210] 该版本于 2023 年 12 月 27 日发布。 该版本将 React SDK 中内置的 Web SDK 更新为 4.20.0 版本。相关改动可以查看 [Web SDK 发版说明](/zh-CN/realtime-media/rtc/reference/release-notes/web#v4.20.0)。 ## v2.0.0 [#v200] 该版本于 2023 年 12 月 7 日发布。 ### 升级必看 [#升级必看-103] #### SDK 优化结构 [#sdk-优化结构] React SDK 基于 Web SDK 4.x 开发。为进一步提升易用性,该版本在 React SDK 中内置了 Web SDK 提供的所有 API,你不需要再单独集成 Web SDK。 升级到该版本后,你需要进行以下修改: - 重新集成 React SDK,以 npm 集成为例: ```shell # 移除已有依赖 npm uninstall agora-rtc-react agora-rtc-sdk-ng # 重新安装依赖 npm install agora-rtc-react ``` - 修改 Web SDK 提供的 `AgoraRTC` 接口类的引入方式,以同时引入 `AgoraRTC` 和 `AgoraRTCProvider` 为例: ```jsx // 该版本之前 import AgoraRTC from "agora-rtc-sdk-ng"; import { AgoraRTCProvider } from "agora-rtc-react"; // highlight-start // 升级到该版本后 import AgoraRTC, { AgoraRTCProvider } from "agora-rtc-react" // highlight-end ``` #### NetworkQuality 更名 [#networkquality-更名] 为避免与 Web SDK 的 API 产生冗余,该版本对 React SDK 的 `NetworkQuality` 接口类进行了以下改动: - `NetworkQuality` 改名为 `NetworkQualityEx` 并且继承 Web SDK 的 `NetworkQuality` 接口类 - `uplink`、`downlink` 属性分别改名为 `uplinkNetworkQuality`、`downlinkNetworkQuality` 如果你使用了 React SDK 的 `NetworkQuality` 接口类,升级到该版本后请修改相关代码。 ### 改进 [#改进-166] 该版本在 `useLocalCameraTrack` 中新增 `cameraVideoTrackConfig` 参数,方便你在创建摄像头视频轨道时进行视频采集的配置,包括采集设备、编码配置等。 ### 问题修复 [#问题修复-174] 该版本修复了 SDK 在 Firefox 的开发者模式下报错 `CAN_NOT_PUBLISH_MULTIPLE_VIDEO_TRACKS` 的问题。 ### API 变更 [#api-变更-84] #### 修改 [#修改-25] - `NetworkQuality` 改为 `NetworkQualityEx` - `uplink` 属性改为 `uplinkNetworkQuality` - `downlink` 属性改为 `downlinkNetworkQuality` - `useLocalCameraTrack` 中新增 `cameraVideoTrackConfig` 参数 ## v2.0.0-beta.0 [#v200-beta0] 该版本于 2023 年 8 月 8 日发布。这是 RTC React SDK 的第一个版本。 该版本提供了用于实时音视频基础功能的组件和 Hook,可以简化 UI 和状态管理。 :::warning[注意] RTC React SDK 目前处于 Public Beta 阶段,某些功能细节可能会在随后的版本中发生改变,以提升用户体验。 :::