diff --git a/en-US/dita/RTC-NG/release/release_notes.dita b/en-US/dita/RTC-NG/release/release_notes.dita index 975275d914b..3a092c7026c 100644 --- a/en-US/dita/RTC-NG/release/release_notes.dita +++ b/en-US/dita/RTC-NG/release/release_notes.dita @@ -1,27 +1,119 @@ - v4.5.1 + v4.6.0 -

v4.5.1 was released on March 3, 2025.

+

v4.2.2 was released on April xx, 2025.

+ + + - <topic id="compatibility" props="native"> + <topic id="compatibility"> <title>Compatibility changes - -
    -
  • Starting from version 4.5.0, both RTC SDK and Signaling (version 2.2.0 and above) include the libaosl.solibaosl.dllaosl.xcframework library. If you manually integrate Video SDK via CDN and also use Signaling SDK, delete the earlier version of the libaosl.solibraryaosl.xcframework to avoid conflicts.
    • -
  • 4.5.1 RTC SDK libaosl.solibaosl.dllaosl.xcframework library version is 1.2.13. You can check the version information of the library in Info.plist. You can find out the version information of the library by checking the properties of the libaosl.dll file.
- +

This release has optimized the implementation of some functions, involving renaming or deletion of some APIs. To ensure the normal operation of the project, you need to update the code in the app after upgrading to this release.

+

各版本废弃及删除的 API 信息。 详见 API 下架说明API 下架说明API 下架说明API 下架说明。

+
    +
  1. 直推 CDN 相关接口废弃 +

    该版本废弃直推 CDN 功能的相关接口，并会在后续版本中删除，请改用服务端旁路推流。

    +
      +
      • +
      • +
      • +
      • +
      • +
      • +
      • +
      • +
      • +
    +
    2. +
  2. 虚拟节拍器接口废弃 +

    该版本废弃虚拟节拍器功能的相关接口，并会在后续版本中删除。

    +
      +
      • +
      • +
      • +
    +
    3. +
  3. 水印接口废弃 +

    该版本废弃水印功能的相关接口，推荐使用该版本新增的水印接口。

    +
      +
      • +
      • +
    +
    4. +
  4. 冗余接口删除 +

    该版本删除了下列冗余接口及参数：

    +
      +
    • setLocalPublishFallbackOption
      • +
    • onLocalPublishFallbackToAudioOnlydidLocalPublishFallbackToAudioOnly
      • +
    • onDownlinkNetworkInfoUpdateddownlinkNetworkInfoUpdate
      • +
    • onWlAccStatswlAccStats
      • +
    • onWlAccMessagewlAccMessage
      • +
    • enableWirelessAccelerate
      • +
    • WLACC_MESSAGE_REASONAgoraWlAccReason
      • +
    • WLACC_SUGGEST_ACTIONAgoraWlAccAction
      • +
    • WlAccStatsAgoraWlAccStats
      • +
    • receivedFramerate
      • +
    +
    5. +
  5. 美妆功能实现更变 +

    受美颜重构的影响，自 v4.6.0 起，不再支持调用 启用美妆功能，改用 STYLE_MAKEUP 节点实现。

    +
    6. +
  6. Int UID 和 String UID 映射行为变更 +
      +
    • v4.6.0 之前：如通过  使用字符串 UID （如“aa”）注册获取 Int UID（如 123），后续使用该 Int UID 加入频道时，SDK 会自动将其映射为原始注册字符串（"aa"）作为 String UID。
      • +
    • v4.6.0 及之后版本：SDK 不再自动将 Int UID 映射到注册时的原始字符串。 如果调用了  获取 Int UID，但需要使用原始字符串 UID 加入频道，请直接调用 通过原始字符串 UID 加入频道。 请在升级后检查并调整您的 App 逻辑，以确保用户以预期的身份加入频道。
      • +
    +
    7. +
