该版本于 2023 年 3 月 1 日发布。
此次升级包含的客户端系统有：Android、iOS、macOS、Windows、Linux。若无特殊说明，本次发版说明中提及的变动适用于上述所有平台。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 自定义流处理
• 音频管理
• 高级功能

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 新增回调获取屏幕共享的音频帧地址，供自定义音频处理。具体参见：

2. 桌面端新增回调通知麦克风和扬声器的音量调整和静音状态变化。具体参见：

3. 支持在客户端截取本地/远端视频截图。参看：

1. 丰富通过网络质量回调获取到的网络状态，支持获取网络断开状态。

2. 设备成功连接蓝牙耳机但 sco 连接开启失败后，设备音频播放模式将由通话模式切换为媒体模式，即使用蓝牙耳机播放声音，优化听感体验。
3. Android Target 31 API 环境下，语音通话中设备连接蓝牙时，无需向系统申请蓝牙权限，实现无感连接。

该版本于 2023 年 1 月 17 日发布。
此次升级包含的客户端系统有：Android、iOS、macOS、Windows、Linux（版本号为 3.45.2）

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 音频管理
• 视频管理
• CDN 推流
• 自定义流处理
• 混音
• 音视频处理
• 音视频传输

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。
如果开发目标平台为 Android 12(targetSdkVersion>=31) 及以上版本的应用，请先参考OpenCL 库 Android 12 适配说明。

1. 在调用 enableAudioPropertiesReport，获取本地音频信息时，支持设置获取本地混音音频信息。
2. 支持单流直播功能。你可以使用纯 RTC 的能力，实现更低延迟，更低成本的直播功能。参看：

3. 新增回调获取软件耳返数据的音频帧地址，供自定义音频处理。参看：

4. 支持获取混音音频文件的实际播放时长，即歌曲不受停止、跳转、倍速、卡顿影响的播放时长。参看：

5. 各端支持通过 RTC SDK 中的接口调用 SAMI 能力实现 K 歌打分。参看：

6. 新增接口支持订阅所有用户和取消订阅所有用户。对上麦人数固定的场景中，可以使用以下接口快速实现麦位切换。参看：

7. 移动端支持通过一次接口调用，统一设置全局混音文件音量。参看：

1. iOS 端混音支持 iTunes 本地音乐文件。
2. Android 端启用耳返时，自适应启用硬件耳返。参看 setEarMonitorMode。

1. 修复了 VP8 编码时，iOS 屏幕共享相关的问题。
2. 修复了部分安卓机型回声消除失效问题。

该版本于 2022 年 12 月 9 日发布。
此次升级包含的客户端系统有：Android、iOS、macOS、Windows

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 音视频处理

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

该版本于 2022 年 12 月 9 日发布。
此次升级包含的客户端系统有：Linux、Flutter、Electron

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 音视频处理

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. Linux 平台 SDK 新增视频水印功能。你可以调用 setVideoWatermark 为指定的视频流添加水印，调用 clearVideoWatermark 移除水印。

该版本于 2022 年 8 月 5 日发布。

1. 自 3.44 版本起，正式提供 RTC SDK for macOS，提供原生 Objective-C 接口，此 SDK 可以在 macOS 10.10+ 版本集成使用。
2. 自 3.44 版本起，正式提供 RTC SDK for Linux(x86)。此 SDK 可以在支持 glibc 2.27+ 的 Linux 版本配合 x86 处理器架构的硬件上使用。
3. 自 3.44 版本起，正式提供包装原生平台 RTC SDK 接口的 Flutter 插件，用于进行跨平台开发时，接入实时音视频功能。此插件可以在 Android API Level 19+ 或 iOS 9.0+ 版本使用。
4. 自 3.44 版本起，正式提供包装原生平台 RTC SDK 接口的 Electron SDK，用于开发可以在 macOS 和 Windows 端上使用的实时音视频 Electron 应用。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 消息
• 自定义流处理

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 支持移动端在自定义视频处理和编码环节之前，将视频帧中的旋转角处理为 0，并在整个 RTC 链路中传递调整后的视频帧。适用于单流转推、使用视频特效贴纸或自定义视频前处理等场景，具体参看：

