> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stmlink.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新日志

> iOS SRTC 音视频 SDK 版本更新记录

### \[2.5.9] - 2026.07.24

#### 新增

* 新增`enabledAudioModule:`接口，用于设置本端音频单元启停。

#### 优化

* 录像直播等本端不采集、不接收 RTC 音频的纯本地播放场景，可停用流媒体语音处理单元（VPIO），避免本地播放器音量被压低；
* 每次进房自动复位音频单元为自动管理，消除上一会话手动停用状态跨会话泄漏。

### \[2.5.8] - 2026.07.23

#### 修复

* 修复已连接蓝牙耳机进入音视频服务时，音频会话重配后可能停留在扬声器或听筒的问题。

#### 优化

* 未显式选择扬声器或听筒时，SDK 会主动恢复可用外设，并优先使用蓝牙耳机；
* 音频会话重配期间成功恢复外设时，不再向业务层上报临时的内置音频路由；
* 保留业务层对扬声器或听筒的显式选择，外设恢复失败时按默认内置路由回落。

### \[2.5.7] - 2026.07.23

#### 修复

* 修复请求的摄像头无法创建输入时，本地预览无画面的问题；
* 修复摄像头停止、重开或切换期间，旧异步采集任务可能干扰当前预览的问题。

#### 优化

* 增加摄像头输入可用性校验与自动回退，请求设备不可用时自动使用另一可用摄像头；
* 增加首帧超时检测，底层采集器初始化成功但未输出画面时自动尝试另一可用摄像头；
* 完善采集代次隔离和预览容器恢复，避免过期回调影响当前采集状态。

### \[2.5.6] - 2026.07.23

#### 修复

* 修复目标摄像头不可用并回退到实际设备后，摄像头方向状态和本地预览镜像不一致的问题；
* 修复后置摄像头本地预览可能被错误镜像的问题；
* 修复音频路由切换系统调用失败仍返回成功，以及无目标外设时错误回退的问题；
* 修复音频会话中断结束时过早清除恢复状态的问题。

#### 优化

* 分离默认内置路由、显式选择与系统实际路由，外设接入及多个外设之间的选择交由 iOS；
* 优化外设拔出、流媒体重连和音频单元重置后的路由恢复策略；
* 音频路由通知注册改为幂等，完善路由切换失败日志。

### \[2.5.5] - 2026.07.15

#### 变更

* 升级`librtc`依赖；
* 成员加入和离开频道回调不再过滤当前用户。

### \[2.5.4] - 2026.07.14

#### 修复

* 修复启用本地日志后宿主 App 的标准输出和标准错误被独占重定向，导致 Xcode 控制台日志不可见的问题。

#### 优化

* 本地日志采集改为全进程 Pipe Tee 模式，同时保留日志文件和原控制台输出；
* 优化日志采集的启停、失败回滚和资源释放流程，避免日志输出背压影响宿主 App。

### \[2.5.3] - 2026.07.13

#### 修复

* 升级`librtc`依赖，修复观众身份入会问题。

### \[2.5.2] - 2026.07.02

#### 修复

* 修复`WebRTC`采集本地预览镜像`setLocalPreviewMirror:`不生效的问题（镜像仅作用于本地预览，推流不镜像）。

### \[2.5.1] - 2026.07.02

#### 修复

* 修复`WebRTC`采集竖屏下画面横向的方向问题；
* 采集方向统一跟随界面方向，支持固定竖屏、固定横屏与自动旋转。

### \[2.5.0] - 2026.06.18

#### 新增

* 新增设置本地预览镜像接口`setLocalPreviewMirror:`；
* 新增获取当前摄像头方向接口`currentCameraDirection`；
* 新增摄像头方向枚举`RTCEngineCameraDirection`。

### \[2.4.7] - 2026.06.16

#### 新增

* 新增订阅远端转推音视频流接口`startRemoteRetweet:view:`（webrtc 取流，目前仅支持`wangsu`供应商）；
* 新增停止订阅远端转推音视频流接口`stopRemoteRetweet:`；
* 新增流媒体接收转推流状态变更回调`onReceiveRetweetStreamStatusChange:status:`。

### \[2.4.6] - 2026.04.30

#### 新增

* 升级重构支持`Seastart SFU 26.4`协议；
* 新增流媒体质量等级`RTCStreamQualityLevel`；
* 新增流媒体质量采样数据`RTCStreamQualitySampleModel`；
* 原`RTCEngineStreamTrackModel`数据结构新增`fallbackIds`和`variant`字段；
* 新增服务端上行质量检测回调`onSendQualitySample:`；
* 新增服务端下行质量检测回调`onReceiveQualitySample:`。

