All 4.x SDKs support using wildcard tokens.
-
-2. **Preloading channels**
-
- This release adds `preloadChannel[1/2]` and `preloadChannel[2/2]` methods, which allows a user whose role is set as audience to preload channels before joining one. Calling the method can help shortening the time of joining a channel, thus reducing the time it takes for audience members to hear and see the host.
-
- When preloading more than one channels, Agora recommends that you use a wildcard token for preloading to avoid repeated application of tokens every time you joining a new channel, thus saving the time for switching between channels. See [Wildcard tokens](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/wildcard_token?platform=All%20Platforms).
-
-3. **Customized background color of video canvas**
-
- In this release, the `backgroundColor` member has been added to `VideoCanvas`, which allows you to customize the background color of the video canvas when setting the properties of local or remote video display.
-
-#### Improvements
-
-1. **Improved camera capture effect**
-
- Since this release, camera exposure adjustment is supported. This release adds `isCameraExposureSupported` to query whether the device supports exposure adjustment and `setCameraExposureFactor` to set the exposure ratio of the camera.
-
-2. **Virtual Background Algorithm Upgrade**
-
- This version has upgraded the portrait segmentation algorithm of the virtual background, which comprehensively improves the accuracy of portrait segmentation, the smoothness of the portrait edge with the virtual background, and the fit of the edge when the person moves. In addition, it optimizes the precision of the person's edge in scenarios such as meetings, offices, homes, and under backlight or weak light conditions.
-
-3. **Channel media relay**
-
- The number of target channels for media relay has been increased to 6. When calling `startOrUpdateChannelMediaRelay` and `startOrUpdateChannelMediaRelayEx`, you can specify up to 6 target channels.
-
-4. **Enhancement in video codec query capability**
-
- To improve the video codec query capability, this release adds the `codecLevels` member in `CodecCapInfo`. After successfully calling `queryCodecCapability`, you can obtain the hardware and software decoding capability levels of the device for H.264 and H.265 video formats through `codecLevels`.
-
-This release includes the following additional improvements:
-
-1. To improve the switching experience between multiple audio routes, this release adds the `setRouteInCommunicationMode` method. This method can switch the audio route from a Bluetooth headphone to the earpiece, wired headphone or speaker in communication volume mode ([`MODE_IN_COMMUNICATION`](https://developer.android.google.cn/reference/kotlin/android/media/AudioManager?hl=en#mode_in_communication)).
-2. The SDK automatically adjusts the frame rate of the sending end based on the screen sharing scenario. Especially in document sharing scenarios, this feature avoids exceeding the expected video bitrate on the sending end to improve transmission efficiency and reduce network burden.
-3. To help users understand the reasons for more types of remote video state changes, the `REMOTE_VIDEO_STATE_REASON_CODEC_NOT_SUPPORT` enumeration has been added to the `onRemoteVideoStateChanged` callback, indicating that the local video decoder does not support decoding the received remote video stream.
-
-#### Issues fixed
-
-This release fixed the following issues:
-
-- Slow channel reconnection after the connection was interrupted due to network reasons.
-- In screen sharing scenarios, the delay of seeing the shared screen was occasionally higher than expected on some devices.
-- In custom video capturing scenarios, `setBeautyEffectOptions`, `setLowlightEnhanceOptions`, `setVideoDenoiserOptions`, and `setColorEnhanceOptions` could not load extensions automatically.
-
-#### API changes
-
-**Added**
-
-- `setCameraExposureFactor`
-- `isCameraExposureSupported`
-- `preloadChannel[1/2]`
-- `preloadChannel[2/2]`
-- `updatePreloadChannelToken`
-- `setRouteInCommunicationMode`
-- `CodecCapLevels`
-- `VideoCodecCapLevel`
-- `backgroundColor` in `VideoCanvas`
-- `codecLevels` in `CodecCapInfo`
-- `REMOTE_VIDEO_STATE_REASON_CODEC_NOT_SUPPORT`
-
-**Deleted**
-
-- Some constructors in `VideoCanvas`
-
-## v4.2.1
-
-This version was released on June 21, 2023.
-
-#### Improvements
-
-This version improves the network transmission strategy, enhancing the smoothness of audio and video interactions.
-
-#### Issues fixed
-
-This version fixed the following issues:
-- Inability to join channels caused by SDK's incompatibility with some older versions of AccessToken.
-- After the sending end called `setAINSMode` to activate AI noise reduction, occasional echo was observed by the receiving end.
-- Brief noise occurred while playing media files using the media player.
-- In screen sharing scenarios, some Android devices experienced choppy video on the receiving end.
-
-## v4.2.0
-
-v4.2.0 was released on May 23, 2023.
-
-#### Compatibility changes
-
-If you use the features mentioned in this section, ensure that you modify the implementation of the relevant features after upgrading the SDK.
-
-**1. Video data acquisition**
-
-- The `onCaptureVideoFrame` and `onPreEncodeVideoFrame` callbacks are added with a new parameter called `sourceType`, which is used to indicate the specific video source type.
-- The following callbacks are deleted. Get the video source type through the `sourceType` parameter in the `onPreEncodeVideoFrame` and `onCaptureVideoFrame` callbacks.
-- `onScreenCaptureVideoFrame`
-- `onPreEncodeScreenVideoFrame`
-
-**2. Channel media options**
-
-- `publishCustomAudioTrackEnableAec` in `ChannelMediaOptions` is deleted. Use `publishCustomAudioTrack` instead.
-- `publishTrancodedVideoTrack` in `ChannelMediaOptions` is renamed to `publishTranscodedVideoTrack`.
-- `publishCustomAudioSourceId` in `ChannelMediaOptions` is renamed to `publishCustomAudioTrackId`.
-
-**3. Miscellaneous**
-
-- `onApiCallExecuted` is deleted. Agora recommends getting the results of the API implementation through relevant channels and media callbacks.
-- `enableDualStreamMode`[1/2] and `enableDualStreamMode`[2/2] are depredated. Use `setDualStreamMode`[1/2] and `setDualStreamMode`[2/2] instead.
-- `startChannelMediaRelay`, `updateChannelMediaRelay`, `startChannelMediaRelayEx` and `updateChannelMediaRelayEx` are deprecated. Use `startOrUpdateChannelMediaRelay` and `startOrUpdateChannelMediaRelayEx` instead.
-
-
-#### New features
-
-**1. AI noise reduction**
-
-This release introduces the AI noise reduction function. Once enabled, the SDK automatically detects and reduces background noises. Whether in bustling public venues or real-time competitive arenas that demand lightning-fast responsiveness, this function guarantees optimal audio clarity, providing users with an elevated audio experience. You can enable this function through the newly-introduced `setAINSMode` method and set the noise reduction mode as balance, aggressive or low latency according to your scenarios.
-
-**2. Enhanced virtual background**
-
-To increase the fun of real-time video calls and protect user privacy, this version has enhanced the virtual background feature. You can now set custom backgrounds of various types by calling the `enableVirtualBackground` method, including:
-
-- Process the background as alpha information without replacement, only separating the portrait and the background. This can be combined with the local video mixing feature to achieve a portrait-in-picture effect.
-- Replace the background with various formats of local videos.
-
-**3. Video scenario settings**
-
-This release introduces `setVideoScenario` for setting the video application scene. The SDK will automatically enable the best practice strategy based on different scenes, adjusting key performance indicators to optimize video quality and improve user experience. Whether it is a formal business meeting or a casual online gathering, this feature ensures that the video quality meets the requirements.
-
-Currently, this feature provides targeted optimizations for real-time video conferencing scenarios, including:
-
-- Automatically activate multiple anti-weak network technologies to enhance the capability and performance of low-quality video streams in meeting scenarios where high bitrate are required, ensuring smoothness when multiple streams are subscribed by the receiving end.
-- Monitor the number of subscribers for the high-quality and low-quality video streams in real time, dynamically adjusting the configuration of the high-quality stream and dynamically enabling or disabling the low-quality stream, to save uplink bandwidth and consumption.
-
-**4. Local video mixing**
-
-This release adds the local video mixing feature. You can use the `startLocalVideoTranscoder` method to mix and render multiple video streams locally, such as camera-captured video, screen sharing streams, video files, images, etc. This allows you to achieve custom layouts and effects, making it easy to create personalized video display effects to meet various scenario requirements, such as remote meetings, live streaming, online education, while also supporting features like portrait-in-picture effect.
-
-Additionally, the SDK provides the `updateLocalTranscoderConfiguration` method and the `onLocalVideoTranscoderError` callback. After enabling local video mixing, you can use the `updateLocalTranscoderConfiguration` method to update the video mixing configuration. Where an error occurs in starting the local video mixing or updating the configuration, you can get the reason for the failure through the `onLocalVideoTranscoderError` callback.
-
-Local video mixing requires more CPU resources. Therefore, Agora recommends enabling this function on devices with higher performance.
-
-**5. Cross-device synchronization**
-
-In real-time collaborative singing scenarios, network issues can cause inconsistencies in the downlinks of different client devices. To address this, this release introduces `getNtpWallTimeInMs` for obtaining the current Network Time Protocol (NTP) time. By using this method to synchronize lyrics and music across multiple client devices, users can achieve synchronized singing and lyrics progression, resulting in a better collaborative experience.
-
-
-#### Improvements
-
-**1. Improved voice changer**
-
-This release introduces the `setLocalVoiceFormant` method that allows you to adjust the formant ratio to change the timbre of the voice. This method can be used together with the `setLocalVoicePitch` method to adjust the pitch and timbre of voice at the same time, enabling a wider range of voice transformation effects.
-
-**2. Enhanced screen share**
-
-This release adds the `queryScreenCaptureCapability` method, which is used to query the screen capture capabilities of the current device. To ensure optimal screen sharing performance, particularly in enabling high frame rates like 60 fps, Agora recommends you to query the device's maximum supported frame rate using this method beforehand.
-
-This release also adds the `setScreenCaptureScenario` method, which is used to set the scenario type for screen sharing. The SDK automatically adjusts the smoothness and clarity of the shared screen based on the scenario type you set.
-
-**3. Improved compatibility with audio file types**
-
-As of v4.2.0, you can use the following methods to open files with a URI starting with `content://`:
-- `startAudioMixing` [2/2]
-- `playEffect` [3/3]
-- `open` [2/2]
-- `openWithMediaSource`
-
-**4. Audio and video synchronization**
-
-For custom video and audio capture scenarios, this release introduces `getCurrentMonotonicTimeInMs` for obtaining the current Monotonic Time. By passing this value into the timestamps of audio and video frames, developers can accurately control the timing of their audio and video streams, ensuring proper synchronization.
-
-**5. Multi-camera capture**
-
-This release introduces `startCameraCapture`. By calling this method multiple times and specifying the `sourceType` parameter, developers can start capturing video streams from multiple cameras for local video mixing or multi-channel publishing. This is particularly useful for scenarios such as remote medical care and online education, where multiple cameras need to be connected.
-
-**6. Channel media relay**
-
-This release introduces `startOrUpdateChannelMediaRelay` and `startOrUpdateChannelMediaRelayEx`, allowing for a simpler and smoother way to start and update media relay across channels. With these methods, developers can easily start the media relay across channels and update the target channels for media relay with a single method. Additionally, the internal interaction frequency has been optimized, effectively reducing latency in function calls.
-
-**7. Custom audio tracks**
-
-To better meet the needs of custom audio capture scenarios, this release adds `createCustomAudioTrack` and `destroyCustomAudioTrack` for creating and destroying custom audio tracks. Two types of audio tracks are also provided for users to choose from, further improving the flexibility of capturing external audio source:
-
-- Mixable audio track: Supports mixing multiple external audio sources and publishing them to the same channel, suitable for multi-channel audio capture scenarios.
-- Direct audio track: Only supports publishing one external audio source to a single channel, suitable for low-latency audio capture scenarios.
-
-
-#### Issues fixed
-
-This release fixed the following issues:
-
-- Occasional crashes occur on Android devices when users joining or leaving a channel.
-- When the host frequently switching the user role between broadcaster and audience in a short period of time, the audience members cannot hear the audio of the host.
-- Occasional failure when enabling in-ear monitoring.
-- Occasional echo.
-- Abnormal client status cased by an exception in the `onRemoteAudioStateChanged` callback.
-
-
-#### API changes
-
-**Added**
-
-- `startCameraCapture`
-- `stopCameraCapture`
-- `startOrUpdateChannelMediaRelay`
-- `startOrUpdateChannelMediaRelayEx`
-- `getNtpWallTimeInMs`
-- `setVideoScenario`
-- `getCurrentMonotonicTimeInMs`
-- `startLocalVideoTranscoder`
-- `updateLocalTranscoderConfiguration`
-- `onLocalVideoTranscoderError`
-- `queryScreenCaptureCapability`
-- `setScreenCaptureScenario`
-- `setAINSMode`
-- `createCustomAudioTrack`
-- `destroyCustomAudioTrack`
-- `AudioTrackConfig`
-- `AudioTrackType`
-- `VideoScenario`
-- The `mDomainLimit` and `mAutoRegisterAgoraExtensions` members in `RtcEngineConfig`
-- The `sourceType` parameter in `onCaptureVideoFrame` and `onPreEncodeVideoFrame` callbacks
-- `BACKGROUND_NONE`(0)
-- `BACKGROUND_VIDEO`(4)
-
-**Deprecated**
-
-- `enableDualStreamMode`[1/2]
-- `enableDualStreamMode`[2/2]
-- `startChannelMediaRelay`
-- `startChannelMediaRelayEx`
-- `updateChannelMediaRelay`
-- `updateChannelMediaRelayEx`
-- `onChannelMediaRelayEvent`
-
-**Deleted**
-
-- `onApiCallExecuted`
-- `publishCustomAudioTrackEnableAec` in `ChannelMediaOptions` in `ChannelMediaOptions`
-- `onScreenCaptureVideoFrame`
-- `onPreEncodeScreenVideoFrame`
-
-
-
-## v4.1.1
-
-v4.1.1 was released on January xx, 2023.
-
-#### Compatibility changes
-
-As of this release, the SDK optimizes the video encoder algorithm and upgrades the default video encoding resolution from 640 × 360 to 960 × 540 to accommodate improvements in device performance and network bandwidth, providing users with a full-link HD experience in various audio and video interaction scenarios.
-
-You can call the `setVideoEncoderConfiguration` method to set the expected video encoding resolution in the video encoding parameters configuration.
-
-To enable this feature, contact
sales-us@agora.io.
-
-**4. Camera capture options**
-
-This release adds the `followEncodeDimensionRatio` member in `CameraCapturerConfiguration`, which enables you to set whether to follow the video aspect ratio already set in `setVideoEncoderConfiguration` when capturing video with the camera.
-
-**5. Multi-channel management**
-
-This release adds a series of multi-channel related methods that you can call to manage audio and video streams in multi-channel scenarios.
-
-- The `muteLocalAudioStreamEx` and `muteLocalVideoStreamEx` methods are used to cancel or resume publishing a local audio or video stream, respectively.
-- The `muteAllRemoteAudioStreamsEx` and `muteAllRemoteVideoStreamsEx` are used to cancel or resume the subscription of all remote users to audio or video streams, respectively.
-- The `startRtmpStreamWithoutTranscodingEx`, `startRtmpStreamWithTranscodingEx`, `updateRtmpTranscodingEx`, and `stopRtmpStreamEx` methods are used to implement Media Push in multi-channel scenarios.
-- The `startChannelMediaRelayEx`, `updateChannelMediaRelayEx`, `pauseAllChannelMediaRelayEx`, `resumeAllChannelMediaRelayEx`, and `stopChannelMediaRelayEx` methods are used to relay media streams across channels in multi-channel scenarios.
-- Adds the `leaveChannelEx` [2/2] method. Compared with the `leaveChannelEx` [1/2] method, a new options parameter is added, which is used to choose whether to stop recording with the microphone when leaving a channel in a multi-channel scenario.
-
-**6. Video encoding preferences**
-
-In general scenarios, the default video encoding configuration meets most requirements. For certain specific scenarios, this release adds the `advanceOptions` member in `VideoEncoderConfiguration` for advanced settings of video encoding properties:
-
-- `compressionPreference`: The compression preferences for video encoding, which is used to select low-latency or high-quality video preferences.
-- `encodingPreference`: The video encoder preference, which is used to select adaptive preference, software encoder preference, or hardware encoder video preferences.
-
-**7. Client role switching**
-
-In order to enable users to know whether the switched user role is low-latency or ultra-low-latency, this release adds the `newRoleOptions` parameter to the `onClientRoleChanged` callback. The value of this parameter is as follows:
-
-- `AUDIENCE_LATENCY_LEVEL_LOW_LATENCY` (1): Low latency.
-- `AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY` (2): Ultra-low latency.
-
-#### Improvements
-
-**1. Bluetooth permissions**
-
-To simplify integration, as of this release, you can use the SDK to enable Android users to use Bluetooth normally without adding the `BLUETOOTH_CONNECT` permission.
-
-**2. CDN streaming**
-
-To improve user experience during CDN streaming, when your camera does not support the video resolution you set when streaming, the SDK automatically adjusts the resolution to the closest value that is supported by your camera and has the same aspect ratio as the original video resolution you set. The actual video resolution used by the SDK for streaming can be obtained through the `onDirectCdnStreamingStats` callback.
-
-**3. Relaying media streams across channels**
-
-This release optimizes the `updateChannelMediaRelay` method as follows:
-
-- Before v4.1.0: If the target channel update fails due to internal reasons in the server, the SDK returns the error code `RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL_REFUSED`(8), and you need to call the `updateChannelMediaRelay` method again.
-- v4.1.0 and later: If the target channel update fails due to internal server reasons, the SDK retries the update until the target channel update is successful.
-
-**4. Reconstructed AIAEC algorithm**
-
-This release reconstructs the AEC algorithm based on the AI method. Compared with the traditional AEC algorithm, the new algorithm can preserve the complete, clear, and smooth near-end vocals under poor echo-to-signal conditions, significantly improving the system's echo cancellation and dual-talk performance. This gives users a more comfortable call and live-broadcast experience. AIAEC is suitable for conference calls, chats, karaoke, and other scenarios.
-
-**5. Virtual background**
-
-This release optimizes the virtual background algorithm. Improvements include the following:
-
-- The boundaries of virtual backgrounds are handled in a more nuanced way and image matting is is now extremely thin.
-- The stability of the virtual background is improved whether the portrait is still or moving, effectively eliminating the problem of background flickering and exceeding the range of the picture.
-- More application scenarios are now supported, and a user obtains a good virtual background effect day or night, indoors or out.
-- A larger variety of postures are now recognized, when half the body is motionless, the body is shaking, the hands are swinging, or there is fine finger movement. This helps to achieve a good virtual background effect in conjunction with many different gestures.
-
-
-**Other improvements**
+**Attention:**
+As of v4.5.0, both RTC SDK and RTM SDK (v2.2.0 and above) include the libaosl.so library. If you manually integrate RTC SDK via CDN and also use RTM SDK, delete the lower version of the libaosl.so library to avoid conflicts. The libaosl.so library version in RTC SDK v4.5.0 is 1.2.13.
-This release includes the following additional improvements:
+#### 1. Changes in strong video denoising implementation
-- Reduces the latency when pushing external audio sources.
-- Improves the performance of echo cancellation when using the `AUDIO_SCENARIO_MEETING` scenario.
-- Improves the smoothness of SDK video rendering.
-- Enhances the ability to identify different network protocol stacks and improves the SDK's access capabilities in multiple-operator network scenarios.
-- At the moment when a user left a channel, a request for leaving was not sent to the server and the leaving behavior was incorrectly determined by the server as timed out.
+This version adjusts the implementation of strong video denoising.
-#### Issues fixed
+The `VIDEO_DENOISER_LEVEL_STRENGTH` enumeration is removed.
-This release fixed the following issues:
+Instead, after enabling video denoising by calling `setVideoDenoiserOptions [1/2]`, you can call the `setBeautyEffectOptions [1/2]` method to enable the beauty skin smoothing feature. Using both together will achieve better video denoising effects. For strong denoising, it is recommended to set the skin smoothing parameters as detailed in `setVideoDenoiserOptions [1/2]`.
-- Audience members heard buzzing noises when the host switched between speakers and earphones during live streaming.
-- The call `getExtensionProperty` failed and returned an empty string.
-- When entering a live streaming room that has been played for a long time as an audience, the time for the first frame to be rendered was shortened.
+Additionally, due to this adjustment, to achieve the best low-light enhancement effect with a focus on image quality, you need to enable video denoising first and use specific settings as detailed in `setLowlightEnhanceOptions [1/2]`.
-#### API changes
+#### 2. Changes in video encoding preferences
-**Added**
+To enhance the user’s video interaction experience, this version optimizes the default preferences for video encoding:
-- `setHeadphoneEQParameters`
+- In the `COMPRESSION_PREFERENCE` enumeration class, a new `PREFER_COMPRESSION_AUTO` (-1) enumeration is added, replacing the original `PREFER_QUALITY` (1) as the default value. In this mode, the SDK will automatically choose between `PREFER_LOW_LATENCY` or `PREFER_QUALITY` based on your video scene settings to achieve the best user experience.
+- In the `DEGRADATION_PREFERENCE` enumeration class, a new `MAINTAIN_AUTO` (-1) enumeration is added, replacing the original `MAINTAIN_QUALITY` (1) as the default value. In this mode, the SDK will automatically choose between `MAINTAIN_FRAMERATE`, `MAINTAIN_BALANCED`, or `MAINTAIN_RESOLUTION` based on your video scene settings to achieve the optimal overall quality experience (QoE).
-- `setRemoteVideoSubscriptionOptions`
+#### 3. 16 KB memory page size
-- `setRemoteVideoSubscriptionOptionsEx`
+Starting from Android 15, the system adds support for 16 KB memory page size, as detailed in [Support 16 KB page sizes](https://developer.android.com/guide/practices/page-sizes). To ensure the stability and performance of the app, starting from this version, the SDK supports 16 KB memory page size, ensuring seamless operation on devices with both 4 KB and 16 KB memory page sizes, enhancing compatibility and preventing crashes.
-- `VideoSubscriptionOptions`
+### New features
-- `leaveChannelEx` [2/2]
+#### 1. Live show scenario
-- `muteLocalAudioStreamEx`
+This version adds the `APPLICATION_SCENARIO_LIVESHOW(3)` (Live Show) enumeration to the `VideoScenario`. You can call `setVideoScenario` to set the video business scenario to show room. To meet the high requirements for first frame rendering time and image quality in this scenario, the SDK has optimized strategies to significantly improve the first frame rendering experience and image quality, while enhancing the image quality in weak network environments and on low-end devices.
-- `muteLocalVideoStreamEx`
+#### 2. Maximum frame rate for video rendering
-- `muteAllRemoteAudioStreamsEx`
+This version adds the `setLocalRenderTargetFps` and `setRemoteRenderTargetFps` methods, which support setting the maximum frame rate for video rendering locally and remotely. The actual frame rate for video rendering by the SDK will be as close to this value as possible.
-- `muteAllRemoteVideoStreamsEx`
+In scenarios where the frame rate requirement for video rendering is not high (e.g., screen sharing, online education) or when the remote end uses mid-to-low-end devices, you can use this set of methods to limit the video rendering frame rate, thereby reducing CPU consumption and improving system performance.
-- `startRtmpStreamWithoutTranscodingEx`
+#### 3. Watching live streaming through URLs
-- `startRtmpStreamWithTranscodingEx`
+As of this version, audience members can directly open a specific URL to play the real-time media stream through openWithUrl, instead of joining a channel and subscribing to the streams of hosts, which greatly simplifies the API calls for the audience end to watch a live stream.
-- `updateRtmpTranscodingEx`
+#### 4. Filter effects
-- `stopRtmpStreamEx`
+This version introduces the `setFilterEffectOptions [1/2]` method. You can pass a cube map file (.cube) in the **config** parameter to achieve custom filter effects such as whitening, vivid, cool, black and white, etc. Additionally, the SDK provides a built-in `built_in_whiten_filter.cube` file for quickly achieving a whitening filter effect.
-- `startChannelMediaRelayEx`
+#### 5. Local audio mixing
-- `updateChannelMediaRelayEx`
+This version introduces the local audio mixing feature. You can call the `startLocalAudioMixer` method to mix the audio streams from the local microphone, media player, sound card, and remote audio streams into a single audio stream, which can then be published to the channel. When you no longer need audio mixing, you can call the stopLocalAudioMixer method to stop local audio mixing. During the mixing process, you can call the `updateLocalAudioMixerConfiguration` method to update the configuration of the audio streams being mixed.
-- `pauseAllChannelMediaRelayEx`
+Example use cases for this feature include:
+- By utilizing the local video mixing feature, the associated audio streams of the mixed video streams can be simultaneously captured and published.
+- In live streaming scenarios, users can receive audio streams within the channel, mix multiple audio streams locally, and then forward the mixed audio stream to other channels.
+- In educational scenarios, teachers can mix the audio from interactions with students locally and then forward the mixed audio stream to other channels.
-- `resumeAllChannelMediaRelayEx`
+#### 6. External MediaProjection
-- `stopChannelMediaRelayEx`
+This version introduces the `setExternalMediaProjection` method, which allows you to set an external `MediaProjection` and replace the MediaProjection applied by the SDK.
-- `followEncodeDimensionRatio` in `CameraCapturerConfiguration`
+If you have the capability to apply for `MediaProjection` on your own, you can use this feature to achieve more flexible screen capture.
-- `hwEncoderAccelerating` in `LocalVideoStats`
+#### 7. EGL context
-- `advanceOptions` in `VideoEncoderConfiguration`
+This version introduces the `setExternalRemoteEglContext` method, which is used to set the EGL context for rendering remote video streams. When using Texture format video data for remote video self-rendering, you can use this method to replace the SDK's default remote EGL context, achieving unified EGL context management.
-- `newRoleOptions` in `onClientRoleChanged`
+#### 8. Color space settings
-- `adjustUserPlaybackSignalVolumeEx`
+This version adds `getColorSpace` and `setColorSpace` to `VideoFrame`. You can use `getColorSpace` to obtain the color space properties of the video frame and use `setColorSpace` to customize the settings. By default, the color space uses Full Range and BT.709 standard configuration. Developers can flexibly adjust according to their own capture or rendering needs, further enhancing the customization capabilities of video processing.
-- `MvProperty` class
-- `ClimaxSegment` class
+### Improvements
-**Deprecated**
+#### 1. Virtual background algorithm optimization
-- `onApiCallExecuted`. Use the callbacks triggered by specific methods instead.
+This version upgrades the virtual background algorithm, making the segmentation between the portrait and the background more accurate. There is no background exposure, the body contour of the portrait is complete, and the detail recognition of fingers is significantly improved. Additionally, the edges between the portrait and the background are more stable, reducing edge jumping and flickering in continuous video frames.
-**Deleted**
+#### 2. Snapshot at specified video observation points
-- Removes deprecated member parameters `backgroundImage` and `watermark` in `LiveTranscoding` class.
-- Removes `RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL_REFUSED`(8) in `onChannelMediaRelayEvent` callback.
+This version introduces the `takeSnapshot [2/2]` and `takeSnapshotEx [2/2]` methods. You can use the **config** parameter when calling these methods to take snapshots at specified video observation points, such as before encoding, after encoding, or before rendering, to achieve more flexible snapshot effects.
-## v4.0.0
+#### 3. Custom audio capture improvements
-v4.0.0 was released on September 15, 2022.
+This version adds the `enableAudioProcessing` member parameter to `AudioTrackConfig`, which is used to control whether to enable 3A audio processing for custom audio capture tracks of the `AUDIO_TRACK_DIRECT` type. The default value of this parameter is false, meaning that audio processing is not enabled. Users can enable it as needed, enhancing the flexibility of custom audio processing.
-#### New features
+#### 4. Other Improvements
+- In scenarios where Alpha transparency effects are achieved by stitching video frames and Alpha data, the rendering performance on the receiving end has been improved, effectively reducing stuttering and latency.
+- Optimizes the logic for calling queryDeviceScore to obtain device score levels, improving the accuracy of the score results.
+- When calling `switchSrc` to switch between live streams or on-demand streams of different resolutions, smooth and seamless switching can be achieved. An automatic retry mechanism has been added in case of switching failures. The SDK will automatically retry 3 times after a failure. If it still fails, the onPlayerEvent callback will report the `PLAYER_EVENT_SWITCH_ERROR` event, indicating an error occurred during media resource switching.
+- When calling `setPlaybackSpeed` to set the playback speed of an audio file, the minimum supported speed is 0.3x.
-**2. Full HD and Ultra HD resolution**
+### Bug fixes
-In order to improve the interactive video experience, the SDK optimizes the whole process of video capturing, encoding, decoding and rendering. Starting from this version, it supports Full HD (FHD) and Ultra HD (UHD) video resolutions. You can set the `dimensions` parameter to 1920 × 1080 or higher resolution when calling the `setVideoEncoderConfiguration` method. If your device does not support high resolutions, the SDK will automatically fall back to an appropriate resolution.
+This version fixes the following issues:
-
The UHD resolution (4K, 60 fps) is currently in beta and requires certain device performance and network bandwidth. If you want to experience this feature, contact technical support.
-High resolution typically means higher performance consumption. To avoid a decrease in experience due to insufficient device performance, Agora recommends that you enable FHD and UHD video resolutions on devices with better performance.
-The increase in the default resolution affects the aggregate resolution and thus the billing rate. See Pricing.
+- When the video source type of the sender is in JPEG format, the frame rate on the receiving end occasionally falls below expectations.
+- Occasional noise and stuttering when playing music resources from the music content center.
+- During audio and video interaction, after being interrupted by a system call, the user volume reported by the `onAudioVolumeIndication` callback was incorrect.
+- When the receiving end subscribes to the video small stream by default and does not automatically subscribe to any video stream when joining the channel, calling `muteRemoteVideoStream(uid, false)` after joining the channel to resume receiving the video stream results in receiving the video large stream, which is not as expected.
+- Calling `startAudioMixing [1/2]` and then immediately calling `pauseAudioMixing` to pause the music file playback does not take effect.
+- Occasional crashes during audio and video interaction.