1. 调用 joinRoom 加入房间时，由于 UserID、Token 等参数错误导致进房失败后，可以直接再次调用 joinRoom 重新发起进房，无需先调用 leaveRoom 离开房间后再进房。

该版本于 2022 年 7 月 21 日发布。

为提升接口易用性，该版本引入了 SDK 整体架构的重大变更，具体表现为去除了引擎类和房间类中的重复 API，并根据 API 的作用域明确划分所属类，接口变更详情参看：升级指南。
基于旧架构的 API 将会在本版本后停止更新，因此强烈建议升级到新架构版本。如果你依旧需要使用旧架构，老版本 API 文档归档中提供了 3.43.1 版本旧架构下的参考文档。
各个平台上另有 API/回调/数据结构发生了变化。变化范围包括：

• CDN 推流
• 高级功能

1. 扩展了转推直播配置参数结构体，支持图片合流。可以通过startLiveTranscoding和updateLiveTranscoding进行设置，具体参数结构参看：

1. 范围语音功能增加了音量衰减模式的选择接口，可根据场景需要，选择音量根据距离线性衰减或非线形衰减。音量随距离增大进行非线性衰减更符合真实世界中声音的表现。具体参看：

该版本于 2022 年 7 月 8 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 音视频传输：明确 LocalVideoStats 和 RtcRoomStats 中部分成员变量的含义
• 音视频处理
• 网络管理
• 消息
• 多房间

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。
注意：此版本不提供多房间能力，如果需要使用多房间功能，请使用 3.41 版本。

1. 当使用外置声卡进行音频采集时，支持设置对应的音频处理模式，以获得最佳的音质。具体参看：

2. 向所有用户提供包括美白、磨皮、锐化的基础美颜功能，无需额外鉴权。基础美颜接口不能与高级视频特效接口共用，如已购买高级视频特效，建议调用原接口使用高级特效、贴纸功能等。具体参看：

3. 新增音频采集和播放设备测试功能，在通话前进行录音和播放测试，确保通话顺利进行。或者在通话中遇到无声问题时，发起音频设备检测，快速排查和定位问题。具体参看：

4. 新增 P2P 音视频传输接口和回调，适合游戏串流业务及其他 IOT 局域网中的实时音视频通话。由于串流场景的建联以及数据流的传输路径都与常规音视频通话有较大不同，使用一套独立的接口。使用该功能前，请联系售前或技术支持获取包含 P2P 音视频传输功能的 SDK 包。
5. 支持在音视频通话前进行通话回路测试，包括对音视频采集/播放设备，以及上下行网络的测试，以便在通话开始前确认设备可用性及音视频流回路是否通畅，保证通话链路的整体连通性，具体参看：

6. 房间内点对点消息、房间外点对点消息、房间广播消息均支持超低延时传输。
7. 支持对在本地采集的音频和收到的来自远端的音频进行自定义处理。丰富了适用的音频场景范围，具体参看：

8. 各端支持 VP8 编码。

1. 移动端音频路由设置优化，setDefaultAudioRoute 选择设备的听筒或扬声器作为默认音频路由。setAudioRoute 支持更多音频设备类型，例如有线耳机、蓝牙耳机等，但只支持在 AUDIO_SCENARIO_COMMUNICATION 通话场景下调用生效。
2. PC 端屏幕共享能力扩展，增加了枚举共享对象缩略图、应用图标和应用名称等信息，用于对应用进行分类展示，方便用户选取屏幕共享对象。
3. 增强了 PC 端的音视频设备管理能力，提供了更多设备信息，例如是设备连接类型，是否为虚拟设备等。新增部分为对原有逻辑的扩展，之前使用方式不受影响。
4. 提升音频属性设置接口易用性，丰富了音频场景 roomProfile 和音质选项 AudioProfileType，满足更多不同场景的需要。 roomProfile 既可以在客户端设置，也可以通过配置下发。在选定的音频场景 roomProfile 基础上，调用 AudioProfileType 切换音质档位。
5. 细化了转推直播的任务状态回调，具体参看：

1. 修复某些情况下退后台采集停止及音画不同步等问题。