### \[2.4.5] - 2026.04.13

#### 修复

* 修复音频防抖计时器误操作释放，导致同时发送视频和音频时音频推流异常问题。

### \[2.4.4] - 2026.03.12

#### 新增

* 共享流连接新增`Audio Track`，共用麦克风采集的轨道；
* 新增发布视图录制的共享流接口`publishScreenViewCaptureWithPixelBuffer:displayAngle:`；
* 新增设置视图采集共享接口`enabledViewCaptureShare:`。

### \[2.4.3] - 2026.02.28

#### 新增

* 流媒体配置新增`forceLandscape`参数，用来业务层强制横屏设置；
* 使用非自研流媒体供应商时的视频采集重构为`AVCaptureSession`定义实现等；
* 采集成功后的操作调整到主线程。

### \[2.4.2] - 2025.12.15

#### 修复

* 已知问题修复以及相关优化。

### \[2.4.1] - 2025.11.28

#### 修复

* 修复部分已知问题以及相关优化。

### \[2.4.0] - 2025.11.17

#### 新增

* 自定义消息回调新增会话标识和用户昵称参数。

### \[2.3.1] - 2025.10.23

#### 优化

* 日志上报数据结构变更；

#### 新增

* 新增本地音频采集和重采样数据回调；

#### 修复

* 修复黑窗口日志引起的崩溃；
* `iPad`设备共享屏幕适配；
* 若干已知问题修复。

### \[2.3.0] - 2025.08.30

#### 新增

* 增加自研`sfu`流媒体模块。

### \[2.2.11] - 2025.08.22

#### 优化

* 接口失败重试逻辑的相关优化。

### \[2.2.10] - 2025.08.20

#### 修复

* 新增自定义视频采集会话，修复采集会话不支持相机的动态格式的异常问题。

### \[2.2.9] - 2025.08.16

#### 修复

* 修复流媒体未启动就离开时的回调异常问题。

### \[2.2.8] - 2025.08.15

#### 修复

* 重连逻辑优化，修复取流异常问题。

### \[2.2.7] - 2025.08.13

#### 修复

* 优化`cStr`转换异常崩溃问题；
* 新流媒体重连问题优化；
* 音频路由重置优化等。

### \[2.2.6] - 2025.08.12

#### 新增

* 新增网宿流媒体模块封装。

### \[2.2.5] - 2025.06.24

#### 优化

* 新增最大成员数设置以及`libwebrtc`依赖，自研流媒体模块初步封装。

### \[2.2.4] - 2025.05.07

#### 优化

* 控制台日志重定向优化。

### \[2.2.3] - 2025.04.23

#### 修复

* 修复摄像头开关导致媒体采集参数失效的问题。

### \[2.2.2] - 2025.03.31

#### 优化

* 优化新增成员加入顺序问题；
* 采集实时日志回调的逻辑处理新增优化，规避可能引起异常崩溃的异常；
* 升级日志版本以及修复日志引起的异常崩溃。

### \[2.2.2-alpha.5+20250318] - 2025.03.18

#### 修复

* 升级`librtc`依赖，修复日志引起的异常崩溃。

### \[2.2.2-alpha.4+20250313] - 2025.03.13

#### 优化

* 优化修复部分异常崩溃等。

### \[2.2.2-alpha.3+20250226] - 2025.02.26

#### 优化

* 升级`librtc`依赖的`mmkv`版本以及部分已知问题修复。

### \[2.2.2-alpha.2+20250218] - 2025.02.18

#### 优化

* 采集实时日志回调的逻辑处理新增优化，规避可能引起异常崩溃的异常。

### \[2.2.2-alpha.1+20250123] - 2025.01.23

#### 优化

* 升级底层库，优化成员加入顺序问题。

### \[2.2.1] - 2025.01.17

#### 修复

* 修复有线耳机识别名称异常的问题。

#### 优化

* 视频角度更新问题优化。

### \[2.2.0] - 2025.01.10

#### 新增

* 新增即时通讯等功能；

#### 优化

* 订阅等实现流程优化；

#### 修复

* 修复已知问题。

### \[2.2.0-alpha.13+20250102] - 2025.01.02

#### 优化

* 流媒体发布视频数据流新增推流状态判断。

### \[2.2.0-alpha.12+20250102] - 2025.01.02

#### 优化

* 优化开启本地摄像头流程，先开启本地采集，再`ChangeStreams`，最后`enabledPublish`。

