diff --git a/en-US/dita/RTC-NG/release/release_ng_4.3.2.dita b/en-US/dita/RTC-NG/release/release_ng_4.3.2.dita new file mode 100644 index 00000000000..f1653c46be8 --- /dev/null +++ b/en-US/dita/RTC-NG/release/release_ng_4.3.2.dita @@ -0,0 +1,101 @@ + + + + v4.3.2 + +

This version was released on May x, 20xx.

+ + + + <topic id="compatibility" props="hide"> + <title>Upgrade Notes + +
    +
  1. Important Upgrade Information +
      +
      • +
      • +
    +
    2. +
  2. Important Upgrade Information +

    +
    3. +
+ + + + New Features + +
    +
  1. New Feature Name +
      +
      • +
      • +
    +
    2. +
  2. New Feature Name +

    +
    3. +
+ + + + Improvements + +
    +
  1. This release enhances the usability of the method by removing the timing requirements for invocation. It can now be called both before and after joining the channel to dynamically switch audio and video stream fallback options in weak network conditions.
    2. +
  2. The Agora media player supports playing MP4 files with an Alpha channel. (iOS, Android)
    3. +
  3. The Agora media player fully supports playing music files located in the /assets/ directory or from URI starting with content://. (Android)
    4. +
+ + + + Issues fixed +

This version fixed the following issues:

+ + + + + API Changes + +

Added +

+

+

Modified +

+

+

Deprecated +

+

+

Removed +

+

+ + + + \ No newline at end of file diff --git a/en-US/dita/RTC-NG/release/release_notes.dita b/en-US/dita/RTC-NG/release/release_notes.dita index f1653c46be8..b47746a6466 100644 --- a/en-US/dita/RTC-NG/release/release_notes.dita +++ b/en-US/dita/RTC-NG/release/release_notes.dita @@ -1,40 +1,78 @@ - v4.3.2 + v4.4.0 -

This version was released on May x, 20xx.

+

This version was released on July x, 2024.

- <topic id="compatibility" props="hide"> - <title>Upgrade Notes + + Compatibility changes +

This version includes optimizations to some features, including changes to SDK behavior, API renaming, or removal. To ensure your project runs smoothly, you need to update the code in your app after upgrading to this version. + Starting from v4.4.0, the RTC SDK provides an API deprecation notice, which includes information about deprecated and removed APIs in each version. See API Deprecation NoticeAPI Deprecation NoticeAPI Deprecation NoticeAPI Deprecation Notice.

    -
  1. Important Upgrade Information -
      -
      • -
      • -
    -
    2. -
  2. Important Upgrade Information -

    +
  3. To distinguish context information in different plugin callbacks, this version removes the original plugin-related callbacks and adds corresponding callbacks that can identify plugin context information (see the table below). You can learn the plugin name, user ID using the plugin, and the service provider name through the in each callback. + + + Original Callback + Current Callback + + + onExtensionEvent + + + + onExtensionStarted + + + + onExtensionStopped + + + + onExtensionError + + +
    4. +
  4. Before v4.4.0, when your user role was set to audience, calling to set the audio scenario to chatroom () would trigger a microphone permission request popup. From v4.4.0 onwards, the SDK uses native iOS APIs to control the microphone, so audience users in a chatroom scenario will no longer see the microphone permission request popup.
    5. +
  5. This version renames the receiveMetadata callback to and removes the data and timeStamp parameters. You can get metadata-related information, including timeStamp (timestamp of the sent data), uid (user ID), and channelId (source channel name) through the new metadata parameter.
    6. +
  6. This version removes the callback's buffer, uid, and timeStampMs parameters. You can get metadata-related information, including timeStampMs (timestamp of the sent data), uid (user ID), and channelId (source channel name) through the new metadata parameter.
 - + New Features
    -
  1. New Feature Name +
  2. Lite SDK +

    Starting from this version, Agora introduces the Lite SDK, which includes only the basic audio and video capabilities and partially cuts high-level audio and video processing features, effectively reducing the app size after integrating the SDK.

    +
      +
    • Lite SDK supports manual integration or third-party repository integration. For details, see and .
      • +
    • For information on dynamic libraries included in the Lite SDK, see .
      • +
    • For the list of APIs supported by the Lite SDK, see Lite SDK API ListLite SDK API List.
      • +
    +
    3. +
  3. Alpha Transparency Effects +

    This version introduces the Alpha transparency effects feature, supporting the transmission and rendering of Alpha channel data in video frames for SDK capture and custom capture scenarios, enabling transparent gift effects, custom backgrounds on the receiver end, etc.:

      -
      • -
      • +
    • and add the alphaBuffer: Set the Alpha channel data.
      • +
    • adds the fillAlphaBuffer: For BGRA or RGBA formatted video data, set whether to automatically extract the Alpha channel data and fill it into alphaBuffer.
      • +
    • and add the alphaStitchMode: Set the relative position of alphaBuffer and video frame stitching.
    +

    Additionally, adds a new member encodeAlpha, which is used to set whether to encode and send Alpha information to the remote end. By default, the SDK does not encode and send Alpha information; if you need to encode and send Alpha information to the remote end (e.g., when virtual background is enabled), explicitly call to set the video encoding properties and set encodeAlpha to .

    4. -
  4. New Feature Name -

    +
  5. AI Voice Tuner +

    This version introduces the AI Voice Tuner feature, which can enhance the sound quality and tone, similar to a physical sound card. You can enable the AI Voice Tuner feature by calling the method and passing in the sound effect types supported in the enum to achieve effects like deep voice, cute voice, husky singing voice, etc.

    +
    6. +
  6. Copyright Music Optimization +
      +
    • This version adds the method under the class to set the playback mode of music resources. In online karaoke room scenarios, you can enable accompaniment, original singing, or guide singing mode as needed.
      • +
    • This version adds the method under the class to destroy the music player and release the corresponding resources.
      • +
    • This version deprecates the method under the class. To destroy the music player, use the new method under the class.
      • +