该版本于 2022 年 6 月 18 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 视频管理
• 高级功能

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 移动端支持手动对焦、曝光功能，具体参看：

2. 优化了空间音频的朝向体验。在通话过程中，RTC 将根据通话用户各自的朝向渲染音频，收听者可以感受到发言者朝向改变带来的空间音频效果。具体参看空间音频。

3. 支持云代理功能。能够在有防火墙限制的情况下，通过云代理实现正常的音视频通话。具体参看：

该版本于 2022 年 6 月 3 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 音视频传输
• 转推直播
• 高级功能

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 发流端同时使用两个设备分别采集音频和视频时，支持设置音画同步，具体参看 setMultiDeviceAVSync。
2. 支持范围语音能力，同一房间中设定范围内的音源音量随距离增加呈衰减效果，具体参看范围语音文档。使用该功能需持有 Room 对象。

1. 支持在同一个音视频通话中，音频采集和渲染方式相互独立。对于收到的音频流，无论是通过 SDK 内部采集得到的，还是自定义采集得到的，在进行渲染播放时，都可以采用内部音频渲染或自定义音频渲染。

2. 优化服务端合流转推的默认音频参数。

该版本于 2022 年 5 月 27 日发布。

此版本是 hotFix 版本，修复了在 Android， iOS 平台上使用共享屏幕功能时，可能发生闪退的问题。

该版本于 2022 年 5 月 18 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 取消订阅逻辑变化：
  • 3.39 以前版本：调用 unsubscribeStream 后，如果目标用户退房重进或切换隐身 状态，取消订阅的状态失效。
  • 3.39 及以后版本：调用 unsubscribeStream 后，在本地用户退房前，取消订阅的状态有效，即使目标用户退房重进或切换隐身状态。

• 即时消息
• 音视频处理

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 大会模式和音频选路功能正式上线。支持容纳高达千人的音视频互动。功能详细介绍和使用信息参看大会模式和音频选路。
2. 在 RTC 客户端向应用服务端发送实时消息时，可以通过相应回调获取来自应用服务端的 response 消息。

3. 支持视频水印功能

该版本于 2022 年 5 月 6 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 视频管理
• 混音
• 房间管理
• 音频设备管理

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 当通话被系统电话、锁屏或合盖等打断时，支持暂停采集音视频，并在打断结束后自动恢复。具体参看通话打断和恢复。
2. 在 Android 和 iOS 平台上，支持获取当前的音频路由设置。参考 getAudioRoute。
3. 在 Windows 平台上，支持音频播放和采集路由跟随系统的路由设置。参看 FollowSystemPlaybackDevice 和 FollowSystemCaptureDevice。
4. 支持调整音视频通话中使用的音频文件的播放速度，参看 setAudioMixingPlaybackSpeed。
5. 音视频通话外的系统音频支持根据远端音量进行闪避，参看 enablePlaybackDucking

1. 修复 iOS 成功集成 CV SDK 后返回值仍为未集成的问题。

该版本于 2022 年 4 月 22 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 视频管理
• 视频特效
• 音视频回退
• 音频数据回调

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 支持公共流的发布和订阅，用户发布公共流后，使用同一个 appID 的用户无需进房即可订阅。详见发布和订阅公共流。
2. 支持在音频数据回调中获取订阅的远端每个用户混音前的音频数据回调，音频回调方法在method中进行设置。具体参看 API 文档：

3. 支持关闭音频回调。具体参看 API 文档：

1. 优化视频采集模块，提升逆光、纯色光下白平衡和曝光准确度。升级后 Android 须在 gradle 里引入kotlin，iOS 须申请摄像头权限。

该版本于 2022 年 4 月 2 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 混音
• 房间管理
• 屏幕共享
• 转推直播

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 新增 setVideoRotationMode 支持设置内部视频采集旋转模式，满足不同业务场景需求，详见视频采集旋转方向。

2. 本地/远端视频流渲染能力增强：

• 支持 Fill 模式：在此模式下，视频帧会非等长宽比缩放并填满画布。
• 支持在视频帧未填满画布时，空缺区域设置背景颜色。
• 渲染时，支持调用 updateLocalVideoCanvas 和 UpdateRemoteStreamVideoCanvas 进行渲染设置调整。

