更新日志

本页根据 rtc-android 仓库的版本配置和提交记录整理。可通过 RTCEngine.version() 获取运行中的实际 SDK 版本。

​

[2.0.38] - 2026.10.27

​

变更

• 错误码统一为 RtcErrorCode，按跨端统一规则调整编号与含义；升级时需同步错误码引用与提示映射，见 错误码。
• SDK 自产错误仅返回错误码和空提示，后端错误码与提示原样透传。

​

修复

• 修复网络超时与响应解析失败的错误分类不准确的问题。
• 修复网宿发布失败时后端错误提示丢失的问题。

​

[2.0.37] - 2026.10.15

​

新增

• 新增 onLocalQualitySnapshot，按频道提供本地上下行网络质量及逐轨音视频播放体验，见 网络质量。

​

变更

• 移除 onMediaMetric；详细媒体统计改为通过 RTCEngine.getMetric() 或 RTCChannel.getMetric() 按需查询。
• getMetric() 返回顶层 MediaMetric?；质量监测模型迁移至 cn.seastart.rtc.monitoring.api，旧包名和嵌套类型需按 媒体质量 迁移。

​

[2.0.36] - 2026.10.09

​

新增

• 新增 RTCEngine.setLanguage(...)，可设置后端请求语言，见 RTCEngine。

​

变更

• RTCEngine.join(...) 不再需要传入 Activity，见 RTCEngine。
• 入会和异步操作的失败回调新增 message 参数，可返回后端错误文案，见 RTCClientEvent 和 RTCEngine。
• 自 2.0.36 起调整 StatusCode 的错误码数值，新旧对照见 错误码。

​

[2.0.35] - 2026.09.24

​

修复

• 修复部分视频画面旋转、镜像及显示比例异常的问题。
• 修复断线重连返回配置不完整时，原频道配置未正确沿用的问题。

​

变更

• 移除 OOK（网仕）流媒体引擎，当前支持 FY（风远）和网宿；使用 OOK 的应用需完成迁移后再升级。
• 视频渲染由 OOK 提供的控件调整为 SDK 自带控件，统一处理画面旋转、镜像和缩放，保留自定义显示控制能力。升级时需将代码和 XML 中的控件包路径由 com.ook.android.ikPlayer 调整为 cn.seastart.rtc.media.original.render，轨道的 addPlayView 等绑定接口保持不变，当前用法见 视频渲染。
• 移除 RTCEngine.getCustomVideoTrack()、CustomVideoTrack 和 CustomVideoOptions；自定义推流使用 LocalCustomVideoTrack 输入未编码 I420 帧，不可直接传入 H264/H265 数据，见 自定义推流。
• 移除 OOK 专用的 RTCEngine.mediaOptions()、setMediaOptions(...) 和 RTCMediaOptions，采集与发布使用各轨道对应的配置。
• 移除 NetworkStats.upLevel、downLossLevel、RemoteDownloadStats.downLevel 及对应的三个质量等级枚举，当前字段见 媒体质量。
• 屏幕原始帧格式改用 YuvFormat.I420 常量，数值保持不变，见 类型定义。

​

[2.0.34] - 2026.09.21

​

修复

• 修复开启虚拟背景虚化后背景显示为黑色的问题。

​

[2.0.33] - 2026.09.18

​

变更

• 将 fix/bugfix 分支合并入 master 分支。

​

[2.0.32-bugfix.2] - 2026.09.18

​

新增

• LocalCameraTrack 新增 getCurrentCameraId，用于查询实际生效的摄像头设备，接口见 LocalCameraTrack。
• 新增摄像头错误码 CAMERA_FORMAT_UNAVAILABLE、CAMERA_OPEN_TIMEOUT 和 CAMERA_SESSION_TIMEOUT，说明见 错误码。

​

修复

• 修复摄像头打开或配置阶段无响应时，本次操作一直不返回结果的问题。
• 修复摄像头会话已就绪即上报成功，但画面仍然全黑的问题。
• 修复切换摄像头成功后，配置中的摄像头设备信息未同步更新的问题。
• 修复连续快速切换摄像头时偶发采集异常或黑屏的问题。

​

变更