New features
    -
  1. AI conversation scenario

    This version adds the audio scenario specifically designed for interacting with the conversational AI agent created by . This scenario optimizes the audio transmission algorithm based on the characteristics of AI agent voice generation, ensuring stable voice data transmission in weak network environments (for example, 80% packet loss rate), and ensuring the continuity and reliability of the conversation, adapting to a variety of complex network conditions.

    +
  2. 多路分辨率视频流 +

    该版本新增多路分辨率视频流（Adaptive Bitrate Video Streaming，简称 ABR）功能，支持对同一视频源设置同时发送多路不同分辨率的视频流，并支持多频道场景。 接收端通过自动/手动订阅目标分辨率的视频流。 你可以通过 配置不同分辨率的视频流，（最多四层分辨率，一个最高分辨率的主流和三层其他较低分辨率的视频流），并可以通过 设置视频流的分辨率、码率、是否在上行网络或设备性能较差时自动关闭多流。 启用分层推流回退后，SDK 会在弱网环境下自动回退到低分辨率的视频流，确保流畅的观看体验。 + 订阅端可根据实际需求，通过 选择想要接收的视频流。 适用于会议场景、大班课、互动直播等多终端、多网络环境，可显著提升弱网下的观看体验。

    +
    3. +
  3. 多路径网络传输 +

    该版本新增新增多路径传输功能，适用于终端支持多网卡传输(比如 5G， Wi-Fi，LAN)的设备，可以有效降低甚至消除弱网带来的体验回退，适用于弱网环境、对传输稳定性要求高的实时音视频通信场景，如车载、IoT、火车、高速公路等复杂网络环境。 通过在 中设置 enableMultipath 为 ，可开启多路径传输能力。 支持两种传输模式（）：

      +
    • 冗余发送模式：SDK 会根据网络状况动态选择最佳路径进行传输，适用于流量敏感，对体验要求比较高的场景，如会议、教育场景。 此外，还可通过 preferMultipathType 指定首选的传输网络路径类型（如优先 Wi-Fi 或移动网络）；如未设置，所有类型路径的权重默认相同。
      • +
    • 动态发送模式：数据会在所有可用网络路径（如LAN、Wi-Fi、移动网络）上同时传输，提升抗丢包和稳定性，可消除弱网，适用于流量不敏感，对体验有极致要求的场景，如户外采播、平行操控等。
      • +
    + 冗余发送模式会产生额外费用，如需使用请。 + 上下行还可分别通过 中的 uplinkMultipathMode、downlinkMultipathMode 配置。 启用后，SDK 会通过回调 实时上报各路径的传输统计信息，包括每一个传输路径的流量消耗，便于开发者监控和优化网络表现。

    +
    4. +
  4. 视频质量评分 +

    该版本在 中新增 mosValue 成员，报告声网实时视频 MOS（平均主观意见分）评估系统对接收到的远端视频流的质量评分。 评分共有 5 个档次，5 分表示视频画质优秀，画面清晰无噪点，1 分表示视频画质极差，画面严重模糊。 你可以通过该参数实时观测远端视频流的主观画质表现，便于动态调整视频参数、优化用户体验，或用于质量监控和告警等场景。 If you need to enable this function, contact .

    +
    5. +
  5. 支持添加多个水印 +

    该版本废弃了 和 方法，新增 和 方法，支持通过水印 ID 来给视频添加多个水印，并可对水印进行排序。 如果你需要移除指定水印，可调用 方法。

    +
    6. +
  6. 异步销毁引擎 +

    自该版本起， 方法新增 callback 参数，支持以同步或异步方式销毁引擎。 异步销毁引擎时，SDK 会触发 回调。

    +

    该版本新增 方法，用于销毁 RTC 引擎，且支持通过参数配置以同步或异步方式销毁引擎。 异步销毁引擎时，SDK 会触发 回调。

    +

    该版本新增 方法，用于销毁 RTC 引擎，且支持通过参数配置以同步或异步方式销毁引擎。 异步销毁引擎时，SDK 会触发 engineReleasedBlock 回调块。

    +
    7. +
  7. 美颜功能拓展 +

    新增白牙、去法令纹、去黑眼圈、亮眼等美肤功能；美妆特效新增卧蚕和面部高光；美型功能从 11 个增加到 29 个。

    +
    8. +
  8. Token 更新结果回调 +

    该版本新增 回调及 RENEW_TOKEN_ERROR_CODE 错误码。 当调用 方法更新 Token 后，SDK 会通过 回调通知 Token 更新的结果，并通过 RENEW_TOKEN_ERROR_CODE 返回详细的错误码，开发者可在回调中根据错误码及时处理 Token 更新失败的场景。

    +
    9. +
  9. Others
      +
    • 新增 方法用于设置 回调中返回的音频帧格式，包括采样率、声道数以及每次回调的数据采样点数。 调用此方法后，SDK 会按照设定的参数返回混音前的原始音频数据，便于开发者进行自定义处理或分析。
      • +
    • 新增 方法，用于将指定音效文件预加载到指定频道，支持本地或在线音效文件，便于后续快速播放，适合多频道场景。
      • +
    • 新增 方法，用于在指定频道播放音效文件，支持设置循环次数、音调、空间位置、音量、是否发布到频道及播放起始位置等参数，满足丰富的音效播放需求。
      • +
    • 本地截图上传功能支持通过 中新增的 position 成员设置截图的视频观测位置，从而实现对原始视频数据或效果处理前后的视频流进行截图并上传。
      • +
    • 为了提升用户使用绿幕或蓝幕开启虚拟背景功能时，人像分割的准确性和稳定性，该版本在 中新增 screenColorType 属性，支持指定背景幕布的颜色为绿色、蓝色或自动识别。
      • +