3. 支持通过 onNetworkQuality 回调监测本端和已订阅用户的网络质量评分，详见通话质量监测。

4. 移动端支持更新屏幕内部采集的媒体类型，参看：

5. 使用 RTC SDK 中包含的 CV 特效时，可以通过 onFaceDetectResult 获取人脸检测结果。

6. 支持单个用户在同一房间内发起多个转推直播任务，具体参看 API 文档：

7. 收到用户离开房间回调 onUserLeave 时，支持区分用户主动离房行为和用户切换隐身身份。

8. 支持通过 onActiveSpeaker 获取房间内最活跃用户（Active Speaker）的信息。本地和远端音量回调（onLocalAudioPropertiesReport 和 onRemoteAudioPropertiesReport ）支持同时返回线性和非线性音量值。

9. 增强混音功能：

• 全平台支持在线音频文件混音，参看 startAudioMixing。
• Android 平台混音时，支持传入 URI 或 以 /assets/ 开头的本地文件。

1. 移动端支持屏幕音频内部采集，参看：

2. 重新设计媒体流的控制接口，实现了摄像头/麦克风采集的媒体流与屏幕共享媒体流的分离控制，同时支持灵活控制媒体流的发布/取消发布、订阅/取消订阅，具体接口变更参看升级指南。

3. 优化视频大小流的发布订阅流程，发布端开启发送多路流模式后，订阅端可自行设置期望订阅的视频参数，由发布端根据订阅端的设置自动匹配参数相近的流进行发送，具体参看 推送多路流。

4. 丰富性能回退场景下视频的降级档位，具体参看音视频回退

1. 各端修复在手动订阅模式下，仍会在进房时自动订阅远端屏幕流的问题。

该版本于 2022 年 3 月 21 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 混音
• 音频管理
• 视频管理

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 本地视频采集支持设置采集模式，包括自动设置采集参数（默认）、手动设置采集参数、与编码参数保持一致三种模式供用户灵活配置，具体参看 VideoCaptureConfig。默认模式采集的本地预览视频清晰度和帧率较之前版本均有提高，但在美颜特效等场景下性能会受一定影响，如若介意，则将采集模式设置为与编码参数保持一致即可。
2. 优化现有空间音频功能，在游戏的小队模式中支持开启空间音频。

1. 原 OnFirstRemoteVideoFrameRendered 回调名称与行为不一致，回调时机为第一帧远端视频解码后渲染前。新版本中该回调改为于渲染成功后触发，而第一帧远端视频解码后渲染前改为触发 OnFirstRemoteVideoFrameDecoded回调。

1. 移动端支持均衡混音中音频与人声的音量，避免混音音频或人声出现音量过大或过小的情况，导致听感体验下降，具体参看 API 文档：

2. 移动端新增音量闪避功能，当检测到远端人声时，本地播放音频音量自动减弱，从而保证远端人声清晰可辨，具体参看 API 文档：

该版本于 2022 年 3 月 7 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 混音
• 跨房间推流
• 屏幕共享
• 引擎管理

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 自定义视频前处理节点由采集后移至编码前，可以针对镜像、CV 等处理后的视频画面进行二次加工，使得远端可以正常接收二次加工后的视频效果
2. 屏幕采集回调中清晰定义启动、暂停、恢复、错误、停止五个状态，使用户能够通过回调感知采集状态变化，并进行相应操作，具体参看startScreenVideoCapture
3. 优化 RTC SDK for Android 混淆规则，避免了因混淆配置疏漏而导致的崩溃问题

1. 支持周期性回调混音伴奏播放进度，具体参看 setAudioMixingProgressInterval
2. 支持获取混音音频文件音轨索引，并指定当前音频文件的播放音轨，具体参看getAudioTrackCount, selectAudioTrack
3. 支持对混音伴奏或人声进行升降调调节，具体参看SetAudioMixingPitch, setLocalVoicePitch
4. 支持跨房间推拉流能力，具体参看跨房间转发媒体流