### \[2.2.0-alpha.11+20241230] - 2024.12.30

#### 优化

* 优化订阅远端视频流逻辑；

#### 修复

* 升级底层库，优化修复异常崩溃问题。

### \[2.2.0-alpha.10+20241226] - 2024.12.26

#### 优化

* 优化修复部分异常崩溃问题。

### \[2.2.0-alpha.9+20241223] - 2024.12.23

#### 新增

* 新增加入频道事件优化，保证只有一次回调。

### \[2.2.0-alpha.8+20241221] - 2024.12.21

#### 新增

* 新增音频会话中断重启等逻辑；
* 新增重启音频会话接口；
* 接口`enableImWithToken`和`joinChannelWithToken`新增超时检测逻辑；
* 新增部分错误码；

#### 优化

* 音频编码格式修改默认为`OPUS`；

#### 修复

* 新增`libcurl`库的`c-areas`依赖，修复部分相关异常问题。

### \[2.2.0-alpha.7+20241106] - 2024.11.06

#### 优化

* 流媒体接收状态回调处理适配混合流变更。

### \[2.2.0-alpha.6+20241106] - 2024.11.06

#### 新增

* 音频状态处理新增混合流逻辑。

### \[2.2.0-alpha.5+20241105] - 2024.11.05

#### 新增

* 日志组件获取下行数据状态以及远端音频状态时，新增混合流的过滤。

### \[2.2.0-alpha.4+20241101] - 2024.11.01

#### 变更

* 调整`streamUpdate`事件顺序，保证不会出现状态异常问题；
* `setStreamTracks`接口逻辑处理保障在成功之后处理。

### \[2.2.0-alpha.3+20241030] - 2024.10.30

#### 优化

* 优化音视频状态变更逻辑。

### \[2.2.0-alpha.2+20241026] - 2024.10.26

#### 新增

* 处理码流数据变更事件，如果是视频移除事件新增停止订阅远端用户的视频流操作以及额外增加用户数据更新回调；
* 本地变更码流变化新增我的数据更新回调；
* 开启音视频等相关操作新增错误码实现。

### \[2.2.0-alpha.1+20241024] - 2024.10.24

#### 变更

* 码流数据变更事件移除对当前用户的过滤。

### \[2.1.2] - 2024.10.23

#### 新增

* 日志系统上报远端视频数据列表新增过滤合成流数据。

### \[2.1.1] - 2024.10.22

#### 新增

* 新增订阅与停止订阅远端合成画面视频流接口，即：`startRemoteMixture:`以及`stopRemoteMixture`。

### \[2.1.0] - 2024.10.09

#### 优化

* 升级底层库，适配MQTT SSL连接，移除配置参数`RTCEngineConfig`中原有线路与分组字段。

### \[2.0.0] - 2024.09.14

#### 优化

* 底层优化重构。

### \[1.0.8-alpha.19+20240913] - 2024.09.13

#### 新增

