Merge pull request #3300 from AgoraIO/fix-4.2.2-release-notes

Electron: add 4.2.2 release notes
AgoraIO · Aug 7, 2023 · 2b23027 · 2b23027
2 parents 29213f0 + 2158167
commit 2b23027
Show file tree

Hide file tree

Showing 2 changed files with 123 additions and 0 deletions.
diff --git a/markdown/RTC 4.x/release-notes/en-US/framework/release_electron_audio_ng.md b/markdown/RTC 4.x/release-notes/en-US/framework/release_electron_audio_ng.md
@@ -1,3 +1,45 @@
+## v4.2.2
+
+v4.2.2 was released on July xx, 2023.
+
+#### New features
+
+1. **Wildcard token**
+
+   This release introduces wildcard tokens. Agora supports setting the channel name used for generating a token as a wildcard character. The token generated can be used to join any channel if you use the same user id. In scenarios involving multiple channels, such as switching between different channels, using a wildcard token can avoid repeated application of tokens every time users joining a new channel, which reduces the pressure on your token server. See [Wildcard tokens](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/wildcard_token?platform=All%20Platforms).
+
+   <div class="alert note">All 4.x SDKs support using wildcard tokens.</div>
+
+2. **Preloading channels**
+
+   This release adds `preloadChannel` and `preloadChannelWithUserAccount` 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).
+
+#### Improvements
+
+**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.
+
+
+#### Issues fixed
+
+This release fixed the following issues:
+
+- Occasionally, noise occurred when the local user listened to their own and remote audio after joining the channel. (macOS)
+- Slow channel reconnection after the connection was interrupted due to network reasons.
+- In multi-device audio recording scenarios, after repeatedly plugging and unplugging or enabling/disabling the audio recording device, no sound could be heard occasionally when calling the `startRecordingDeviceTest` to start an audio capturing device test. (Windows)
+
+#### API changes
+
+**Added**
+
+- `preloadChannel`
+- `preloadChannelWithUserAccount`
+- `updatePreloadChannelToken`
+
+
 ## v4.2.1
 
 This version was released on June 21, 2023.

diff --git a/markdown/RTC 4.x/release-notes/en-US/framework/release_electron_ng.md b/markdown/RTC 4.x/release-notes/en-US/framework/release_electron_ng.md
@@ -1,3 +1,84 @@
+## v4.2.2
+
+v4.2.2 was released on July xx, 2023.
+
+#### New features
+
+1. **Wildcard token**
+
+   This release introduces wildcard tokens. Agora supports setting the channel name used for generating a token as a wildcard character. The token generated can be used to join any channel if you use the same user id. In scenarios involving multiple channels, such as switching between different channels, using a wildcard token can avoid repeated application of tokens every time users joining a new channel, which reduces the pressure on your token server. See [Wildcard tokens](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/wildcard_token?platform=All%20Platforms).
+
+   <div class="alert note">All 4.x SDKs support using wildcard tokens.</div>
+
+2. **Preloading channels**
+
+   This release adds `preloadChannel` and `preloadChannelWithUserAccount` 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.
+
+4. **Publishing video streams from different sources** (Windows, macOS)
+
+   This release adds the following members in `ChannelMediaOptions` to allow you publish video streams captured from the third and fourth camera or screen:
+
+   - `publishThirdCameraTrack`: Publishing the video stream captured from the third camera.
+   - `publishFourthCameraTrack`: Publishing the video stream captured from the fourth camera.
+   - `publishThirdScreenTrack`: Publishing the video stream captured from the third screen.
+   - `publishFourthScreenTrack`: Publishing the video stream captured from the fourth screen.
+
+   <div class="alert note">For one <code>RtcConnection</code>, Agora supports publishing multiple audio streams and one video stream at the same time.</div>
+
+#### Improvements
+
+1.  **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.
+
+2. **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.
+
+3. **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. The SDK automacially 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.
+2. To help users understand the reasons for more types of remote video state changes, the `remoteVideoStateReasonCodecNotSupport` 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:
+
+- Occasionally, noise occurred when the local user listened to their own and remote audio after joining the channel. (macOS)
+- 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.
+- In multi-device audio recording scenarios, after repeatedly plugging and unplugging or enabling/disabling the audio recording device, no sound could be heard occasionally when calling the `startRecordingDeviceTest` to start an audio capturing device test. (Windows)
+
+#### API changes
+
+**Added**
+
+- `preloadChannel`
+- `preloadChannelWithUserAccount`
+- `updatePreloadChannelToken`
+- The following members in `ChannelMediaOptions`:
+  - `publishThirdCameraTrack`
+  - `publishFourthCameraTrack`
+  - `publishThirdScreenTrack`
+  - `publishFourthScreenTrack`
+- `CodecCapLevels`
+- `VideoCodecCapabilityLevel`
+- `backgroundColor` in `VideoCanvas`
+- `codecLevels` in `CodecCapInfo`
+- `remoteVideoStateReasonCodecNotSupport` in `RemoteVideoStateReason`
+
+
 ## v4.2.1
 
 This version was released on June 21, 2023.