diff --git a/dita/RTC-NG/release/release_notes.dita b/dita/RTC-NG/release/release_notes.dita index 07a5b27ad44..b490792e440 100644 --- a/dita/RTC-NG/release/release_notes.dita +++ b/dita/RTC-NG/release/release_notes.dita @@ -1,108 +1,105 @@ - - +<topic id="release-notes"> + <title>v4.2.3 + +

该版本于 2023 年 9 月 x 日发布。

+ - v4.2.3 - -

该版本于 2023 年 9 月 x 日发布。

- - - - <topic id="newfeature"> - <title>新增特性 - -
    -
  1. 视频截图上传更新 -

    为方便接入声网云市场提供的第三方视频审核服务，该版本有以下改动： -

      -
    • 中新增 枚举值，代表使用声网云市场视频审核插件对视频截图并上传。
      • -
    • 中的 type 新增 枚举值，代表使用声网云市场视频审核插件对视频截图并上传。
      • -
    • 中新增的 serverConfig 可选参数用于云市场视频截图上传相关服务端配置，配置后可同时接入多个云市场审核插件并实现灵活控制插件开关等功能，详情请。
      • -
    - 此外，该版本还新增了 方法，支持同时对多条视频流截图并上传。 -

    -
    2. -
  2. 支持 ID3D11Texture2D 渲染 -

    自该版本起，SDK 支持 ID3D11Texture2D 类型的视频格式，提升了游戏场景中视频帧的渲染效果。你可以在调用 方法将外部原始视频帧推送到 SDK 时，设置 format 为 VIDEO_TEXTURE_ID3D11TEXTURE2D；并通过设置 d3d11_texture_2d 和 texture_slice_index 属性，来确定要使用的 ID3D11Texture2D 纹理对象。

    -
    3. -
  3. 本地视频状态错误码更新 -

    为了帮助用户在屏幕共享场景下了解本地视频出错的准确原因， 回调中新增了如下几组枚举： + + <topic id="newfeature"> + <title>新增特性 + +

      +
    1. 视频截图上传更新 +

      为方便接入声网云市场提供的第三方视频审核服务，该版本有以下改动：

        -
      • (23)：屏幕采集已暂停。当前屏幕可能已切换到安全桌面，例如 UAC 对话框或者 Winlogon 桌面。
        • -
      • (24)：屏幕采集已从暂停状态中恢复。
        • -
      • (25)：当前屏幕采集的窗口处于隐藏状态，并且在当前屏幕上不可见。
        • -
      • (26)：进行屏幕采集的窗口已经从隐藏状态中恢复。
        • -
      • (27)：进行屏幕采集的窗口已经从最小化状态中恢复。
        • -

      -
      2. -
    - - - - 改进 - -
      -
    1. 优化虚拟背景内存占用 -

      该版本升级了虚拟背景算法，降低了虚拟背景功能的内存占用。相比之前的版本，在低端机上使用虚拟背景功能时 App 运行占用的内存降低了约 4%~10%（具体数值取决于设备型号和平台）。

      -
      2. -
    2. 屏幕共享场景优化 -

      该版本优化了在超高清（4K，60 fps）游戏共享场景下的性能和编码效率，有效降低了屏幕共享时系统资源占用率。

      -

      该版本优化了屏幕共享场景下的视频编码配置。当用户自定义视频的 width 和 height 属性时，SDK 会在保持视频与屏幕的宽高比一致的前提下，对实际的编码分辨率进行向下取整，确保最终编码分辨率不超过用户自定义的编码分辨率，从而提升了对屏幕共享流的计费准确性。

      -
      3. -
    -

    其他改进

    -

    该版本还进行了如下改进： +

  4. 中新增 枚举值，代表使用声网云市场视频审核插件对视频截图并上传。
    5. +
  5. 中的 type 新增 枚举值，代表使用声网云市场视频审核插件对视频截图并上传。
    6. +
  6. 中新增的 serverConfig 可选参数用于云市场视频截图上传相关服务端配置，配置后可同时接入多个云市场审核插件并实现灵活控制插件开关等功能，详情请。
    7. + + 此外，该版本还新增了 方法，支持同时对多条视频流截图并上传。 +

    + +
  7. 支持 ID3D11Texture2D 渲染 +

    自该版本起，SDK 支持 ID3D11Texture2D 类型的视频格式，提升了游戏场景中视频帧的渲染效果。你可以在调用 方法将外部原始视频帧推送到 SDK 时，设置 format 为 VIDEO_TEXTURE_ID3D11TEXTURE2D；并通过设置 d3d11_texture_2d 和 texture_slice_index 属性，来确定要使用的 ID3D11Texture2D 纹理对象。

    +
    8. +
  8. 本地视频状态错误码更新 +

    为了帮助用户在屏幕共享场景下了解本地视频出错的准确原因， 回调中新增了如下几组枚举：

      -
    • 优化了 SDK 采集和自定义视频采集场景下 Texture Buffer 的管理方式，有效消除丢帧和崩溃隐患。
      • -
    • 当调用 设置音频文件的播放进度时，传入非法参数后会返回错误码 -2，表示方法中设置了无效的参数，需要重新设置参数。
      • -
    • 优化了 Token 解析时的逻辑，避免传入非法 Token 后 App 发生崩溃。
      • +
    • (23)：屏幕采集已暂停。当前屏幕可能已切换到安全桌面，例如 UAC 对话框或者 Winlogon 桌面。
      • +
    • (24)：屏幕采集已从暂停状态中恢复。
      • +
    • (25)：当前屏幕采集的窗口处于隐藏状态，并且在当前屏幕上不可见。
      • +
    • (26)：进行屏幕采集的窗口已经从隐藏状态中恢复。
      • +
    • (27)：进行屏幕采集的窗口已经从最小化状态中恢复。

    - - - - 问题修复 - -

    该版本修复了以下问题：

    +
    9. +