• 启动采集时配置的摄像头设备与方向改为建议值，不可用时自动改选其他设备；按方向切换只在该方向内尝试，按设备 ID 切换只尝试指定设备。
• 切换摄像头失败后不再自动回退到原摄像头，需由应用自行调用 startCapture 恢复画面，说明见 LocalCameraTrack。
• 切换摄像头请求被后一次请求取代或被停止采集取消时不再回调结果，错误码 CAMERA_SWITCH_SUPERSEDED 已删除。
• 获取摄像头轨道时会复制一份采集配置，取到轨道后再修改原预设的 capture 不再生效，修改 publish 仍然生效。
• 摄像头预设的 deviceId 默认值由 cameraCapMain 改为空串，表示不指定设备。具体数值见 摄像头预设。

​

[2.0.32-bugfix.1] - 2026.09.16

​

新增

• LocalCameraTrack 的 switchCameraPosition 和 switchCameraDevice 新增切换结果回调，接口见 LocalCameraTrack。
• 新增摄像头错误码 CAMERA_SWITCH_SUPERSEDED 和 CAMERA_FIRST_FRAME_TIMEOUT，说明见 错误码。

​

修复

• 修复切换摄像头失败后画面停在最后一帧、且切换功能不再响应的问题。
• 修复切换摄像头失败后重新开启摄像头持续黑屏的问题。
• 修复切换摄像头失败时可能静默切到非目标摄像头的问题。
• 修复部分设备本地预览画面旋转角度错误、对端画面正常的问题。
• 修复开麦或开摄像头协商失败后，同一次通话内反复开启持续失败、只能退会重进的问题。
• 修复接入方开启 R8 full mode 后网络请求初始化失败的问题。

​

变更

• 摄像头启动改为以首帧到达为准，选中的摄像头起不来时自动尝试下一个可用设备，全部不可用时回调 CAMERA_FIRST_FRAME_TIMEOUT。

​

[2.0.32] - 2026.09.12

​

新增

• 新增虚拟背景，支持背景虚化和背景图替换，接口见 RTCEngine。
• VideoPublishOptions 新增 minBitrate，支持配置单路视频最小码率。

​

修复

• 修复入会即开麦时对端听不到人声的问题。
• 修复订阅协商应答超时后开麦失败的问题。
• 修复弱网环境下网络请求异常的问题。
• 修复部分 SFU 视频轨道未应用保持分辨率策略的问题。

​

优化

• 减少音频路由的重复下发。

​

变更

• 调整摄像头预设参数：采集与大流推送帧率统一为 15，部分档位最大码率上调，各档位补充默认最小码率。具体数值见 摄像头预设。
• 更新随 AAR 下发的混淆规则，保留 JNI Zero 与 WebRTC 相关类。

​

[2.0.31] - 2026.08.31

​

变更

• 将 audio-optimization 分支合并入 master 分支。

​

[2.0.30] - 2026.08.29

​

修复

• 修复本端被移出频道或发生不可恢复断开后，频道 Session 未及时摘除和媒体资源未完整释放，导致同频道重新加入可能被误判为重复入会的问题。

​

变更

• 重构部分内部目录并优化 AAR 混淆规则，明确 Track 与公开枚举的保留边界；仅供 SDK 内部使用的 RemoteStreamStatus 移入 enumerateLocal，未使用的 AudioOutputOptions 已删除。

​

[2.0.29] - 2026.08.26

​

变更

• 将 screenCapture 分支合并入 master 分支。

​

[2.0.28_audioOptimization.2] - 2026.08.26

​

优化

• FY 和 WS 流媒体引擎的外部麦克风上行新增 AEC、NS 硬件优先、软件兜底策略：两项能力独立探测和验证，平台效果未真正启用时自动回退到 WebRTC 软件处理，避免重复处理或处理缺失。

​

变更

• RTCLocalAudioFrameEvent 的 PCM 数据阶段随本版本的 AEC/NS 策略调整：平台 AEC/NS 已启用时包含对应平台处理；回退到 WebRTC 软件处理的项目，返回的是软件 APM 处理前数据。

​

[2.0.28_audioOptimization.1] - 2026.08.26

​

修复

• 优化 FY 和 WS 流媒体引擎的外部麦克风推送到 WebRTC ADM 的桥接节拍，修复部分设备上行音频出现卡顿、断流、气泡音或类似丢帧听感的问题。

​

变更

• RTCLocalAudioFrameEvent 改为跟随 Engine 级物理麦克风采集，在 SDK 音频分发线程串行回调，不再依赖某个频道是否发布音频；应用回调耗时不会阻塞上行，旁路队列满载时会丢弃较旧的应用回调帧。