@@ -30,7 +122,22 @@ Improvements
    -
  1. Reduced the time of initializing the SDK on specific device models. (iOS)
    2. +
  2. 美颜重构 +

    该版本对美颜功能进行了彻底重构和升级，不进拓展了美颜功能，提升了美颜效果和性能，还解决了美颜参数配置复杂、集成成本高、美颜资源依赖网络易失效等痛点。 主要改进包括：

      +
    • API 大幅简化：将过去版本中的基础美颜、美型、美妆、滤镜功能整合为 、、 三个核心节点 (node)，通过 统一管理生命周期和参数设置，减少频繁 API 调用带来的性能负担。
      • +
    • 预设模板开箱即用：提供多套预设风格模板（如“自然美颜”、“学姐妆”、“冷白滤镜”），大幅简化集成流程，无需手动调试数十项参数。
      • +
    • 美颜参数动态控制：该版本新增实时获取美颜参数的能力，开发者可通过 key-value 方式动态读取或修改任意细粒度参数（如磨皮强度、口红类型）。 同时支持：调用预设模板快速启用风格效果、保存主播自定义参数配置、随时重置参数至默认状态，极大提升了业务层状态同步的灵活性和开发效率。
      • +
    • 美颜资源外置：该版本通过美颜资源外置化设计，将所有美颜资源（特效、滤镜、妆容）均打包为本地 bundle 文件，彻底消除因网络下载失败导致美颜失效的风险。
      • +
    +

    +
    3. +
  3. Other Improvements
      +
    • 优化了在 Windows 11 24H2 及后续版本上的权限请求，避免非必要地获取位置信息。 (Windows)
      • +
    • 在与 Web 端互通时，新增对 g711 和 g722 音频编解码器的支持，进一步提升了跨平台音频播放的兼容性和清晰度。
      • +
    • 优化了插件加载的方式，用 C++ 开发 Android App 支持自动加载 SDK 的动态库插件。
      • +
    • 优化了屏幕共享文档场景下的共享视频清晰度。
      • +
    +
@@ -39,19 +146,15 @@

This release fixed the following issues: