# Release notes (/en/realtime-media/broadcast-streaming/reference/release-notes/web) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). This page provides the release notes for the Video SDK release streams used by Video Calling. * [Video SDK](#video-sdk) * [AI Noise Suppression](#ai-noise-suppression) * [Virtual background](#virtual-background) * [Super Clarity extension](#super-clarity-extension) * [Watermark extension](#watermark-extension) * [Video Compositor extension](#video-compositor-extension) * [Beauty Effect extension](#beauty-effect-extension) * [Notifications](#notifications) ## Video SDK [#video-sdk] Video Calling 4.x is a JavaScript and TypeScript library loaded by an HTML web page. The SDK library uses APIs in the web browser to establish connections and control the communication, Broadcast Streaming and Interactive Live Streaming services. ### Compatibility [#compatibility] See [Supported platforms](/en/realtime-media/video/reference/supported-platforms). ### Known issues [#known-issues] ### v4.24.5 [#v4245] Released on June 24, 2026. #### Upgrade considerations [#upgrade-considerations] * **Domain allowlist change** Starting with v4.24.5, the SDK domain allowlist is updated to: ```text .agora.io .edge.agora.io .sd-rtn.com .edge.sd-rtn.com .rtnsvc.com .edge.rtnsvc.com .rtesvc.com .edge.rtesvc.com ``` If you upgrade to v4.24.5, update your firewall allowlist so the SDK continues to work in restricted-network environments. See [Firewall requirements](/en/realtime-media/broadcast-streaming/reference/firewall). #### New features [#new-features] * **Background voice removal in AI Noise Suppression** The AI Noise Suppression extension is enhanced to remove background human voices. In noisy environments or scenarios with multiple speakers, this capability further isolates the target speaker and improves audio capture. See [Extension release notes](#ai-noise-suppression). #### Improvements [#improvements] This release includes the following improvements: * Optimized the signaling flow to improve session-setup efficiency and connection success rates in complex network environments. * Optimized media-tracing links and jitter-buffer handling to reduce first-frame time and audio and video stuttering in certain scenarios. * The audio subscription flow now uses a presubscribe model by default, improving subscription efficiency and playback stability. When full-link feedback and frame-rate-priority mode are enabled, you can now set a lower bound for resolution downgrade. #### Fixed issues [#fixed-issues] This release fixed the following issues: * Connection setup could time out in some scenarios. * The remote user received duplicate `user-joined` callbacks when a user with a string UID rejoined a channel immediately after leaving. * Messages could not be received in some scenarios. * On Safari 16.6, the local view could turn black or exit unexpectedly in some scenarios. * Remote video could freeze briefly after the first `client.publish(video)` call. * TypeScript type definition files were missing and some exported symbols were incorrect in the npm package. ### v4.24.4 [#v4244] Released on May 27, 2026. #### Improvements [#improvements-1] This release includes internal optimizations for weak-network scenarios, improving the login success rate. ### v4.24.3 [#v4243] Released on April 1, 2026. #### New features [#new-features-1] * **AI Noise Suppression extension upgrade** The AI Noise Suppression extension ([agora-extension-ai-denoiser](https://www.npmjs.com/package/agora-extension-ai-denoiser)) is upgraded to v2.0.1. This version adds a low-latency mode and the ability to configure the log level of the WASM module. For details, see [Extension release notes](#ai-noise-suppression). #### Improvements [#improvements-2] This release includes the following improvements: * Optimizes the interactive video experience in H.264 encoding scenarios. * The [Super Clarity extension](#super-clarity-extension) is upgraded to v2.0.1, with sharpening algorithm improvements that provide better video experience in some scenarios. ### v4.24.2 [#v4242] Released on December 12, 2025. This release addresses a compatibility issue introduced in Chrome 143. #### Issue description [#issue-description] During a communication session between users A and B, if user A unsubscribes and stops publishing an audio stream and then tries to publish audio again, the SDK triggers the following error: `Session error code: ERROR_CONTENT` A breaking change in Chrome causes this issue and affects all versions of the RTC Web SDK. See the [Chromium bug report](https://issues.chromium.org/issues/467468926) for details. #### Solution [#solution] This version implements a compatibility fix that prevents the issue from interrupting republishing and subscription workflows. The fix remains in place until Chrome provides an official update. The Agora R\&D team has reported the issue to the Chrome team and continues to monitor its progress. ### v4.24.1 [#v4241] Released on November 26, 2025. #### New Features [#new-features-2] * **Pre-call network test** Conducting a pre-call network test helps local users assess and predict the quality of their uplink network before starting a call. This version adds the [`startLastmileProbeTest`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartc.html#startlastmileprobetest) API, which returns information about packet loss, jitter, and round-trip time for both uplink and downlink before the call begins. * **Dual-stream mode** This version introduces the [`setDualStreamMode`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartcclient.html#setdualstreammode) method, which improves how you subscribe to dual video streams. By setting the `mode` parameter to `AUTO_SIMULCAST_MODE`, you enable adaptive low-stream mode on the sender side (low-stream is not sent by default). To send low streams, follow these steps: * The host on the receiving side calls `setRemoteVideoStreamType` to initiate a low-stream request. * The sender automatically switches to low-stream mode upon receiving the request. Additionally, you can set the mode parameter to `DISABLE_SIMULCAST_STREAM` (never send low stream) or `ENABLE_SIMULCAST_STREAM` (always send low stream). For the relationship between this method and the existing `enableDualStream` and `disableDualStream`, see the [API Reference](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartcclient.html#setdualstreammode). To ensure clear integration logic, Agora recommends that you choose one set of APIs for integration. Agora plans to deprecate `enableDualStream` and `disableDualStream` in future versions. * **Watermark extension (BETA)** This version adds the Watermark extension [`agora-extension-video-watermark`](https://www.npmjs.com/package/agora-extension-video-watermark) v1.0.0, which enables you to add image watermarks to real-time interactive video streams through an extension. The Watermark extension supports customizing the watermark's position, size, opacity, and other properties. It can be applied to both local and remote video tracks. For integration and usage steps, refer to Using the [Watermark extension guide](/en/realtime-media/video/build/apply-video-effects/watermark). * **Other New Features** Adds support for H.265 decoding. Refer to the [API Reference](https://api-ref.agora.io/en/video-sdk/web/4.x/globals.html#sdk_codec) for supported browser versions and usage restrictions. #### Improvements [#improvements-3] * **Expanded screen sharing capabilities** This version further expands screen sharing capabilities. In the `createScreenVideoTrack` API, the following parameters are added to support audio sharing during screen sharing: * `windowAudio` and `monitorTypeSurfaces` are added to [`ScreenVideoTrackInitConfig`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/screenvideotrackinitconfig.html) to control whether to allow sharing window audio and sharing the entire screen, respectively. * `suppressLocalAudioPlayback` and `restrictOwnAudio` are added to `ScreenAudioTrackInitConfig` to control whether local audio playback and capture are allowed. In screen sharing scenarios with co-hosting, Agora does not recommend sharing system or window audio, as it may cause echo. You can disable audio sharing by setting both `windowAudio` and `systemAudio` in `ScreenVideoTrackInitConfig` to `"exclude"`. * **New release of the Super Clarity extension** This version upgrades the algorithm of [`agora-extension-super-clarity`](https://www.npmjs.com/package/agora-extension-super-clarity), with improvements in reducing plugin size, enhancing video experience, and expanding browser compatibility. The new version of the plugin requires a browser that supports SIMD to run properly. For detailed changes and improvements, refer to the [Extension release notes](#super-clarity-extension). #### Bug Fixes [#bug-fixes] Fixes an issue on iOS where the system volume could not be set to `0` after destroying an audio stream. ### v4.24.0 [#v4240] Released on August 6, 2025 #### New features [#new-features-3] * **Fast first-frame rendering** Adds a new `options` parameter to the [`join`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartcclient.html#join) method to configure channel media options. When you set `autoSubscribe` to `true` in [`IJoinOptions`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/ijoinoptions.html), the user automatically subscribes to the host’s media stream when joining the channel. In real-time interactive scenarios such as one-on-one or one-to-many calls, this feature reduces the time to render the first frame and improves the overall interactive experience. Note When automatic subscription to the host’s media stream is enabled, Agora delivers the media stream and starts billing for usage as soon as the user joins the channel. #### Improvements [#improvements-4] * **Transmission optimization in poor network conditions** Optimizes the bandwidth estimation algorithm and implements audio-priority transmission. This reduces the risk of video stuttering under extremely poor network conditions and improves the smoothness of resolution switching, making transitions more seamless. The SDK also responds faster after network recovery. * **New media connection strategy** Introduces a new media connection strategy that improves the SDK’s reconnection and media login success rates under enterprise and restricted network environments. * **Improved accuracy for network quality evaluation** Enhances the algorithm for evaluating [`NetworkQuality`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/networkquality.html) by incorporating available bandwidth as a reference. This enables the SDK to more accurately reflect the impact of bandwidth-limited network conditions. This improvement requires enabling a private parameter. Contact [support@agora.io](mailto\:support@agora.io) for details. ##### Other improvements [#other-improvements] * Optimizes the default video bitrate under different encoding standards to allocate uplink bandwidth more efficiently and reduce stuttering in poor network conditions. * Improves the fallback mechanism for devices that do not support AV1 decoding. * Enhances the user experience in one-on-one calls in `rtc` mode when communicating between Web clients or between Web and Native clients. #### Issues fixed [#issues-fixed] This version fixes the following issues: * Black screen on Firefox 138+ caused by a browser version rollback. * Video stuttering caused by Safari 18.4 and 18.5. * Encoding failure when the resolution was too low. * Occasional black screen in scenarios using Plan-B. ### v4.23.4 [#v4234] Released on June 5, 2025. This release includes internal improvements. It fixes an issue where calling `setMute` or `setEnable` under certain conditions could result in no sound. If you are using SDK version 4.23.0 or later, upgrade to this release for a better user experience. ### v4.23.3 [#v4233] Released on April 29, 2025. This release updates the virtual background extension to [v2.1.0](https://www.npmjs.com/package/agora-extension-virtual-background), with the following changes: * Optimizes memory and CPU usage. * Fixes black screen issues at specific resolutions. ### v4.23.2 [#v4232] Released on March 4, 2025. This release includes the following improvements: * Internal optimizations to support [Agora Conversational AI Engine](/en/introduction/conversational-ai). * Enable audio metadata transmission * Get presentation timestamp from the audio stream For details on using these features, [submit a technical support ticket](https://agoraio.zendesk.com/hc/en-us). * Further reduced package size. ### v4.23.1 [#v4231] Released on January 17, 2025. This release includes several internal improvements. ### v4.23.0 [#v4230] Released on December 19, 2024. #### Compatibility changes [#compatibility-changes] This release modified the calculation of [`freezeRate`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/remotevideotrackstats.html#freezerate) in `RemoteVideoTrackStats`. The calculation is changed from the cumulative average freeze rate to the freeze rate in the last second. You can use this parameter to determine whether the video is experiencing a momentary freeze. To calculate the cumulative average freeze rate for the current session, use [`totalFreezeTime`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/remotevideotrackstats.html#totalfreezetime) or [`totalDuration`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/remotevideotrackstats.html#totalduration). #### New features [#new-features-4] 1. **`PeerConnection` state callback for the local media** To obtain the media connection state under poor network conditions, this release adds the [`peerconnection-state-change`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartcclient.html#event_peerconnection_state_change) event, which is used to obtain the connection state of WebRTC [RTCPeerConnection](https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection). 2. **Sharing the current tab by default** To improve the ease of use of screen sharing, this release adds the [`preferCurrentTab`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/screenvideotrackinitconfig.html#prefercurrenttab) parameter in `ScreenVideoTrackInitConfig`, which supports setting sharing the current tab as default when creating a screen sharing track. #### Improvements [#improvements-5] 1. **Improved media reconnection strategy** This release improves the media reconnection strategy, which in turn increases the reconnection and media login success rate under poor network conditions. For enterprise networks with firewalls, the improvement is particularly noticeable. Contact [support@agora.io](mailto\:support@agora.io) to try this new strategy. 2. **Improved virtual background algorithm** This release upgrades the [Virtual Background extension](https://www.npmjs.com/package/agora-extension-virtual-background/v/2.0.0) to version 2.0.0. The updated algorithm provides a more distinct face edge and clearer and more stable video images. 3. **Reduced package size** To further reduce the package size, this release separates the Plan-B feature, which is compatible with WebRTC, from the ESM-bundle package into an independent service module. Users can integrate them manually based on actual needs. For details, see [Use tree shaking](/en/realtime-media/video/build/optimize-and-operate/app-size-optimization#use-tree-shaking). 4. **Other improvements** * Optimized login duration under complex network conditions. * Optimized layer switching algorithm of VP9, which can reduce latency and improve video smoothness. Note Safari does not support VP9 SVC. #### Bug fixes [#bug-fixes-1] This release fixes the following issues: * Black screen might occur when calling `setMute` and `setEnable` under certain conditions. * Occasional audio and video stream sending failures after network disconnection and reconnection. * Users with the role of `audience` can send streams in a 128-person scene. #### API changes [#api-changes] **Added** * `AgoraRTC.on("peer-connection-state-change")` * `preferCurrentTab` in `ScreenVideoTrackInitConfig` ### v4.22.2 [#v4222] v4.22.2 was released on 29 October 2024. #### New features [#new-features-5] **Screen sharing audio 3A processing** Starting from v4.22.2, when calling the `createScreenVideoTrack` method to create a screen sharing video track, the `withAudio` parameter supports passing `ScreenAudioTrackInitConfig` to customize the initialization config of audio sharing. Depending on your use case, you can enable 3A processing (AGC, AEC, and ANS) as needed to optimize the quality of shared audio. For details, see the [API documentation](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartc.html#createscreenvideotrack). Note If your browser does not support audio sharing, passing `ScreenAudioTrackInitConfig` will only return the video track. #### API changes [#api-changes-1] This version introduces the following new APIs: * The `withAudio` parameter in the `createScreenVideoTrack` method supports passing `ScreenAudioTrackInitConfig`. ### v4.22.1 [#v4221] v4.22.1 was released on 23 September, 2024. #### Improvements [#improvements-6] This release includes several internal improvements. ### v4.22.0 [#v4220] v4.22.0 was released on 16 August, 2024. #### Compatibility changes [#compatibility-changes-1] To further reduce the package size, this version splits the Channel Media Relay Service and the Live Streaming Service from the ESM-bundle format package into independent service modules. You can manually import these modules for integration based on your actual needs. See [Use tree shaking](/en/realtime-media/video/build/optimize-and-operate/app-size-optimization#use-tree-shaking) for details on how to integrate. #### New features [#new-features-6] **Optimize channel preload** When using the channel preload feature, Agora recommends sending the host's media stream immediately when calling the method to join the channel. This reduces the first frame rendering time. For details, see [Preload channels](/en/realtime-media/video/build/join-and-manage-channels/preload-channels). With this setting, users will start pulling streams as soon as they join the channel, which will generate charges. For details on how Agora charges for the services, see [Pricing](/en/realtime-media/video/reference/pricing). **Support for AV1 encoding (Beta)** The SDK supports the AV1 video encoding format. You can enable this encoding format by setting `ClientConfig.codec` to `av1`. Compared to H.264 at the same bitrate, AV1 offers over a 30% improvement in encoding efficiency and provides better video quality. #### Improvements [#improvements-7] This version includes the following improvements: * Optimizes the SVC (Scalable Video Coding) capability for VP9 encoding and decoding, which further enhances the video quality and transmission efficiency. * Improves VAD (Voice Activity Detection) with a new music detection feature, increasing the accuracy of voice detection. #### Issues fixed [#issues-fixed-1] This version fixes the following issues: * The issue where Safari failed to retrieve `stats` in certain use-cases. * The issue with inaccurate bitrate settings under poor network conditions in certain use-cases. #### API changes [#api-changes-2] This version introduces the following new APIs: * `AgoraRTCClient.getRemoteAudioStats` adds the `receivePacketsDiscarded` return field. * `ClientConfig.codec` adds the `av1` enumeration. * The `AgoraRTC` module in the ESM-bundle adds the `use` method. ### v4.21.0 [#v4210] v4.21.0 was released on June 3, 2024. #### Compatibility changes [#compatibility-changes-2] This release introduces the Video Quality Control (VQC) module. `ICameraVideoTrack` enables the `“motion”` mode by default to ensure the smoothness of the video under low bandwidth and high CPU usage to further improve the user experience. You can call the [setOptimizationMode](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/ilocalvideotrack.html#setoptimizationmode) method to dynamically adjust the transmission mode of the video according to your needs. #### New features [#new-features-7] **Preload channels** This release adds the [AgoraRTC.preload](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartc.html#preload) method, which allows the user whose role is set to `audience` to preload channels before joining one. Calling the method can help shorten the time of joining a channel, thus reducing the time it takes for audience members to hear the host. #### Improvements [#improvements-8] This release includes the following improvements: * Enhances the bandwidth estimation and congestion control algorithms for the sender in weak network conditions, effectively reducing the buffering rate of the sender under such conditions. * Optimizes the SDK's browser compatibility detection scope to address the issue of inaccurate browser compatibility detection on certain devices. * To enhance the user experience of browsers under Safari 17.4, the video quality adaptive algorithm has been added to improve the adaptability of video quality in the case of limited network bandwidth, to further ensure the smoothness of video streaming. #### Issues fixed [#issues-fixed-2] This release fixes the following issues: * On some Android devices, the video playback status returned by `isPlaying` was inaccurate. * On Safari mobile browsers, the resolution information of the local video track returned by the `getLocalVideoStats` method was inaccurate; the resolution set by `setLowStreamParameter` for the low stream resolution did not take effect. #### API changes [#api-changes-3] **Added** * `AgoraRTC.preload` ### v4.20.2 [#v4202] v4.20.2 was released on March 21, 2024. #### Issues fixed [#issues-fixed-3] This release fixes the issue where the browser would modify the captured video resolution when calling [createCustomVideoTrack](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartc.html#createcustomvideotrack) in certain use-cases. ### v4.20.1 [#v4201] v4.20.1 was released on February 28, 2024. #### New features [#new-features-8] This release adds the following new features: **Send the SEI in the H.264 video streams** This release introduces the `LocalVideoTrack.sendSeiData` method and the `RemoteVideoTrack.on("sei-received")` event to add and send the Supplemental Enhancement Information (SEI) within the H.264 video streams. The SEI data package has a maximum size of 1KB and encompasses dynamic facial capture data, virtual video information, and digital watermarking. To enable this feature, please contact technical support. **Note:** * This functionality is only supported on Chrome 87 or later, as well as Safari 15.4 or later. * Due to the conflicts in certain browser core components, this feature is not available when [end-to-end media encryption (Beta)](/en/realtime-media/video/build/secure-and-protect-channels/media-stream-encryption) is enabled. **Monitor the video states of receivers** v4.20.1 introduces the `"video-state-changed"` event, which enables real-time monitoring of the video states of receivers, such as freezing and recovery, thereby facilitating prompt responses. For more information, see [API documentation](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iremotetrack.html#event_video_state_changed). **Data Stream Encryption** To enhance the security of data stream transmission, this version introduces a new `encryptDataStream` parameter in the `setEncryptionConfig` method for enabling data stream encryption. For more details, see [API documentation](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartcclient.html#setencryptionconfig). #### Improvements [#improvements-9] This release adds the following improvements: * Optimizes the audio reception experience on mobile devices, reducing issues such as electric noise or silence caused by browser defects in single audio stream use-cases. * Enhances video bitrate settings by adding a default setting for the minimum video bitrate. If you don't specify a value for `bitrateMin` when calling `setEncoderConfiguration`, the SDK will automatically set an appropriate bitrate based on the resolution and frame rate settings. This default setting only applies to Chrome and Edge browsers. #### Issues fixed [#issues-fixed-4] This release fixes the following issue: * In a single channel with 128 concurrent online hosts, if a user left the channel during network reconnection, it could result in the failure to subscribe to other users' audio streams for the local user. #### API changes [#api-changes-4] **Added** * `LocalVideoTrack.sendSeiData` * `RemoteVideoTrack.on("sei-received")` * `RemoteVideoTrack.on("video-state-changed")` * `encryptDataStream` parameter to `AgoraRTCClient.setEncryptionConfig` ### v4.20.0 [#v4200] v4.20.0 was released on December 8, 2023. #### Compatibility changes [#compatibility-changes-3] Prior to v4.20.0, the `IRemoteAudioTrack.setPlaybackDevice` method could be invoked on Firefox, but an echo issue would occur due to a Firefox [bug](https://bugzilla.mozilla.org/show_bug.cgi?id=1849108). To improve the user experience, starting from v4.20.0, the SDK throws a `NOT_SUPPORTED` error when this method is called. If you are using the `IRemoteAudioTrack.setPlaybackDevice` method, you need to make code modifications after upgrading to v4.20.0. #### New features [#new-features-9] On certain versions of iOS devices, the app call might not automatically resume after being interrupted by a WeChat call or system phone call. To address this issue, this release introduces the `"audio-context-state-changed"` event to monitor whether the app call has been interrupted, and the `resumeAudioContext` method to restore the app call. For usage details, refer to the [API documentation](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartc.html#resumeaudiocontext). #### Improvements [#improvements-10] This release includes the following improvements: * Reduces the time it takes to join a channel when the user ID is a string. * Supports audio sharing on the ChromeOS platform when sharing the entire screen or a Chrome tab. #### API changes [#api-changes-5] **Added** * `resumeAudioContext` * `AgoraRTC.on("audio-context-state-changed")` ### v4.19.3 [#v4193] v4.19.3 was released on November 2, 2023. #### Issues fixed [#issues-fixed-5] This release fixes a black screen issue when receiving H.264 encoded video streams on Safari prior to 16. Specifically, when a client using v4.19.2 SDK for Web made a video call on Safari prior to 16 to a client using the SDK for Android, iOS, Windows, or macOS, the web client displayed a black screen if the native client sent H.264 encoded video streams. If you have integrated v4.19.2 of the SDK, Agora recommends upgrading to v4.19.3 as soon as possible. ### v4.19.2 [#v4192] v4.19.2 was released on October 20, 2023. #### Improvements [#improvements-11] **VP9 codec (GA)** This release advances VP9 from Beta to General Availability (GA) and introduces the following enhancements: * Updated browser compatibility: VP9 now supports Safari 16.0 and later versions on both desktop and mobile platforms. * Automatic fallback to VP8 for older browsers: If any user in a channel uses a browser version below the [specified compatibility threshold](#vp9-codec), all VP9-encoded video streams in that channel will automatically transition to VP8. Test results show that VP9 provides twice the quality of VP8 at equivalent bitrates. **Dynamic resolution adjustment on Safari** Safari has a known issue where it does not automatically reduce video encoding resolution under poor network conditions or reduced video frame rates, potentially leading to blurry video. To ensure user experience, this release adds the `"720p_auto"` preset to the video encoder configurations. This preset guarantees automatic adjustment of the video encoding resolution on Safari. After upgrading to this version, if you are using a 720p video profile, Agora recommends switching to the `"720p_auto"` preset and setting the encoding format to `"vp9"` for optimal results. #### API changes [#api-changes-6] **Added** * `"720p_auto"` to `VideoEncoderConfigurationPreset` ### v4.19.1 [#v4191] v4.19.1 was released on October 11, 2023. #### Issues fixed [#issues-fixed-6] This release fixes the issue that an error occurred when using Webpack 4.x to bundle your app after integrating the SDK. ### v4.19.0 [#v4190] v4.19.0 was released on September 25, 2023. Tip After integrating this version of the SDK into your app, you might encounter an error if you use Webpack 4.x to bundle your app. To resolve this issue: * If you intend to use Webpack 4.x, upgrade the SDK to v4.19.1. * If you prefer to continue using v4.19.0, Agora recommends bundling your app with Webpack 5.x or other tools such as Vite. #### Compatibility changes [#compatibility-changes-4] **Dynamic low-quality video profile adjustment** Before 4.19.0, you had to call `setLowStreamParameter` before `publish` to set the video profile for the low-quality video stream. This meant that changing the profile after publishing required republishing, impacting the viewing experience. As of this release, you can call `setLowStreamParameter` after `publish` to dynamically adjust the resolution, bitrate, and frame rate of the low-quality video stream. Agora recommends modifying your `setLowStreamParameter` calls as needed after upgrading to this release. For example, in use-cases such as live streaming and video conferences, as the number of hosts in the channel increases, you can dynamically adjust the video profile of the low-quality video stream to relieve bandwidth pressure. #### New features [#new-features-10] **Tree shaking support** As of this release, the SDK supports [tree shaking](https://webpack.js.org/guides/tree-shaking/), which removes unused code during the build process, reducing your app's size after integrating the SDK. To use this feature, see [App size optimization](/en/realtime-media/video/build/optimize-and-operate/app-size-optimization#use-tree-shaking). **Dual display of video stream** This release adds the `clone` method, allowing you to duplicate the current camera or screen sharing video track and customize display parameters. This can be useful in use-cases such as video conferencing and online education, where you want to display the same video stream with two sets of display parameters, including resolution, frame rate, and bitrate. For example, you can have one display set to high definition and the other to low definition. **Switch between front and rear cameras** To improve camera switching on mobile devices, this release adds the `facingMode` parameter to the `ICameraVideoTrack.setDevice` method. You can specify whether to use the front or rear camera on the mobile device. See [`setDevice`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/icameravideotrack.html#setdevice) for details. **Third-party video moderation** As of this release, the SDK supports integration with third-party video moderation services. See `setImageModeration` in the [API Reference](https://api-ref.agora.io/en/video-sdk/web/4.x/index.html) for details. **Beta features** End-to-end media encryption and Super Clarity extension are released in beta. See [beta documentation](/en/realtime-media/video/reference/release-notes) for details. #### Improvements [#improvements-12] **Optimized automatic mode** In the automatic mode, the SDK initially attempts a direct connection to Agora backend. If the attempt fails, the SDK automatically switches to TCP/TLS 443. To enhance the connection experience in restricted networks, this release optimizes the SDK's automatic mode, improving connection speed and stability. The optimized automatic mode no longer uses proxies, resulting in the deprecation of the `AgoraRTCClient.on("join-fallback-to-proxy")` callback. **Other improvements** This release also includes the following improvements: * Reduces the time to first frame rendering. To enable this improvement, please [contact technical support](mailto\:support@agora.io). * Adds token expiration as a reason for a user leaving a channel in the `AgoraRTCClient.on("connection-state-change")` callback for easier troubleshooting. * Adds `sendJitterMs` and `sendRttMs` to local audio track information, reporting jitter (ms) and round-trip time (ms) for sent audio packets. #### Issues fixed [#issues-fixed-7] This release fixes the following issues: * Under normal network conditions, the SDK occasionally misreported uplink network quality as `5` in the first few seconds after joining a channel. * The local and remote audio and video packet loss rates reported by the SDK under the `currentPacketLossRate` attribute were inaccurate. * On Windows devices using Chrome 115 browser, if the local user's screen sharing remained static without mouse movement, screen sharing stopped. * During the procedure of subscribing to remote media streams, instances arose where the absence of audio was sporadically encountered by the local user when the remote user republished the audio stream. Likewise, when the remote user republished the video stream, occasional occurrences of a black screen were observed by the local user. * Memory was not promptly released after calling `IBufferSourceAudioTrack.close`. #### API changes [#api-changes-7] **Added** * `ICameraVideoTrack.clone` and `ILocalVideoTrack.clone` * `facingMode` to the `setDevice` method * `TOKEN_EXPIRE` to the `ConnectionDisconnectedReason` enum * `setImageModeration` * `AgoraRTCClient.on("image-moderation-connection-state-change")` * `ImageModerationConfiguration` * `ImageModerationConnectionState` * `sendJitterMs` and `sendRttMs` to the `LocalAudioTrackStats` interface * `sendJitterMs` and `sendRttMs` to the `LocalVideoTrackStats` interface * `getRTCRtpTransceiver` * `AgoraRTCClient.on("transceiver-updated")` **Deprecated** * `AgoraRTCClient.on("join-fallback-to-proxy")` ### v4.18.3 [#v4183] v4.18.3 was released on September 20, 2023. #### Issues fixed [#issues-fixed-8] v4.18.3 fixes the following issue: * The SDK failed to obtain audio and video statistics on Safari 17. ### v4.18.2 [#v4182] v4.18.2 was released on July 11, 2023. #### Issues fixed [#issues-fixed-9] v4.18.2 fixes the following issues: * In certain circumstances, Video SDK for Web triggered microphone and camera device permission prompts after it finished loading. ### v4.18.1 [#v4181] v4.18.1 was released on July 03, 2023. #### Improvements [#improvements-13] **Error handling support for event listeners** As of this release, when an error occurs during the execution of the callback function assigned to the event listener (`listener`), the SDK does not interrupt normal operation. Instead, the SDK captures the exception and provide error information in the logs. **Enhanced concurrency control for asynchronous methods** This release optimizes concurrency control for asynchronous methods. When the following asynchronous methods are invoked concurrently, the SDK executes them in the order they were called, ensuring consistency: * `join` and `leave` * `publish` and `unpublish` * `subscribe` and `unsubscribe` Taking `publish` and `unpublish` as an example, if you call `unpublish` immediately after calling `publish`: * In versions earlier than 4.18.1, `unpublish` might not take effect, which means the media track could remain published. * As of version 4.18.1, the actual result is consistent with the order of these method calls, which means the media track is correctly unpublished. #### Issues fixed [#issues-fixed-10] This release fixed the issue that the following callbacks were not triggered when an external camera or microphone was initially connected to a device without any available cameras or microphones: * `onCameraChanged` or `AgoraRTC.on("camera-changed")` * `onMicrophoneChanged` or `AgoraRTC.on("microphone-changed")` ### v4.18.0 [#v4180] v4.18.0 was released on June 12, 2023. #### New features [#new-features-11] **Variable playback speed for audio files** To facilitate changing the playback speed of audio effect or music files, v4.18.0 modifies the `IBufferSourceAudioTrack` class as follows: * Adds the `setAudioBufferPlaybackSpeed` method, which can be called before or after a user joins a channel. * Adds the `playbackSpeed` property to retrieve the current playback speed. **Custom signaling proxy** v4.18.0 adds the `setProxyServer` method to allow customization of the signaling proxy server used by the SDK. **Flexible event listening for AgoraRTC objects** As of v4.18.0, the `IAgoraRTC` class inherits all methods from the `EventEmitter` class, providing a flexible way of listening to all events emitted by the `AgoraRTC` object. Using `onCameraChanged` as an example: ```javascript // Previous event listening (earlier than v4.18.0) AgoraRTC.onCameraChanged = (info) => { console.log("camera changed!", info.state, info.device); }; // New event listening (v4.18.0 and later) AgoraRTC.on("camera-changed", (info) => { console.log("Camera changed!", info.state, info.device); }); ``` You can continue using the previous approach. However, for higher flexibility and extensibility, Agora recommends modifying the listening approach for the following events after upgrading the SDK: * `onAutoplayFailed` * `onCameraChanged` * `onMicrophoneChanged` * `onPlaybackDeviceChanged` * `onSecurityPolicyViolation` * `onAudioAutoplayFailed`: Deprecated, see `onAutoplayFailed` instead Scalable Video Coding, access to encoded data, and enhanced connection experience in restricted networks are released in beta. See [beta documentation](/en/realtime-media/video/reference/release-notes) for details. #### Improvements [#improvements-14] **Shorter time to join channel** As of v4.18.0, the SDK enables WebSocket message compression by default, reducing the time to join a channel in poor network conditions. **Other improvements** v4.18.0 also includes the following improvements: * Improves the retry mechanism by adding a 3s retry rule to switch a downgraded video resolution to a higher one. This prevents the video resolution from remaining low when the network conditions improve, resulting in a better user experience. * Upgrades the Cloud Proxy service to enhance its stability in different network environments. #### API changes [#api-changes-8] **Added** * `setProxyServer` * `setAudioBufferPlaybackSpeed` method and `playbackSpeed` property to `IBufferSourceAudioTrack` * The following methods inherited from the `EventEmitter` class to the `IAgoraRTC` class: * `on` * `off` * `once` * `getListeners` * `removeAllListeners` These methods support the following event names as parameters: * `"camera-changed"` * `"microphone-changed"` * `"playback-device-changed"` * `"autoplay-failed"` * `"security-policy-violation"` #### Issues fixed [#issues-fixed-11] v4.18.0 fixes the following issues: * Mobile devices experienced delays in receiving notifications for the [broadcaster leave channel event](/en/realtime-media/video/build/optimize-and-operate/receive-notifications#104-broadcaster-leave-channel). * Users experienced a black screen while watching video streams encoded with H.264 in older browser versions. * Memory usage increased when using the SDK with the Virtual Background or Image Enhancer extension. * The SDK continued to use the expired token during reconnection attempts after generating a new token using the `renewToken` method. ### v4.17.2 [#v4172] v4.17.2 was released on April 20, 2023. #### Issues fixed [#issues-fixed-12] This release fixes the issue where the `getCurrentFrameData` method returned abnormal data. ### v4.17.1 [#v4171] v4.17.1 was released on April 19, 2023. #### Compatibility changes [#compatibility-changes-5] Chrome 107 prevents users from sharing the current tab by default. If you need to allow users to share the current tab on Chrome 107 and later versions, please upgrade your SDK to v4.17.1 or later as soon as possible. To accommodate changes related to screen sharing in Chrome 107 (refer to [Chrome documentation](https://developer.chrome.com/docs/web-platform/screen-sharing-controls/)), this release introduces the following changes to the `config` parameter in the `createScreenVideoTrack` method: * Deprecates the `screenSourceType` property. If you are using this property, replace it with the newly added `displaySurface` property after upgrading to this version. * Adds new properties: `selfBrowserSurface`, `surfaceSwitching`, and `systemAudio`. For detailed explanations of these properties, see [ScreenVideoTrackInitConfig](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/screenvideotrackinitconfig.html) in the API reference. #### Improvements [#improvements-15] **Improved flexibility in setting video profiles** This release improves the flexibility in setting video profiles for different types of video tracks: * You can now specify the resolution and the frame rate when calling `createCustomVideoTrack` to create a custom video track, by passing in values for the `width`, `height`, and `frameRate` parameters. * After creating a screen track or a custom video track, you can dynamically adjust the video profile using `LocalVideoTrack.setEncoderConfiguration`. Please note that there is a known issue with calling this method on a screen track in certain versions of macOS Safari. [See issue details](/en/realtime-media/video/reference/common-problems). For details, see more about [Configure video encoding](/en/realtime-media/video/build/manage-connection-and-quality/optimize-multihost-video). **Other improvements** This release also includes the following improvements: * The time required to create tracks using `createMicrophoneAudioTrack` or `createMicrophoneAndCameraTracks` on Safari browsers is reduced. * When you have two `AgoraRTCClient` objects created locally, you have the option to block certain callbacks from one `AgoraRTCClient` to another. These callbacks include those triggered when joining or leaving a channel, and publishing or unpublishing streams. For example, if you are using Client A for publishing a screen track and Client B for publishing a camera track, and you enable this feature to block callbacks, Client A and B will not receive the following callbacks from each other: * `AgoraRTCClient.on("user-published")` * `AgoraRTCClient.on("user-joined")` * `AgoraRTCClient.on("user-unpublished")` * `AgoraRTCClient.on("user-left")` * `AgoraRTCClient.on("published-user-list")` * `AgoraRTCClient.on("user-info-update")` To enable this feature, contact technical support. #### API changes [#api-changes-9] **Added** * `displaySurface` (replacement for `screenSourceType`), `selfBrowserSurface`, `surfaceSwitching`, and `systemAudio` in the `ScreenVideoTrackInitConfig` interface * `width`, `height`, and `frameRate` in the `createCustomVideoTrack` method * `LocalVideoTrack.setEncoderConfiguration` **Deleted** * `ILocalVideoTrack.setBeautyEffect` ### v4.17.0 [#v4170] v4.17.0 was released on March 22, 2023. #### New features [#new-features-12] **Dynamic switching of local video streams** This release adds the `ILocalVideoTrack.replaceTrack` method to increase the flexibility to switch local video tracks. For example, to switch from one camera to another before v4.17.0, you needed to call `IAgoraRTCClient.unpublish` to unpublish the current track and then call `IAgoraRTCClient.publish` to publish a new track. As of v4.17.0, you can call `ILocalVideoTrack.replaceTrack` directly. #### Improvements [#improvements-16] **Optimized reconnection mechanism** As of v4.17.0, the SDK defaults to showing the last video frame before disconnection during reconnection, which prevents a black screen during the reconnection process. This optimization is not available on Safari due to Safari's limitations. **Other improvements** This release also includes the following improvements: * The accuracy of SDK-related quality metrics on [Analytics](/en/realtime-media/agora-analytics/product-overview) is improved. * The time required to join a channel is reduced. This optimization is not available on Firefox due to Firefox's limitations. #### API changes [#api-changes-10] **Added** * `ILocalVideoTrack.replaceTrack` **Deleted** * `ILocalVideoTrack.setBeautyEffect` #### Issues fixed [#issues-fixed-13] On Safari on iOS 14.7 and later, performing subscribing and unsubscribing operations repeatedly to multiple audio streams could result in not hearing remote users. ### v4.16.1 [#v4161] Video Calling v4.16.1 was released on February 7, 2023. #### Issues fixed [#issues-fixed-14] This release fixes the following issue: * When using Video SDK for Web v4.16.0, the video freeze rate showed in Agora Analytics is much higher than the correct value. ### v4.16.0 [#v4160] Video Calling v4.16.0 was released on January 5, 2023. #### Improvements [#improvements-17] This release adds the following enhancements: **Compatibility for deprecated RTCMediaStreamTrackStats on Chrome** Chrome plans to deprecate the stats dictionary `RTCMediaStreamTrackStats`. See the service announcement on [discuss-webrtc@googlegrooups.com](https://groups.google.com/g/discuss-webrtc/c/9c8ZjberEcI). This change affects the following media track statistics returned by the SDK: | Statistics | Affected fields | | :---------------------- | :------------------------------------------------------------------------------------------------------------------------- | | `LocalVideoTrackStats` | `sendFrameRate`
`sendResolutionHeight`
`sendResolutionWidth` | | `RemoteVideoTrackStats` | `receiveFrameRate`
`receiveResolutionHeight`
`receiveResolutionWidth`
`renderFrameRate`
`receiveDelay` | | `RemoteAudioTrackStats` | `receiveDelay`
`receiveLevel` | To ensure the accuracy of these media track statistics on Chrome, please upgrade the SDK to v4.16.0 or later as soon as possible. **Other improvements** This version of the SDK also includes the following improvements: * The cause of the [`HTMLMediaElement` error event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/error_event) is now recorded in the log. * The size of the SDK package is reduced. #### Issues fixed [#issues-fixed-15] This release fixes the following issues: * Media operations failed when the SDK was attempting to reconnect to the network. * When relaying media streams across channels, [`ChannelMediaRelayConfiguration.addDestChannelInfo`](https://api-ref.agora.io/en/voice-sdk/web/4.x/interfaces/ichannelmediarelayconfiguration.html#adddestchannelinfo) could not set `uid` to `0` to identify the relay stream in the destination channel. * Some known issues on iOS 14.x. ### v4.15.1 [#v4151] v4.15.1 was released on December 2, 2022. #### Issues fixed [#issues-fixed-16] This release fixes the following issue: * No audio was received on iOS 13.7. ### v4.15.0 [#v4150] v4.15.0 was released on October 31, 2022. #### New features [#new-features-13] The latest features in this release are: ##### Audio stream filter (Beta) [#audio-stream-filter-beta] v4.15.0 introduces filtering audio streams based on volume. Once this function is enabled, Agora backend ranks all subscribed audio streams by volume. By default, the three audio streams with the highest volume are transported to others in the channel. To change the number of audio streams to be transported, contact [support@agora.io](mailto\:support@agora.io). Agora enables channel hosts to control whether the audio streams being published are filtered based on volume. Streams that are not filtered bypass this filter mechanism and are transported directly to the receivers. In use-cases with a large number of publishers, enabling this function helps reduce the bandwidth and device system pressure for the receivers. To enable this function, contact [support@agora.io](mailto\:support@agora.io). ##### VP9 codec [#vp9-codec] Video SDK for Web v4.15.0 adds support for the VP9 codec in the following browsers: | | Supported browsers① | | ------- | ------------------------------------------------------------------------------------------------------------------ | | Desktop | Chrome 65 or later
Firefox 69 or later
Edge 79 or later
Safari 16 or later | | Android | Chrome 68 or later
Wechat v8.0.6 or later
Other apps that use WKWebView: WebView v65.0.3325.109 or later | | iOS | Safari 16 or later | ① To ensure the best user experience, best practice is to use the latest version of the browsers listed above. To start a call using the VP9 codec, apps you connect to built using for Android, iOS, Windows, or macOS must use Video SDK v4.0.1 or greater. ##### CSP violation callback [#csp-violation-callback] v4.15.0 adds the `AgoraRTC.onSecurityPolicyViolation` callback. When Agora fails to load a resource or send a request due to Content Security Policy(CSP) violations, the Video SDK triggers this callback. When you receive this callback, modify your CSP configuration to ensure that you can access Agora-related services. #### Improvements [#improvements-18] The SDK has the following improvements: * The accuracy of network quality reported by `AgoraRTCClient.on("network-quality")` in certain use-cases has increased. * Resumption of audio or video streams when the user switches between Wi-Fi networks is faster. #### API changes [#api-changes-11] **Added** * `IAgoraRTC.onSecurityPolicyViolation` #### Compatibility changes [#compatibility-changes-6] Cloud Proxy default mode has changed. In Video SDK for Web v4.15.0, the `mode` parameter in `startProxyServer` defaults to `3`. This represents the Force UDP cloud proxy mode. In this mode, Video SDK always transmits data over UDP. For details, see [Restricted network connection with Cloud Proxy](/en/realtime-media/video/build/manage-connection-and-quality/cloud-proxy). ### v4.14.2 [#v4142] v4.14.2 was released on October 27, 2022. #### Issues fixed [#issues-fixed-17] This release fixes the following issue: * When using WeChat browsers on iOS 14.x, no audio is received from the first channel the user subscribes to. ### v4.14.1 [#v4141] v4.14.1 was released on October 24, 2022. #### Issues fixed [#issues-fixed-18] This release fixes the following issues: * On Electron v17.x, screen sharing did not work properly. To solve this issue, add the following code in the main process: ```javascript const { ipcMain, desktopCapturer } = require("electron"); ipcMain.handle("DESKTOP_CAPTURER_GET_SOURCES", (event, opts) => desktopCapturer.getSources(opts)); ``` * On desktop Safari, if autoplay was blocked for all videos, they kept trying to replay resulting in video freeze. * On mobile browsers, the video freeze rate calculated by the SDK was higher than the actual value when the browser was running in the background. * In Android WebView, the default poster (a gray play button) of the video element showed before video playback. * Media stream relay failed after the SDK resumed connection to the network. * During a media stream relay, the SDK continued to send heartbeats after the user left the source channel. ### v4.14.0 [#v4140] v4.14.0 was released on August 31, 2022. #### Compatibility changes [#compatibility-changes-7] **getVolumeLevel accuracy improvement** As of v4.14.0, the SDK calibrates the calculation of the volume returned in `getVolumeLevel`. The volume range is still \[0,1], where 1 represents the highest audio level. If your business use-case depends on the volume returned in `getVolumeLevel` (for example, a speaker icon shows according to the volume), ensure that you check the returned volume after upgrading to v4.14.0. #### Issues fixed [#issues-fixed-19] This release fixes the following issue: * The received Opus stereo audio had no stereo effect. * On versions earlier than Chrome 76, the `decodeFrameRate` returned by the `getRemoteVideoStats` method was 0. * On WeChat browsers running on iOS 14.1 and 14.2, the first subscribed audio stream was silent. * After calling `LocalVideoTrack.setBeautyEffect` to enable image enhancement, calling `LocalVideoTrack.unpipe` caused an error. * On Windows Chrome 103 and later versions, enabling the dual-stream mode did not take effect in certain use-cases. ### v4.13.0 [#v4130] v4.13.0 was released on July 25, 2022. #### New features [#new-features-14] **Adding support for media processing extensions** As of v4.13.0, the SDK supports using media processing extensions on remote audio and video tracks (extension support for local audio and video tracks was added in [v4.10.0](#410)). Currently, Agora provides the following extension for remote audio tracks: | Extension | Description | Documentation | | :----------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- | | Spatial Audio Extension (Beta) | Enables a real-time audio blurring or air absorption effect for a user's audio based on the user's position relative to other users, which makes conversations more immersive. | Contact [support@agora.io](mailto\:support@agora.io) for full details. | #### Improvements [#improvements-19] **AI Noise Suppression and virtual background** The AI Noise Suppression extension and virtual background extension are converted from beta release to official release. To experience the AI Noise Suppression or virtual background extension, contact [support@agora.io](mailto\:support@agora.io). **Callback for token expiration** v4.13.0 improved the logic of triggering the callback for token expiration. If a token expires when the user's device is in sleep mode or disconnected from network, the SDK triggers the `token-privilege-did-expire` event when the device resumes operation and attempts to reconnect to the SDK. #### API changes [#api-changes-12] **Added** * `RemoteAudioTrack.pipe` * `RemoteAudioTrack.unpipe` * `RemoteVideoTrack.pipe` * `RemoteVideoTrack.unpipe` ### v4.12.2 [#v4122] v4.12.2 was released on July 7, 2022. This release improved the automatic mode for SDK connectivity (In this mode, the SDK first attempts a direct connection to Agora backend; if the attempt fails, the SDK automatically switches to TCP/TLS 443). ### v4.12.1 [#v4121] v4.12.1 was released on June 27, 2022. This release fixed the following issues: * Subscribing to remote streams occasionally failed after disconnection. * On Firefox, performing subscribing and unsubscribing operations repeatedly to multiple video streams occasionally caused video freezing. ### v4.12.0 [#v4120] v4.12.0 was released on June 15, 2022. #### Improvements [#improvements-20] **Media processing extensions** Media processing extensions have the following changes: * The [Image Enhancement Extension (Beta)](https://www.npmjs.com/package/agora-extension-beauty-effect) is released. This extension incorporates and upgrades the built-in image enhancement feature (enabled by [setBeautyEffect](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/ilocalvideotrack.html#setbeautyeffect))) of the Agora Web SDK 4.x. You can adjust parameters including the contrast, brightness, and smoothness levels, in order to touch up the image for effects such as skin lightening and skin smoothing. For details, see [Use the Image Enhancement Extension](/en/realtime-media/video/build/apply-video-effects/beauty-effect). * The [Virtual Background Extension (Beta)](https://www.npmjs.com/package/agora-extension-virtual-background) supports animated virtual backgrounds as of v1.0.0-beta-3. You can set a user's background as a short video. For details, see [Use the Virtual Background Extension](/en/realtime-media/video/build/apply-video-effects/virtual-background). #### Issues fixed [#issues-fixed-20] v4.12.0 fixed the issue that when dual-stream mode was enabled on Safari, calling methods such as `Track.setEnabled(false)` and `Track.close()` could not turn off the camera indicator light. ### v4.11.1 [#v4111] v4.11.1 was released on May 9, 2022. This release fixed the following issues: * Subscribing to audio streams might cause no sound on Firefox. * Compatibility issues occurred in Safari on iOS 12 and in the WeChat built-in browser on iOS 13. ### v4.11.0 [#v4110] v4.11.0 was released on April 1, 2022. #### Compatibility changes [#compatibility-changes-8] As of v4.11.0, the SDK adopts an automatic mode by default to ensure connectivity. In this mode, the SDK first attempts a direct connection to Agora backend; if the attempt fails, the SDK automatically switches to TCP/TLS 443. You can listen for such auto-switch events through `client.on("join-fallback-to-proxy")`. #### Improvements [#improvements-21] **Channel capacity improvement** As of v4.11.0, a single channel can support up to 128 concurrent online hosts, who can publish media streams at the same time. The number of audience members in a channel is unlimited. Each host or audience member can subscribe to a maximum of 50 hosts at the same time. To experience this improvement, contact [support@agora.io](mailto\:support@agora.io). #### Fixed issues [#fixed-issues-1] v4.11.0 fixed the following issues: * Angular’s dependency zone.js caused an error when `Promise.finally` was called in the SDK. * On Chrome, AEC could not be enabled when sending stereo sound. * On Chrome 100, the SDK reported inaccurate statistics for the decoding frame rate and sending frame rate. * When dual-stream mode was enabled, calling `unpublish` without parameters caused the method call to fail. ### v4.10.2 [#v4102] v4.10.2 was released on March 24, 2022. This release fixed the issue that calling `join` in certain use-cases might cause proxy exceptions. ### v4.10.1 [#v4101] v4.10.1 was released on March 17, 2022 and added the dependency of TypeScript type definitions for Agora Extension `agora-rte-extension` in `package.json`. If you use TypeScript for type checking, Agora suggests that you update TypeScript to v4.3.2 or later. ### v4.10.0 [#v4100] v4.10.0 was released on March 11, 2022. #### New features [#new-features-15] **Adding support for media processing extensions** v4.10.0 supports using media processing extensions in the Video Calling. The following extensions are currently free to use during the beta period. For guidance on how to integrate and use the extensions, refer to the documentation listed in the following table: | Extension | Description | Documentation | | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | Virtual Background Extension (Beta) | Enables users to replace their actual background with a solid color or custom image, or to blur their background. | [Use the Virtual Background Extension (Beta)](/en/realtime-media/video/build/apply-video-effects/virtual-background) | | AI Noise Suppression Extension (Beta) | Reduces many types of sudden noise and reduces vocal distortion when multiple people speak at the same time. | [AI Noise Suppression](/en/realtime-media/video/build/enhance-the-audio-experience/ai-noise-suppression) | #### API changes [#api-changes-13] **Added** * `AgoraRTC.registerExtensions` * `LocalTrack.pipe` * `LocalTrack.unpipe` * `LocalTrack.processorDestination` ### v4.9.4 [#v494] v4.9.4 was released on March 16, 2022 and fixed the failure to access localStorage when loading the SDK in an iFrame in Chrome Incognito mode. ### v4.9.3 [#v493] v4.9.3 was released on March 3, 2022. This release fixed several internal issues. ### v4.9.1 [#v491] v4.9.1 was released on February 24, 2022. This release fixed several internal issues. ### v4.9.0 [#v490] v4.9.0 was released on February 17, 2022. #### New features [#new-features-16] **Setting the video stream type of all remote users** v4.9.0 adds the [`setRemoteDefaultVideoStreamType`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartcclient.html#setremotevideostreamtype) method. After you call `enableDualStream` to enable dual-stream mode on the senders' clients, `setRemoteDefaultVideoStreamType` enables receivers to choose whether to receive the high-quality or low-quality stream of all remote users. **Cloud Proxy Force TCP mode** v4.9.0 adds Force TCP mode for the Agora Cloud Proxy service. In this mode, the SDK always transmits data over TLS 443. To use this mode, set `mode` as 5 when calling `startProxyServer`. **Checking the visibility of the `