​

[2.0.27_screenCapture.1] - 2026.08.25

​

新增

• FY 和 WS 流媒体引擎新增 Android 原生屏幕采集能力，支持应用退至后台后继续共享，并支持将同一次屏幕采集发布到多个频道；
• 新增 Engine 级本地屏幕 I420 帧回调，仅在应用注册监听器后复制并回调帧数据。

​

变更

• LocalScreenTrack.startCapture 统一为带操作结果回调的启动入口；结果回调表示 SDK 是否接纳启动操作，后续采集状态通过 RTCScreenStateEvent.onScreenCaptureStateChanged 通知；
• 屏幕采集状态类型调整为 ScreenCaptureState，包含 START、STOP 和 ERROR 三种状态；
• FY 和 WS 屏幕采集不再依赖 WebRTC ScreenCapturerAndroid，OOK 屏幕采集链路保持不变。

​

修复

• 修复共享静态页面时首帧可能长时间不显示的问题；
• 完善系统停止共享、应用主动停止、屏幕旋转、锁屏以及单应用内容隐藏等场景下的状态通知和资源释放。

​

[2.0.28] - 2026.08.22

​

修复

• 修复 OOK 媒体客户端释放线程与初始化线程不一致可能导致的不稳定问题。

​

变更

• 更新 librtc.so，适配服务端移除 OOK 流媒体配置。

​

[2.0.27] - 2026.08.19

​

变更

• 将 disconnect-reconnect 分支合并至 master，正式版整合 2.0.26_disconnectReconnect.1 的断网重连相关变更。

​

[2.0.26_disconnectReconnect.1] - 2026.08.18

​

修复

• 修复多频道场景反复断网重连时 WebRTC 资源释放不完整，可能导致应用崩溃的问题。

​

优化

• 流媒体断线重连改为 1、2、4、8、16 秒递增等待，之后每 16 秒继续重试；网络恢复后仍会自动重连，降低多频道断网期间的请求压力。

​

[2.0.26] - 2026.08.12

​

新增

• 支持一个 RTCEngine 同时加入多个频道；join(...) 返回独立的 RTCChannel 句柄，默认频道继续兼容 Engine 扁平接口；
• 麦克风采集与入会、发布解耦，LocalMicTrack 新增显式 startCapture / stopCapture、输入设备枚举与切换能力；
• 新增 Engine 全局错误、摄像头设备、麦克风设备和本地 PCM 帧监听器；
• 新增按公共、频道、摄像头、麦克风、流媒体和 HTTP 分域的 102xxx SDK 错误码及 RtcErrorCatalog 查询能力。

​

变更

• RTCEngine.create(...) 新增必填 RTCEngineEvent；
• RTCEngine.join(...) 改为接收本频道 RTCClientEvent 并返回 RTCChannel?，入会结果由 onJoinSucceed / onJoinFailed 通知；
• RTCClientEvent 的自定义消息、断开和重连回调新增 channel 参数，原 onError(...) 移至 RTCEngineEvent；
• RTCMediaEvent 的所有回调新增 channel 参数，摄像头设备事件迁移到 RTCCameraDeviceEvent；
• RTCRemoteVideoEvent.onReceiveStreamStatusChange(...) 新增 channel 参数；
• RTCResultListener2<T> 更名为 RTCValueResultListener<T>，StatusCode 与 Android SDK 自产错误码职责分离。

​

修复

• 修复多频道场景关闭摄像头后本地采集未停止的问题；
• 修复断线重连后本地音频静音状态丢失，以及同一轨道重复发布时回调过早失败或丢失的问题。

​

[2.0.24_multiChannel.3] - 2026.08.11

​

修复

• 修复断线重连后本地音频静音状态丢失的问题，新建音频轨道会继续遵循重连前的启停状态；
• 修复同一轨道重复发布时后续请求回调过早失败或丢失的问题，合并请求会在真实发布完成后统一返回结果。

​

[2.0.25] - 2026.08.11

​

修复

• 修复 FY 流媒体引擎在断线重连期间并发访问已释放媒体客户端或 RtpSender 可能导致的崩溃，并隔离旧会话回调、合并重复重连请求；
• 修复媒体回调实现暴露内部会话类型导致的 Kotlin 编译错误。

​

[2.0.24_multiChannel.2] - 2026.08.10

​

新增

