[2.2.1] - 2026.10.08
变更
language同时设置 RTC 层：设置MeetingKit.language时会同时设置RTCEngineKit.language，会议层与 RTC 层请求后端使用同一Accept-Language。2.2.0 中「RTC 层请求暂不带语言」的限制已解除。- RTC 层透传的后端业务码带上服务端文案：RTC 层返回
1000–99999的后端业务码时，错误描述改用服务端返回的文案（语言随language），此前为通用的Server rejected the request。 - 依赖
RTCEngineKit升级至3.2.1，podspec 最低依赖由>= 3.2.0提升为>= 3.2.1。
公开接口无删改，2.2.0 接入方无需改代码。若工程显式锁定了
RTCEngineKit 3.2.0，MeetingKit 仍可运行，只是 RTC 层请求不带语言；建议一并升级到 3.2.1。[2.2.0] - 2026.10.08
升级必读
- 会议层错误改用 203 段：会议层自身产生的错误改为 iOS 前缀
203+ 统一码表低 3 位（203001–203012、203209、203353–203356），与 Swift SDK 同号同义，各码含义见错误码与错误码规则与总表。 - 会议层网络失败不再返回
SEAErrorNetError（100009）：请求失败 / HTTP 非 200 改为SEAErrorMeetingNetworkError（203007），超时203353，取消203354，响应体为空203355，响应不是 JSON 或缺code字段203356。SEAErrorNetError这个常量的值也变成了103006，只表示 RTC 层网络错误。 - 后端业务失败透传后端业务码：此前接口被后端拒绝时统一回调
100009，现在原样回调后端的业务码（如2101会议不存在、2115密码错误），message为后端返回的msg，语言随language。 - 会议令牌解析失败：
loginWithToken:...传入的令牌解不开时，由SEAErrorApiTokenDisabled（10042）改为SEAErrorMeetingTokenInvalid（203005）。 - 重复进房 / 实例已销毁：
enterRoom:onSuccess:onFailed:在正在加入或已加入时调用，由SEAErrorApiRepeatFound（10003）改为SEAErrorMeetingAlreadyInMeeting（203006）；房间实例已销毁时改为SEAErrorMeetingInvalidState（203011）。 - 仅主持人 / 联席主持人可调用的接口：非管理员调用时由
SEAErrorNotAuthorized（103005）改为SEAErrorMeetingUnauthorized（203004）。 - 设备权限：
SEAErrorDeviceNoAuthorized不再出现，无摄像头权限改为SEAErrorCameraNoAuthorized（103231），无麦克风权限改为SEAErrorMicNoAuthorized（103251）。 - RTC 层透传码重排：透传的 RTC 层错误码（原
100001–100012、103001–103005）随RTCEngineKit 3.2.0改为103+ 统一码表低 3 位，与RTCEngineError同值，枚举名不变、取值改变，需重新编译。注意旧的数值在新表里被挪作他用（如103005现在是SEAErrorConflict、103001现在是SEAErrorNotJoinedChannel），用数字字面量写死的判断语义会整体错位。onError、onImDisconnected的errCode同样受影响。 startRemoteView:streamType:view:/stopRemoteView:streamType:：成员在会议中但没有要订阅的这路视频时，返回值由 RTC 层的RTCEngineErrorStreamNotFound（103004）改为SEAErrorMeetingRemoteTrackUnavailable（203209）。- 虚拟背景返回值：
installVirtualBackground:重复装载由SEAErrorConflict改为SEAErrorVirtualBackgroundAlreadyInstalled（103027），模型文件不存在由SEAErrorNotFound改为SEAErrorVirtualBackgroundModelNotFound（103029），推理会话创建失败由SEAErrorSystemError改为SEAErrorVirtualBackgroundSessionFailed（103030）；enabledVirtualBackground:未装载就调用由SEAErrorConflict改为SEAErrorVirtualBackgroundNotInstalled（103028）。 - 报错文案改为英文：SDK 自身产生的
message一律英文（RTC 层透传的会在文案中带上 RTC 码），只给开发者和日志看；给终端用户的提示请按code自行映射，不要直接展示message。
新增
MeetingKit新增language属性（BCP 47 语言标签，如@"zh-CN"、@"en"；nil或空串表示跟随系统）与只读的currentLanguage。生效优先级为开发者设置 > 系统首选语言 >zh。会议层请求后端时带上Accept-Language，后端业务错误（1000–99999）的文案随之返回中文或英文；SDK 自身的报错一律英文，不受影响。进程级生效，不随登录 / 登出重置，建议在登录前设置。SEAError新增会议层错误码SEAErrorMeetingXxx（203xxx）与 RTC 层新增码SEAErrorUserCancelled、SEAErrorVirtualBackgroundXxx、SEAErrorSwitchAudioRouteFail、SEAErrorCameraNoAuthorized、SEAErrorMicNoAuthorized。
变更
SEAErrorNotAuthorized标为废弃，现为SEAErrorMeetingUnauthorized（203004）的同值别名；SEAErrorMediaNotInitialized标为废弃，现为SEAErrorNotInitialized（103024）的同值别名。switch中同时写一对同值常量会报重复case；引用废弃常量会产生废弃告警，开启-Werror（或Treat Warnings as Errors）的工程会直接编译失败，请改用新名字。language暂不作用于 RTC 层：RTCEngineKit 3.2.0尚未提供语言设置，RTC 层自身的请求不带Accept-Language。- 依赖
RTCEngineKit升级至3.2.0，podspec 最低依赖由>= 3.1.0提升为>= 3.2.0。
修复
- 修复后端响应的
code字段为null（或对象、数组）时崩溃的问题，现在按响应解析失败回调203356。
旧码 → 新码对照
会议层自身产生的错误：
透传的 RTC 层错误（枚举名不变，取值与
RTCEngineKit 3.2.0的RTCEngineError一致）：
后端业务码（
1000–99999，含SEAErrorApiXxx、SEAErrorMeetingApiXxx、SEAErrorRtcApiXxx）取值不变，仍原样透传，文案现在随language返回中文或英文。
MeetingKit与MeetingKitRoom的已有公开接口和回调签名均未删除或变更，平台下限不变（iOS 16.0）；需要检查的是按数值、按旧常量语义或按中文文案判断错误的代码，以及同时写了一对同值常量的switch。[2.1.0] - 2026.09.08
新增
MeetingKit新增虚拟背景能力：installVirtualBackground:、uninstallVirtualBackground、enabledVirtualBackground:、setVirtualBackgroundBlur:、setVirtualBackgroundImage:、setVirtualBackgroundInferenceInterval:、setVirtualBackgroundMaskSync:、isVirtualBackgroundEnabled，支持人像分割后做背景虚化或背景替换，且装载不需要授权密钥；- 虚拟背景作用于进程内唯一的共享摄像头采集链路，属设备级配置，设置同时作用于全部房间；会中切换摄像头与断线重连后由 SDK 自动重新应用当前配置，业务层不需要自己补，用法详见虚拟背景；
SEADeviceType新增SEADeviceTypeHarmonyOS（8），用于识别鸿蒙端成员。
变更
- 最低系统要求由 iOS 10.0 提升到 iOS 16.0；
- 依赖
RTCEngineKit升级至3.1.0，podspec 最低依赖由>= 3.0.0提升为>= 3.1.0；虚拟背景的推理引擎onnxruntime-c由RTCEngineKit的 podspec 传递引入，Podfile中不需要显式声明。
修复
- 同步
RTCEngineKit 3.1.0的本地预览修复：开启虚拟背景后本端预览显示的是处理后的画面，与对端看到的一致，此前本端只能看到摄像头原始画面； - 同步
RTCEngineKit 3.1.0对前处理输出缓冲被提前释放、送显缓冲与下一帧写入冲突导致画面卡死的修复。
[2.0.2] - 2026.08.28
变更
- 依赖
RTCEngineKit升级至3.0.2，同步流媒体服务响应解析修复。
修复
- 修复流媒体服务响应不再返回
upload字段时，底层解析异常导致崩溃的问题。
MeetingKit与MeetingKitRoom的公开接口和回调签名均未变化，业务层无需调整代码。[2.0.1] - 2026.08.14
变更
- 依赖
RTCEngineKit升级至3.0.1，同步屏幕共享修复。
修复
- 修复
2.0.0中屏幕共享无法推流的问题（拉起系统录屏后扩展端连接失败，弹出「尝试开始无效的直播会话」）； - 修复
-[MeetingKitRoom stopScreenRecord]只取消推流、系统录屏不会真正结束的问题。
MeetingKit与MeetingKitRoom的公开接口和回调签名均未变化，业务层无需调整代码。使用2.0.0的工程建议直接升级到本版本。[2.0.0] - 2026.08.12
新增
- 新增会议房间实例类
MeetingKitRoom，承载进出房间、本端音视频与共享、聊天与举手、主持人管理、云录制、等候室、分组讨论、签到与房间数据查询等全部会中能力； - 新增房间事件协议
MeetingKitRoomDelegate，承载房间内的一切事件； MeetingKit新增createRoomWithDelegate:与getRooms，用于创建房间实例与查询已加入的房间；MeetingKitRoom新增publishLocalVideo:与enabledSendAudio:，按房间粒度控制本端视频与音频的发布；MeetingKitRoomDelegate新增meetingRoom:onUserUpdate:自己数据更新回调与meetingRoom:onReceiveCustomMessage:action:userId:sessionId:nickname:房间自定义消息回调。
变更
MeetingKit收敛为全局单例，只保留登录登出、即时通讯、会议查询与预约、设备列表、本地采集预览、音频路由与屏幕采集进程接入；enterRoom:onSuccess:onFailed:、exitRoom:、callUser:onSuccess:onFailed:、requestOpenCamera:view:onSuccess:onFailed:、requestShare:onSuccess:onFailed:、sendRoomChatMessage:messageType:targetId:onSuccess:onFailed:、switchSpeaker:、enabledAudioModule:、startRemoteView:streamType:view:、adminXxx系列、云录制、等候室、分组讨论、签到、房间数据查询与媒体配置等接口由MeetingKit迁移到MeetingKitRoom；MeetingKitDelegate只保留onAudioRouteChange:previousRoute:与onApplicationPerformance:cpuUsage:两个全局事件；- 其余会中回调迁入
MeetingKitRoomDelegate，并统一在首参携带事件来源房间实例，例如onEnterRoom:userId:变更为meetingRoom:onEnterRoom:userId:、onUserMicStateChanged:micState:reason:变更为meetingRoom:onUserMicStateChanged:micState:reason:、onReconnecting变更为meetingRoomOnReconnecting:； - 依赖
RTCEngineKit升级至3.0.0，podspec 最低依赖由>= 2.5.0提升为>= 3.0.0。
优化
- 同一账号可同时创建多个房间实例并加入多个房间，各房间的媒体与业务状态相互独立，跨房间同 userId 的成员数据按房间隔离；
- 摄像头采集与预览、音频路由、屏幕采集作为共享设备能力统一由
MeetingKit管理，是否推送到某个房间由该房间实例单独控制； logout会离开并销毁全部房间实例后再释放资源，业务层无需逐个退出房间。
[1.3.7] - 2026.08.05
变更
- 依赖
RTCEngineKit升级至2.5.10，同步适配连接断开、开始重连和自定义消息回调新增的频道名称参数。
MeetingKit公开接口和MeetingKitDelegate回调签名均未变化，业务层无需调整代码。[1.3.6] - 2026.07.24
新增
- 新增
enabledAudioModule:接口，用于设置本端音频单元启停，录像直播等纯本地播放场景可停用底层音频单元避免播放音量被压低。
变更
- 依赖
RTCEngineKit升级至2.5.9。
[1.3.5] - 2026.07.23
修复
- 修复后置摄像头本地预览镜像及目标摄像头不可用回退后的方向状态异常。
变更
- 依赖
RTCEngineKit升级至2.5.6； - 明确
SEAMediaConfig.audioRoute为无外设时的默认内置路由； switchSpeaker:仅控制远端音频播放，音频输出设备使用switchAudioRoute:切换；currentAudioRoute和onAudioRouteChange:previousRoute:反映系统实际路由。
[1.3.4] - 2026.07.15
变更
- 依赖
RTCEngineKit升级至2.5.5； - 成员进入和退出会议回调不再过滤当前用户。
[1.3.3] - 2026.07.14
修复
- 修正加入会议参数
SEAMeetingEnterParam中isAudience的类型声明为BOOL。
[1.3.2] - 2026.07.14
新增
- 新增日志配置对象
SEALogConfig，支持通过enableLocalLog控制全进程本地日志采集； - 新增带
logConfig参数的登录接口，原登录接口保持兼容并默认启用本地日志。
变更
- 依赖
RTCEngineKit升级至2.5.4，启用本地日志时同时保留日志文件和宿主 App 控制台输出。
[1.3.1] - 2026.07.13
新增
- 加入会议参数
SEAMeetingEnterParam新增isAudience属性，用于指定是否以观众身份入会，默认值为NO。
变更
- 依赖
RTCEngineKit升级至2.5.3。
[1.3.0] - 2026.06.18
新增
- 新增设置本地预览镜像接口
setLocalPreviewMirror:； - 新增获取当前摄像头方向接口
currentCameraDirection； - 新增摄像头方向枚举
SEACameraDirection。
变更
- 依赖
RTCEngineKit升级至2.5.0。
[1.2.7] - 2026.06.16
新增
- 新增订阅远端转推音视频流接口
startRemoteRetweet:view:； - 新增停止订阅远端转推音视频流接口
stopRemoteRetweet:； - 新增流媒体接收转推流画面状态变更回调
onReceiveRetweetStreamStatusChange:status:。
[1.2.6] - 2026.04.30
新增
- 新增流媒体上行质量数据回调
onSendQualityModel:； - 新增流媒体下行质量数据回调
onReceiveQualityModel:；
[1.2.5] - 2026.04.28
新增
- 新增扩展事件回调
onExtendedEvents:content:。
[1.2.4] - 2026.04.24
新增
- 举手新增
SEAHandupTypeOther类型。
[1.2.3] - 2026.04.15
变更
- 部分必要接口移除主持人调用的限制。
[1.2.2] - 2026.04.10
变更
- 签到活动回调与签到结束回调新增
userId字段，表示：发起人标识。
[1.2.1] - 2026.04.09
新增
- 新增签到功能相关接口及其回调。
[1.2.0] - 2026.03.12
新增
- 成员共享屏幕事件逻辑重构，由事件和轨道列表共同解决；
- 录制状态
SEARecordStatus新增SEARecordStatuUnknown枚举； - 新增发布视图录制的共享流接口
publishScreenViewCaptureWithPixelBuffer:displayAngle:； - 新增设置视图采集共享接口
enabledViewCaptureShare:。
[1.1.9] - 2026.02.28
新增
- 流媒体配置新增
forceLandscape参数，用来业务层强制横屏设置； - 使用非自研流媒体供应商时的视频采集重构为
AVCaptureSession定义实现等； - 采集成功后的操作调整到主线程。
[1.1.8] - 2026.01.27
优化
- 回调问题修复与优化。
[1.1.7] - 2026.01.26
新增
- 新增云录制告警回调
onCloudRecordAlarm:taskId:gateway:alarmAt:alarmBrief:。
[1.1.6] - 2026.01.21
新增
- 新增主持人更新用户白板涂鸦状态方法；
- 新增主持人请求用户开启共享方法；
- 举手申请类型，新增
SEAHandupTypeDraw枚举； - 用户数据扩展信息新增
drawDisabled状态； - 新增请求开启共享回调；
- 新增用户涂鸦能力禁用状态变化回调。
[1.1.5] - 2025.12.16
新增
- 邀请设备对象新增
connectParams连接参数字段，用来支持GB28181邀请设备入会。
[1.1.4] - 2025.11.28
修复
- 修复部分已知问题与相关优化。
[1.1.3] - 2025.11.25
新增
- 新增等候室、分组讨论等相关接口以及回调。
[1.1.2] - 2025.06.17
新增
- 会议信息对象新增会议密码字段。
[1.1.1] - 2025.06.12
变更
- 创建房间接口响应数据变更为对象结构，详情请参看 SEAMeetingCreateModel 对象。
[1.1.1-alpha.1+20250612] - 2025.06.12
变更
- 创建房间接口响应数据变更为对象结构。
[1.1.0] - 2025.05.19
新增
- 新增会议即将开始回调
onMeetingRemind:； - 新增主持人更新房间共享禁用状态以及房间共享禁用状态变更回调，同时，房间扩展信息新增房间共享禁用状态属性；
- 新增媒体配置相关接口；
- 举手申请类型新增
SEAHandupTypeShare类型； - 新增回复同意打开房间共享请求方法；
- 回复同意打开房间共享请求成功后，新增共享开始回调；
优化
- 优化离开频道原因枚举判断的警告；
- 修复房间成员举手状态变化回调参数的异常；
- 修复接收
web共享流时，对方开始视频导致的订阅异常问题。
[1.1.0-alpha.1+20250424] - 2025.04.24
新增
- 新增会议即将开始回调
onMeetingRemind:； - 新增主持人更新房间共享禁用状态以及房间共享禁用状态变更回调，同时，房间扩展信息新增房间共享禁用状态属性；
- 新增媒体配置相关接口；
- 举手申请类型新增
SEAHandupTypeShare类型； - 新增回复同意打开房间共享请求方法；
- 回复同意打开房间共享请求成功后，新增共享开始回调；
优化
- 优化离开频道原因枚举判断的警告；
- 修复房间成员举手状态变化回调参数的异常；
- 修复接收
web共享流时，对方开始视频导致的订阅异常问题。
[1.0.0] - 2025.03.14
新增
- 完善与优化会议框架，正式版本发布。
[1.0.0-alpha.8+20241223] - 2024.12.23
新增
- 新增音频会话中断重启等逻辑；
- 接口enableImWithDelegate:onSuccess:onFailed:和enterRoom:onSuccess:onFailed:新增超时检测逻辑；
优化
- 返回错误信息等优化。
[1.0.0-alpha.7+20241206] - 2024.12.06
新增
- 加入频道成功回调时，新增触发云录制状态回调逻辑；
- 房间扩展信息新增云录制转态recordStatus；
- 会议参数以及会议信息对象新增是否开启录制autoRecord等。
[1.0.0-alpha.5+20241108] - 2024.11.08
新增
- 新增云录制相关接口。
[1.0.0-alpha.4+20241106] - 2024.11.06
优化
- 接收合成流问题修复以及新增部分逻辑优化。
[1.0.0-alpha.3+20241023] - 2024.10.23
新增
- 新增订阅与取消订阅端合成画面视频流接口以及接收合成流画面状态变更回调。
[1.0.0-alpha.2+20241014] - 2024.10.14
新增
- 新增主持人更新参会成员接口。
[1.0.0-alpha.1+20241009] - 2024.10.09
新增
- 新增即时通讯接口及其相关回调；
- 新增房间外会议操作等接口，如：获取会议列表、获取历史会议列表、获取会议详情等；
优化
- 适配MQTT SSL连接。
[0.0.1-alpha.6+20240819] - 2024.08.19
修正
- 升级rtcenginekit依赖，修复退出时更新码流数据引起的崩溃以及网络超时时间引起的异常崩溃等问题；
优化
- 优化重连成功回调参数以及签名算法；
- 用户登录新增version参数。
[0.0.1-alpha.5+20240731] - 2024.07.31
新增
- 所有主持人操作接口新增主持人权限的限制。
[0.0.1-alpha.4+20240730] - 2024.07.30
新增
- 用户摄像头状态变化以及麦克风状态变化回调新增变化原因参数
reason； - 新增回复同意打开摄像头请求接口以及回复同意打开麦克风请求接口。
[0.0.1-alpha.3+20240727] - 2024.07.27
变更
- 变更所有流媒体相关回调参数对象数据。
[0.0.1-alpha.2+20240725] - 2024.07.25
修正
- 修复加密时，由于秘钥为空导致的异常 Crash 问题。
[0.0.1-alpha.1+20240725] - 2024.07.25
新增
- 完善业务功能，内测版本发布。