该版本于 2022 年 2 月 21 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 混音；
• 使用了 RTCVideoFrame 相关参数的接口；
• 媒体设备相关回调。

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 提升了视频帧格式转换的效率。

1. 移动端支持视频通话时将视频中人像与背景分离，实现如虚拟背景等功能（桌面端已在上个版本中支持）。具体参看：背景分割。
2. 在播放 PCM 音频数据时，支持调节音量。具体参看SetAudioMixingVolume。
3. 支持进行人声提示（VAD）和音频频谱检测。具体参看enableAudioPropertiesReport。

该版本于 2022 年 1 月 26 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 混音
• 视频特效
• 视频管理
• 美声特效管理
• 通话前网络检测

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 支持纯音频场景下，通过屏幕流进行信息同步。

1. 支持对音乐文件的声道进行设置，具体参看 API 文档：

同时新增部分支持播放的音频格式，目前各平台支持的音频格式如下：

2. 移动端支持摄像头变焦和开启闪光灯功能，具体参看 API 文档：

3. 支持音视频通话前进行网络质量检测，具体参看：通话前网络检测（Native）
4. 桌面端支持视频通话时将视频中人像与背景分离，实现如虚拟背景等功能，具体参看：背景分割
5. 新增美声和混响特效，支持改变通话音频声色和音效，具体参看 API 文档：

该版本于 2022 年 1 月 4 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 音频管理
• 视频管理

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 支持根据业务场景需要选择合适的音质档位，具体参看 API 文档：

2. 支持纯音频场景下，发送音频流同步信息，具体参看 API 文档：

3. 支持视频采集和编码参数分开设置，具体参看 API 文档：

1. 支持多房间模式下端云一体合流转推。
2. 移动设备音视频订阅端支持空间音频效果，具体功能实现参看空间音频。

该版本于 2021 年 12 月 20 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 音频管理
• 房间管理
• 视频管理

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 移动端（Android，iOS）支持使用耳返功能，并且可以设置耳返音量，满足互娱音频相关场景下，用户感知自身声音变化的需求，详情参看具体的 API 文档：

2. 支持本地采集画面在编码传输时做镜像处理，使远端用户与本地用户看到的本地画面一致，具体功能实现参看镜像。
3. 支持自定义视频编解码，具体功能实现参看自定义视频编解码。
4. 支持通话前音量检测。

1. iOS 端新增离开房间回调，用户调用 leaveRoom 并成功离开房间后，会收到 rtcEngine:onLeaveRoomWithStats: 回调。
2. 全平台增加进房参数校验，并统一进房相关错误提示。

该版本于 2021 年 12 月 6 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 音频处理
• 视频管理
• 音频事件回调

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

支持将 SDK 采集到的音频数据进行自定义加工（如美声、变声、音效、混响等处理等），并返回给 RTC 进行编码和发送，详情参看文档 自定义音频处理

该版本于 2021 年 11 月 26 日发布。

各个平台上的 API/回调/数据结构发生了变化。变化范围包括：

• 屏幕共享
• 视频管理
• 音频管理
• 引擎管理

如果你需要将应用中使用的旧版本 RTC SDK 升级为最新版，参看：升级指南。

1. 各平台新增全套多房间接口，同一用户可同时加入多个房间，新增接口详情参看：

2. 新增全套游戏语音接口，打造专门面向游戏方向的行业解决方案，接口设计更加贴近游戏业务使用，新增接口详情参看：

1. 支持推送自定义采集的屏幕共享音频流，参看具体的 API 文档：

2. 实现屏幕共享时麦克风采集音频流和屏幕音频流分两路发送，参看具体的 API 文档：

3. 支持多房间模式下端云一体合流转推

1. 解耦屏幕流的采集与发布，支持编码参数的动态变更
2. 补充用户反馈类型，解耦问题类型与问题描述，用户可对任何问题类型添加描述
3. 对 SEI 信息的发送/接收逻辑进行了整合，以 Android 为例：

4. 支持在 RTC 内部采集的前提下，对采集后的视频数据进行自定义加工（如美颜等），并返回给 RTC 进行渲染、编码和发送，参看自定义视频处理。