• 支持一个 RTCEngine 同时加入多个频道；join(...) 返回独立的 RTCChannel 句柄，默认频道继续兼容 Engine 扁平接口；
• 麦克风采集与入会、发布解耦，LocalMicTrack 新增显式 startCapture / stopCapture、输入设备枚举与切换能力；
• 新增 Engine 全局错误、摄像头设备、麦克风设备和本地 PCM 帧监听器；
• 新增按公共、频道、摄像头、麦克风、流媒体和 HTTP 分域的 102xxx SDK 错误码及 RtcErrorCatalog 查询能力。

​

变更

• RTCEngine.create(...) 新增必填 RTCEngineEvent；
• RTCEngine.join(...) 改为接收本频道 RTCClientEvent 并返回 RTCChannel?，入会结果由 onJoinSucceed / onJoinFailed 通知；
• RTCClientEvent 的自定义消息、断开和重连回调新增 channel 参数，原 onError(...) 移至 RTCEngineEvent；
• RTCMediaEvent 的所有回调新增 channel 参数，摄像头设备事件迁移到 RTCCameraDeviceEvent；
• RTCRemoteVideoEvent.onReceiveStreamStatusChange(...) 新增 channel 参数；
• RTCResultListener2<T> 更名为 RTCValueResultListener<T>，StatusCode 与 Android SDK 自产错误码职责分离。

​

[2.0.23] - 2026.07.27

​

优化

• 引入远端音频订阅声明式对账器 SubscribeReconciler，将同一轨道的订阅和退订操作串行化，避免高频会控事件导致状态不一致；
• 流媒体重连后按最终订阅意图自动恢复远端音频订阅，并为订阅失败提供最多 3 次的有界退避重试；
• 用户离开频道或频道释放时自动清理订阅对账状态。

​

[2.0.22] - 2026.07.23

​

新增

• 新增远端视频帧全量落盘能力，便于问题排查；

​

优化

• 新增 armeabi-v7a ABI 支持并优化构建配置。

​

[2.0.21] - 2026.07.22

​

优化

• 简化网络质量变化回调：每条质量报告均触发回调，并新增 STABLE 趋势状态；
• 为信令数据通道消息补充序列化字段注解，避免混淆后解析失败。

​

[2.0.19] - 2026.07.22

​

新增

• 新增本地音频临时静音接口 enableLocalAudio。

​

[2.0.18] - 2026.07.22

​

修复

• 修正 Camera2 帧旋转角度计算，使其与 WebRTC 语义一致；
• 默认启用前置摄像头镜像，改善设备旋转时的本地预览体验。

​

[2.0.17] - 2026.07.20

​

新增

• 新增网络质量跨档变化回调。

​

[2.0.16] - 2026.07.15

​

新增

• 支持频道内用户身份变更，以及观众升降级处理。

​

[2.0.15] - 2026.07.04

​

修复

• 优化资源释放流程，修复并发场景下可能发生的崩溃。

​

[2.0.14] - 2026.07.03

​

优化

• 优化音频能量回调，兼容特定音频轨道 ID。

​

[2.0.13] - 2026.07.03

​

修复

• 修复 WebRTC m-line 复用导致订阅端 track.id 冻结、流识别错误的问题；
• 修复远端视频 View 复用时画面旋转角度异常的问题。

​

优化

• 重构摄像头采集与推流状态机，支持音频推流的声明式对账；
• 优化 YUV 帧处理和展讯（sprd）编码器兼容性。

​

[2.0.11] - 2026.06.17

​

新增

• LocalCameraTrack 新增前置摄像头镜像控制能力。

​

[2.0.10] - 2026.06.15

​

新增

• 支持网宿通用流订阅。

​

[2.0.9] - 2026.05.20

​

新增

• 适配 SRTC SFU 26.4：支持服务端媒体质量数据、活跃说话人、订阅候选层及画质自动降级字段；
• 新增摄像头能力与设备列表查询、按 cameraId 选择摄像头、摄像头角度偏移和热插拔事件；
• 摄像头采集切换为原生 Camera2 实现，并优化帧转换性能与内存使用。

​

[2.0.8] - 2026.05.09

​

新增

• 重构网宿流媒体引擎，支持发布附加流。

​

[2.0.7] - 2026.04.21

​

优化

• 优化 OOK 流媒体引擎的大流、小流分辨率、帧率和码率配置。

​

[2.0.6-alpha.9] - 2026.03.09