* 新增即时通讯相关功能以及相关回调，详情请参看 [即时通讯](https://www.yuque.com/anyconf/rtcengine/rkyba0lbuq9f4re8)。

### \[1.0.8-alpha.17+20240906] - 2024.09.06

#### 优化

* 用户退出时，停止订阅该用户的所有远端流，规避上层通过`userId`停止订阅时，由于底层数据清除导致的无法释放远端画布资源的异常。

### \[1.0.8-alpha.16+20240903] - 2024.09.03

#### 变更

* 流媒体接收状态数据回调参数变更为列表；

#### 优化

* 流媒体上行与下行数据回调优化。

### \[1.0.8-alpha.15+20240828] - 2024.08.28

#### 新增

* 流媒体接收远端流状态变更回调新增轨道标识。

### \[1.0.8-alpha.14+20240828] - 2024.08.28

#### 新增

* 新增`onReceiveStreamStatusChange:status:()`回调，表示：流媒体接收远端流状态变更。

### \[1.0.8-alpha.13+20240819] - 2024.08.19

#### 修正

* 升级`**librtc**`依赖，修复离开频道时更新码流数据引起的崩溃以及网络超时时间引起的异常崩溃问题；

#### 变更

* 变更重连成功回调参数。

### \[1.0.8-alpha.12+20240813] - 2024.08.13

#### 修正

* 移除捆绑中二进制文件，解决构建验证异常问题。

### \[1.0.8-alpha.11+20240813] - 2024.08.13

#### 优化

* 流媒体内部重连逻辑优化，新增扬声器状态重置以及音视频发送状态优化等；

#### 修正

* 若干已知问题修复。

### \[1.0.8-alpha.10+20240810] - 2024.08.10

#### 修正

* 优化底层逻辑，修复部分已知问题。

### \[1.0.8-alpha.9+20240723] - 2024.07.23

#### 修正

* 移除`bundle`包中可执行文件，修复打包提交`Asset validation failed`的异常问题。

### \[1.0.8-alpha.8+20240719] - 2024.07.19

#### 修正

* 调整回调与消息监听顺序，保证回调时消息已监听成功.

### \[1.0.8-alpha.7+20240719] - 2024.07.19

#### 新增

* 流媒体连接成功与重连成功新增恢复音视频发送状态设置。

### \[1.0.8-alpha.6+20240718] - 2024.07.18

#### 新增

* 新增`getDrawingHost`获取画板地址接口；

#### 变更

* 移除`onChannelDestroy:()`回调。

### \[1.0.8-alpha.5+20240716] - 2024.07.16

#### 新增

* 流媒体连接成功新增`resetRemoteStream`处理，优化流媒体连接成功顺序滞后导致的订阅远程流异常。

### \[1.0.8-alpha.4+20240712] - 2024.07.12

#### 修正

* 调整入会成功回调顺序，修复异常的取流问题。

### \[1.0.8-alpha.3+20240705] - 2024.07.05

#### 修正

* 修复重定向日志后，无法恢复标准输出到控制台问题。

### \[1.0.8-alpha.2+20240704] - 2024.07.04

#### 新增

* 流媒体配置参数新增默认音频路由；
* 新增自己数据更新回调；
* 新增重连成功回调；

#### 变更

* 离开原因枚举变更为`RTCLeaveReason`；

#### 优化

* 连接断开与自己被动离开合并回调。

### \[1.0.8-alpha.1+20240629] - 2024.06.29

#### 重构

* 升级重构`RTC`底层，详情请参考[快速集成](https://www.yuque.com/anyconf/rtcengine/am4ult)。

### \[1.0.7] - 2024.04.22

#### 修正

* 修复数据长度导致的解密失败问题。

### \[1.0.6] - 2024.04.19

#### 新增

* 新增解密接口`decrypt:`，用于外部解析鉴权令牌；

#### 优化

* 同步弱网策略、内部实现逻辑以及开发包瘦身等优化。

### \[1.0.5] - 2024.03.26

#### 新增

* 新增美颜、流媒体日志重定向等组件以及流媒体状态等级完善。

### \[1.0.4] - 2022.08.30

#### 优化

* 内部逻辑优化。

### \[1.0.3] - 2022.08.24

#### 新增

* 新增发布自定义码流功能以及相关接口，详情请参考[发布自定义流相关接口](https://www.yuque.com/anyconf/rtcengine/hxo2k0#m8xNY)。

### \[1.0.2] - 2022.08.08

#### 新增

* 新增视频美颜功能以及相关接口，详情请参考[美颜功能](https://www.yuque.com/anyconf/rtcengine/bzstxg)；

#### 变更

* 优化调整错误码规范，详情请参见[错误码表](https://www.yuque.com/anyconf/rtcengine/hf08uk)。

### \[1.0.1] - 2022.08.02

#### 新增

* 新增流媒体等相关接口；

#### 优化

* 重新设计内部实现；
* 优化原有接口调用逻辑。

### \[1.0.0] - 2022.03.18

#### 新增

* 新增终端类型`RTCTerminalType`；
* 新增码流事件名称`RTCEngineKitEventNameStreamsEvent`；
* 初始化配置参数`RTCEngineConfig`新增终端类型`terminalType`和终端描述`terminateDesc`属性；
* 新增变更码流信息`changeWithStreams:changeType:`；
* 新增类方法初始化RTC服务此方法外部可以持有和管理`RTCEngine`对象；
* 初始化RTC服务新增`userModel`参数；
* 新增只读属性`engineConfig`和`userModel`；

#### 变更

* 原变更用户信息移除变更操作类型`changeType`参数；
* 原初始化RTC服务方法`initializeWithConfig`新增`delegate`参数；
* 原用户信息`RTCEngineUserModel`中`sdkno`属性变更为`linkid`，`sessionId`属性变更为`sessionKey`；
* 房间信息`RTCEngineRoomMode` 对象中 ID 属性变更为`NSString`类型；
* `RTCEngineConfig`对象移除`userModel`属性；
* 原`sendMessageWithUserList:message:`方法变更为`sendMessageWithUserIds:message:`;

#### 优化

* 内部逻辑优化。