+ + + + 改进 + +
    +
  1. 优化虚拟背景内存占用 +

    该版本升级了虚拟背景算法，降低了虚拟背景功能的内存占用。相比之前的版本，在低端机上使用虚拟背景功能时 App 运行占用的内存降低了约 4%~10%（具体数值取决于设备型号和平台）。

    +
    2. +
  2. 屏幕共享场景优化 +

    该版本优化了在超高清（4K，60 fps）游戏共享场景下的性能和编码效率，有效降低了屏幕共享时系统资源占用率。

    +

    该版本优化了屏幕共享场景下的视频编码配置。当用户自定义视频的 width 和 height 属性时，SDK 会在保持视频与屏幕的宽高比一致的前提下，对实际的编码分辨率进行向下取整，确保最终编码分辨率不超过用户自定义的编码分辨率，从而提升了对屏幕共享流的计费准确性。

    +
    3. +
+

其他改进

+

该版本还进行了如下改进： +

    +
  • 优化了 SDK 采集和自定义视频采集场景下 Texture Buffer 的管理方式，有效消除丢帧和崩溃隐患。
    • +
  • 当调用 设置音频文件的播放进度时，传入非法参数后会返回错误码 -2，表示方法中设置了无效的参数，需要重新设置参数。
    • +
  • 优化了 Token 解析时的逻辑，避免传入非法 Token 后 App 发生崩溃。
    • +

+ + + + 问题修复 + +

该版本修复了以下问题：

+
    +
  • 在屏幕共享场景下偶现崩溃、掉帧。
    • +
  • 在采用 H.265 编码模式时，如果 Web 端加入互动，会导致 Native 端出现冗余的 回调：当主播调用 (true)时，接收端在收到 (enabled 为 true) 回调之前，会先收到一个 (enabled 为 false) 回调。
    • +

  • 加入频道偶现的崩溃。(macOS)

    • +
  • 本地系统时间不正确时，偶现加入频道失败。
    • +
  • 调用 使用相同的 soundId 播放两个不同的音效文件，偶现第一个音效文件播放完毕后会重复播放。
    • +

  • 主播调用 播放音乐文件时，偶现主播本地无法听见音乐，远端用户可以正常听见。(Android)

    • +

  • 合唱场景下，调用 加载音乐，偶现加载失败。(Android, iOS)

    • +

  • 在特定机型上开启 AI 降噪偶现崩溃。(Android)

    • +

  • 当本地系统时间不准确时，歌曲榜单加载失败。(Android, iOS)

    • +
  • 调用一次 获取视频截图会收到多次 视频截图结果回调。
    • +

  • 在仅调用 加入的频道中，调用 无法将音频路由从扬声器切换至听筒。(Android)

    • +
+ + + + API 变更 + +