​

新增

• 支持 FyStreamEngine 和 WsStreamEngine 的自定义视频流输入与发布；
• 支持自定义流和屏幕共享流使用 1080p、10 fps 参数；
• Android 14 及以上前台服务增加麦克风类型权限支持。

​

变更

• RTCClientEvent.onChannelNotStarted 更名为 onError；
• LocalCustomVideoTrack.inputData 改为接收基础帧数据，由 SDK 负责组装。

​

[2.0.6-alpha.8] - 2025.11.19

​

修复

• 修复 SFU 连接断开后无法重连、订阅时 ignore 处理异常等问题；
• 升级 VCS SDK，移除底层 MQTT 自身重连机制以规避崩溃。

​

[2.0.6-alpha.7] - 2025.11.14

​

新增

• 自定义消息回调新增 sid 和 nickName 字段。

​

修复

• 修复部分 HarmonyOS 3.0 及以下设备发送视频时出现绿条的问题。

​

[2.0.6-alpha.5] - 2025.10.24

​

修复

• 修复流媒体重连时 OptionInfo 信息缺失、远端设备断开后无法重新连接等问题。

​

[2.0.6-alpha.2] - 2025.10.13

​

变更

• 订阅远端流以 trackId 作为主要标识，新增 getUserTrackInfoByTrackId；
• 远端成员离开时由 SDK 自动取消订阅，无需应用层额外处理。

​

修复

• 修复 WebRTC 发布时 SDP 持续膨胀、远端音频订阅失败及流操作时序异常的问题。

​

[2.0.6-alpha.1] - 2025.09.26

​

新增

• 新增音频能量、媒体质量和扬声器控制回调；
• 支持自定义编码参数和会议外预览的摄像头、屏幕共享能力。

​

修复

• 修复订阅响应 SDP 或 offer 为空时的异常；
• 优化 YUV 帧转换，兼容 stride。

​

[2.0.5] - 2025.09.09

​

修复

• 修复屏幕录制服务找不到、停止共享回调缺失和混淆配置问题。

​

[2.0.4] - 2025.09.04

​

新增

• 统一 OOK 与网宿媒体统计数据回调，补充丢包率计算和音量柱能力。

​

[2.0.2-alpha.2] - 2025.08.18

​

新增

• PublishCustomOptions 支持控制是否发布小流。

​

修复

• 升级 WebRTC SDK，缓解 HarmonyOS 设备编码器异常导致的卡顿；
• 修复断网重连后已发布、已订阅轨道无法恢复及横竖屏画面角度异常的问题。

​

[2.0.1] - 2025.05.23

​

变更

• 重构 RTC SDK 层，解耦流媒体能力并支持切换流媒体引擎；
• 引入 WebRTC 与 SFU 流媒体框架，支持摄像头采集、发布、订阅和资源释放。

​

[2.0.0-34] - 2025.04.27

​

新增

• 支持保存 H.264 文件，音视频文件统一存储至 audioVideo 目录。

​

[2.0.0-33] - 2025.04.23

​

新增

• 新增 1080P、720P、480P、180P 内置摄像头预设。

​

[2.0.0-32] - 2025.03.25

​

新增

• onJoinSucceed 回调新增 SDK 版本号参数。

​

修复

• 更新底层库并修复文件存储位置、日志模块重新初始化等问题。

​

[2.0.0-31] - 2025.01.24

​

新增

• 新增语音转写功能开关。

​

修复

• 修复屏幕共享断网重连崩溃、取消订阅状态错误和 IM 连接异常等问题。

​

[2.0.0-30] - 2024.12.22

​

变更

• 用户离开频道回调直接提供 UserInfo。

​

[2.0.0-29] - 2024.10.24

​

变更

• 轨道新增、更新、移除事件不再过滤当前用户。

​

[2.0.0-28] - 2024.10.17

​

优化

• 成员被订阅尚未发布的流时，补充明确日志提示。

​

[2.0.0-27] - 2024.10.11

​

新增

• 新增即时通讯能力；

​

变更

• 底层库适配 MQTT SSL 连接，移除 RTCClientOptions 中的 netid 和 sgid 配置。

​

[2.0.0-26] - 2024.09.20

​

优化

• 优化即时通讯断连原因及简单事件回调。

​

[2.0.0-25] - 2024.09.20

​

新增

• 增加即时通讯基础能力与应用层测试用例。