@@ -43,59 +81,45 @@ Improvements
    -
  1. This release enhances the usability of the method by removing the timing requirements for invocation. It can now be called both before and after joining the channel to dynamically switch audio and video stream fallback options in weak network conditions.
    2. -
  2. The Agora media player supports playing MP4 files with an Alpha channel. (iOS, Android)
    3. -
  3. The Agora media player fully supports playing music files located in the /assets/ directory or from URI starting with content://. (Android)
    4. +
  4. Adaptive Hardware Decoding Support (Android, Windows) +

    This release introduces adaptive hardware decoding support, enhancing rendering smoothness on low-end devices and significantly reducing system load.

    +
    5. +
  5. Rendering Performance Enhancement (Windows) +

    DirectX 11 renderer is now enabled by default on Windows devices, providing high-performance and high-quality graphics rendering capabilities.

    +
    6. +
  6. Facial Region Beautification +

    To avoid losing details in non-facial areas during heavy skin smoothing, this version improves the skin smoothing algorithm. It now recognizes various parts of the face, applying smoothing to facial skin areas excluding the mouth, eyes, and eyebrows, and supports smoothing up to two faces simultaneously.

    +
    7. +
  7. Other Improvements +

    This version also includes the following improvements: +

      +
    • Optimized transmission strategy: invoking no longer impacts the security of the transmission link.
      • +
    • callback now includes the enumeration, indicating that the display used for screen capture has been disconnected. (Windows, macOS)
      • +
    • Optimized the video link for window sharing, reducing CPU usage. (macOS)
      • +
    • Improved echo cancellation for screen sharing scenarios.
      • +
    • Added channelId parameter to , enabling retrieval of the source channel name for sent Metadata.
      • +
    • Deprecated redundant enumeration values and in .
      • +
    • Optimized parameter types for the following APIs to enhance code readability, reduce potential errors, and facilitate future maintenance: +
        +
      • Deprecated option parameter of type int in , introduced overloaded function with option parameter of type .
        • +
      • Deprecated streamType parameter of type int in , , and , introduced overloaded functions , , and with streamType parameter of type .
        • +
      • +

    +
Issues fixed -

This version fixed the following issues:

+ +

This release fixed the following issues:

    -
  • The remote video froze or became pixelated when the app returned to the foreground after being in the background for a long time. （iOS）
    • -
  • The local preview image rotated by 90° on some iPad devices, which did not meet expectations. （iOS）
    • -
  • Occasional video smoothness issues during audio and video interactions.
    • -
  • The app occasionally crashed when the decoded video resolution on the receiving end was an odd number.
    • -
  • The app crashed when opening the app and starting screen sharing after the first installation or system reboot. (Android)
    • -
  • Local audio capture failed after joining a channel while answering a system phone call and hanging up, causing remote users to not hear any sound. (Android)
    • -
  • During the interaction process on certain devices (for example, Redmi Note8), after answering and hanging up a system call, local media files were played without sound and no sound was heard from the remote end. (Android)
    • -
  • Fixed an occasional crash when remote users left the channel.
    • -
  • The screen occasionally flickered on the receiver's side when sharing a PPT window using and playing PPT animations. (Windows)
    • -
  • The window border did not retain its original size after exiting the presentation and then maximizing the PPT window when sharing a WPS PPT window on Windows 7 using and setting enableHighLight in to . (Windows)
    • -
  • The specified window could not be brought to the foreground if it was covered by other windows when sharing a window using and setting windowFocus and enableHighLight in to . (Windows)
    • -
  • Clicking on the desktop widget caused the outlined part to flicker when sharing and highlighting a window on a Windows 7 device. (Windows)
    • -
  • The values of cameraDirection and focalLengthType in returned by could not be read directly.
    • -
  • When playing an audio file using and the playing finished, the SDK sometimes failed to trigger the (, ) callback which reports that the playing is completed. (iOS)
    • -
  • When calling the method to play sound effect files shorter than 1 second with loopCount set to 0, there was no sound. (iOS)
    • -
  • When using the Agora media player to play a video and stopping it during playing, sometimes there was no sound for a short time after the playing was resumed. (iOS)
    • +
  • Occasional app crashes occurred when multiple remote users joined the channel simultaneously during real-time interaction. (iOS)
    • +
  • Remote video occasionally froze or displayed corrupted images when the app returned to the foreground after being in the background for a while. (iOS)
    • +
  • After the sender called to start direct CDN streaming, frequent switching or toggling of the network occasionally resulted in a black screen on the receiver's end without a streaming failure callback on the sender's end. (iOS)
    • +
  • Audio playback failed when pushing external audio data using if the external audio rendering sample rate was not the recommended value by the SDK, such as 22050 Hz and 11025 Hz.
- - - API Changes - -

Added -

    -
    • -
-

-

Modified -

    -
    • -
-

-

Deprecated -

    -
    • -
-

-

Removed -

    -
    • -
-

- - + - \ No newline at end of file +