新增

    -
  • 在屏幕共享场景下偶现崩溃、掉帧。
    • -
  • 在采用 H.265 编码模式时，如果 Web 端加入互动，会导致 Native 端出现冗余的 回调：当主播调用 (true)时，接收端在收到 (enabled 为 true) 回调之前，会先收到一个 (enabled 为 false) 回调。
    • -

  • 加入频道偶现的崩溃。(macOS)

    • -
  • 本地系统时间不正确时，偶现加入频道失败。
    • -
  • 调用 使用相同的 soundId 播放两个不同的音效文件，偶现第一个音效文件播放完毕后会重复播放。
    • -

  • 主播调用 播放音乐文件时，偶现主播本地无法听见音乐，远端用户可以正常听见。(Android)

    • -

  • 合唱场景下，调用 加载音乐，偶现加载失败。(Android, iOS)

    • -

  • 在特定机型上开启 AI 降噪偶现崩溃。(Android)

    • -

  • 当本地系统时间不准确时，歌曲榜单加载失败。(Android, iOS)

    • -
  • 调用一次 获取视频截图会收到多次 视频截图结果回调。
    • -

  • 在仅调用 加入的频道中，调用 无法将音频路由从扬声器切换至听筒。(Android)

    • -
- - - - API 变更 - -

新增 +

  • 中新增如下枚举：
      -
    • 中新增如下枚举： -
        -
        • -
        • -
        • -
        • -
        • -
      • -
    • 中新增 d3d11_texture_2d 和 texture_slice_index 成员
      • -
    • 中新增 枚举
      • -
      • -
    • 新增
      • -
    • 中的 type 新增
      • -
    • 中新增 serverConfig 可选参数
      • -
      • -
      • -

    - - +
    • +
    • +
    • +
    • +
    • + +
  • 中新增 d3d11_texture_2d 和 texture_slice_index 成员
    • +
  • 中新增 枚举
    • +
    • +
  • 新增
    • +
  • 中的 type 新增
    • +
  • 中新增 serverConfig 可选参数
    • +
    • +
    • +

    +     diff --git a/dita/rtc_api.xpr b/dita/rtc_api.xpr index 3b4ce99e756..f8c8bc62ec5 100644 --- a/dita/rtc_api.xpr +++ b/dita/rtc_api.xpr @@ -7286,7 +7286,6 @@ - diff --git a/dita/templates-cn/RTC/Release-Notes.dita b/dita/templates-cn/RTC/Release-Notes.dita index 264644df8cc..a941741f2cb 100644 --- a/dita/templates-cn/RTC/Release-Notes.dita +++ b/dita/templates-cn/RTC/Release-Notes.dita @@ -1,89 +1,86 @@ - - +<topic id="release-notes"> + <title>v4.x.x + +

    该版本于 20xx 年 x 月 x 日发布。

    + - v4.x.x - -

    该版本于 20xx 年 x 月 x 日发布。

    - - - - <topic id="compatibility"> - <title>升级必看 - -
      -
    1. 升级必看的标题 -
        -
        • -
        • -
      2. -
    2. 升级必看的标题 -

      -
      3. -
    - -     - - 新增特性 - -
      -
    1. 新增特性名称 -
        -
        • -
        • -
      2. -
    2. 新增特性名称 -

      -
      3. -
    - -     - - 改进 - -
      -
    1. 改进名称 -
        -
        • -
        • -
      2. -
    2. 改进名称 -

      -
      3. -
    - -     - - 问题修复 - -
      -
    • -
    • -
    - -     - - API 变更 - -

    新增 -

      -
      • -

    -

    修改 + + <topic id="compatibility"> + <title>升级必看 + +

      +
    1. 升级必看的标题
        -
        • -

      -

      废弃 +

      3. +
      4. + +
    4. 升级必看的标题 +

      +
      5. +
    + +     + + 新增特性 + +
      +
    1. 新增特性名称
        -
        • -

      -

      删除 +

      3. +
      4. + +
    4. 新增特性名称 +

      +
      5. +
    + +     + + 改进 + +
      +
    1. 改进名称
        -
        • -

      - - +
      3. +
      4. + +
    4. 改进名称 +

      +
      5. +
    + +     + + 问题修复 + +
      +
    • +
    • +
    + +     + + API 变更 + +

    新增 +

      +
      • +

    +

    修改 +

      +
      • +

    +

    废弃 +

      +
      • +

    +

    删除 +

      +
      • +

    +