事件参考

注册与注销

所有会议事件都通过 SMeetingDelegate 上报：

final class MeetingController: SMeetingDelegate {
    init(meeting: SMeetingEngine) {
        meeting.delegates.add(delegate: self)
    }

    func meeting(_ meeting: SMeetingEngine, userDidEnter user: MeetingUserInfo) {
        print("成员进入:", user.name)
    }
}

要点：

delegates 是弱引用多播，可以注册多个观察者，SDK 不会因为注册而延长你的对象生命周期
协议里所有方法都有默认空实现，只实现关心的事件即可
不再需要时调用 meeting.delegates.remove(delegate:)
回调统一在主线程派发，可以直接更新 UI

如果你的观察者是 @MainActor 类型，协议方法需要声明为 nonisolated，再在里面回到主 actor 上下文：

extension MeetingController: SMeetingDelegate {
    nonisolated func meeting(_ meeting: SMeetingEngine, userDidExit data: UserExitEventData) {
        DispatchQueue.main.async { self.users = meeting.getUsersInfoList() }
    }
}

连接事件

方法	触发时机	数据类型
`meetingIsReconnecting(_:)`	会议连接中断，开始自动重连	无
`meetingDidReconnect(_:)`	重连成功	无
`meeting(_:didDisconnect:)`	自己被断开：主动退会、被移出、会议结束、超时等	`DisconnectEventData`

DisconnectEventData 的 reason 是 DisconnectReason，可据此区分是自己走的还是被动断开；error 在异常断开时携带底层错误。

成员事件

方法	触发时机	数据类型
`meeting(_:userDidEnter:)`	其他成员进入会议	`MeetingUserInfo`
`meeting(_:userDidExit:)`	成员离开会议	`UserExitEventData`
`meeting(_:userCameraStateDidChange:)`	任一成员（含自己）摄像头开 / 关	`UserCameraStateChangeEventData`
`meeting(_:userMicStateDidChange:)`	任一成员（含自己）麦克风开 / 关	`UserMicStateChangeEventData`
`meeting(_:userNameDidChange:)`	成员会中昵称变化	`UserNameChangeEventData`
`meeting(_:userRoleDidChange:)`	成员角色变化，含主持人转移	`UserRoleChangeEventData`
`meeting(_:roomHostDidMove:)`	主持人转移（1.5.0 起）	`RoomHostMoveEventData`
`meeting(_:userChatDisabledDidChange:)`	成员被单独禁言 / 解除	`UserChatDisabledChangeEventData`
`meeting(_:userDrawDisabledDidChange:)`	成员被禁止涂鸦 / 解除	`UserDrawDisabledChangeEventData`
`meeting(_:userDidHandup:)`	成员举手、取消举手，或响应了主持人的开启邀请	`UserHandupEventData`

媒体状态事件里的 byAdmin 为 true 时表示这次变化是主持人操作导致的，opUid 是操作者。你可以据此给用户一个「已被主持人关闭麦克风」这类提示。主持人转移时，SDK 先把新主持人本地升为 .host、原主持人降为 .member，各发一次 userRoleDidChange，再发 roomHostDidMove（带新主持人 uid 与原主持人 sourceUid）。只关心角色刷新的话不必实现 roomHostDidMove。原主持人在本地快照里不是 .host 时不补发降级那次 userRoleDidChange。 UserHandupEventData.step 区分是哪一步：.request 举手、.cancel 取消、.confirmOpen 同意邀请、.rejectOpen 拒绝邀请。

房间状态事件

方法	触发时机	数据类型
`meeting(_:roomMicStateDidChange:)`	全体静音设置变化	`RoomMicStateChangeEventData`
`meeting(_:roomCameraStateDidChange:)`	全体禁画设置变化	`RoomCameraStateChangeEventData`
`meeting(_:roomShareStateDidChange:)`	禁止共享设置变化	`RoomShareStateChangeEventData`
`meeting(_:roomChatDisabledDidChange:)`	全体禁言设置变化	`RoomChatDisabledChangeEventData`
`meeting(_:roomScreenshotDisabledDidChange:)`	禁止截屏设置变化	`RoomScreenshotDisabledChangeEventData`
`meeting(_:roomWatermarkDisabledDidChange:)`	水印开关变化	`RoomWatermarkDisabledChangeEventData`
`meeting(_:roomLockedDidChange:)`	会议锁定状态变化	`RoomLockedChangeEventData`
`meeting(_:roomTitleDidChange:)`	会议标题被改名，含小组会议改名	`RoomTitleChangeEventData`
`meeting(_:roomShareDidStart:)`	有人开始共享（屏幕或白板）	`RoomShareStartEventData`
`meeting(_:roomShareDidStop:)`	共享结束	`RoomShareStopEventData`
`meeting(_:shareBroadcastDidStart:)`	仅 iOS 全屏共享：扩展真的开始出帧	`ShareBroadcastStartEventData`
`meeting(_:shareBroadcastDidFinish:)`	仅 iOS 全屏共享：出帧结束	`ShareBroadcastStopEventData`
`meeting(_:roomMcuTask:)`	录制 / 合流任务状态变化	`RoomMcuTaskEventData`
`meeting(_:roomJoinDidFail:)`	有成员入会失败	`RoomJoinFailedEventData`

屏幕共享的 roomShareDidStart 以 RTC 媒体轨道为准，远端 screen 轨道到达即上报，收到时可以直接渲染共享画面。 shareBroadcastDidStart / shareBroadcastDidFinish 只在 iOS 全屏共享、且只在共享方自己这一端触发，用于区分「监听已挂上」和「真的有画面了」，接法见屏幕共享。当主持人开启「全体静音」或「全体禁画」时，非主持人成员的本地设备会被 SDK 自动关闭，并额外上报一次对应的成员媒体状态事件。 roomTitleDidChange 的载荷带 title 与 previousTitle，主会议改名和小组会议改名（adminUpdateSubMeetingTitle）都会触发。它没有 opUid：会议改名没有独立的广播指令，事件是频道属性更新后比对标题得出的，属性里只有结果没有操作者，编一个操作者出来反而会误导调用方。

消息事件

方法	触发时机	数据类型
`meeting(_:didReceiveChatMessage:)`	收到会中聊天消息	`RoomChatMsgEventData`
`meeting(_:didReceiveCustomMessage:)`	收到业务自定义消息	`RoomCustomMsgEventData`

两者都有 isPrivate 标记是否为私聊，uid 是发送者。主持人从后台下发的系统消息也走 didReceiveChatMessage。1.5.0 起 RoomChatMsgEventData 带 action（原始广播 action：成员聊天为 user_send_room_chat_message，系统消息为 admin_send_room_chat_message）和 isSystem，需要区分展示或过滤系统消息时判断 isSystem 即可。

主持人指令事件

方法	触发时机	数据类型
`meeting(_:adminDidConfirmHandup:)`	主持人处理了举手申请	`AdminConfirmHandupEventData`
`meeting(_:adminDidRequestOpenMic:)`	主持人邀请你开麦	`AdminRequestOpenMicEventData`
`meeting(_:adminDidRequestOpenCamera:)`	主持人邀请你开摄像头	`AdminRequestOpenCameraEventData`

处理方式见举手与开启请求。

等候室事件

方法	触发时机	数据类型
`meeting(_:userDidEnterWaitingRoom:)`	有人进入等候室	`UserEnterWaitingRoomEventData`
`meeting(_:userDidExitWaitingRoom:)`	有人离开等候室	`UserExitWaitingRoomEventData`
`meeting(_:waitingRoomDisabledDidChange:)`	等候室开关变化	`AdminUpdateWaitingRoomDisabledEventData`
`meetingDidMoveToWaitingRoom(_:)`	自己被主持人移回等候室	无

分组讨论事件

方法	触发时机	数据类型
`meeting(_:adminDidStartSubMeeting:)`	主持人开始了分组讨论	`AdminStartSubMeetingEventData`
`meeting(_:adminDidStopSubMeeting:)`	主持人结束了分组讨论	`AdminStopSubMeetingEventData`
`meeting(_:adminDidMoveSubMeetingUser:)`	你被移动到另一个小组	`AdminMoveSubMeetingUserEventData`

这三个事件都需要你自行完成「退出当前会议、进入目标会议」的切换。

签到与点名事件

方法	触发时机	数据类型
`meeting(_:signInActivity:)`	主持人发起了一轮签到	`SignInActivityEventData`
`meeting(_:signInDidFinish:)`	签到活动结束	`SignInFinishEventData`
`meeting(_:rollCallNamed:)`	你被点名	`RollCallNamedEventData`

外设事件

方法	触发时机	数据类型
`meeting(_:didAddDevice:)`	系统接入了摄像头 / 麦克风 / 扬声器，或 iOS 音频路由新增	`DeviceChangeEventData`
`meeting(_:didRemoveDevice:)`	设备被移除	`DeviceChangeEventData`

外设事件不依赖会议状态，SDK 实例创建后就开始上报，可用于入会前的设备检测页面。

音频路由事件（iOS）

方法	触发时机	数据类型
`meeting(_:audioRouteDidChange:)`	输出路由变化：听筒 / 外放 / 蓝牙 / 有线之间的切换	`AudioRouteChangeEventData`
`meetingAudioRouteDidRecoverFromInterruption(_:)`	来电 / Siri 中断后真正恢复成功	无

两个回调都只在 iOS 存在（声明包在 #if os(iOS) 里），且与外设事件一样不依赖会议状态。 AudioRouteChangeEventData.reason 是系统给出的变化原因，排查路由问题时比结果本身更有价值。中断恢复可能因系统通话未结束、App 仍在后台而延后，SDK 只在真正恢复后触发一次。详见音频路由。

通话质量事件

方法	触发时机	数据类型
`meeting(_:didReceiveQualityReport:)`	服务端每次下发质量报告（实时数值流）	`QualityReport`
`meeting(_:connectionQualityDidChange:)`	质量等级发生跳档（断言式）	`ConnectionQualityChange`
`meeting(_:activeSpeakersDidChange:)`	活跃说话人变化	`ActiveSpeakersSnapshot`
`meeting(_:didSwitchLayer:)`	大小流切层完成	`LayerSwitchedInfo`

质量走双轨，按用途选一条即可，不要两条都拿去驱动同一个 UI：

didReceiveQualityReport 是每次上报都触发的原始数值（丢包、RTT、抖动、码率、MOS），适合信号塔图标与详细诊断面板
connectionQualityDidChange 只在等级跳档时触发，适合「当前网络不佳」提示和主动降级决策

activeSpeakersDidChange 给的是全量快照（已按音量降序排好），直接覆盖 UI 即可，不需要自己合并增量。无人说话时 speakers 为空数组。自 1.6.0 起自己也在快照里（isLocal == true，开麦且在说话时出现），与远端同一量纲；不想要可设 meeting.activeSpeakerOptions.includeLocal = false。这四个事件的数据结构定义在底层 SRTC 模块，使用时需要 import SRTC，字段说明见类型定义；等级判定、冷启动取值与主动切层的完整说明见 SRTC · 通话质量与活跃说话人。

这四个事件只在会议使用 SeaStart（SFU） 引擎时有 —— 走 CDN（WangSu）的会议没有这条信令通道，不会收到任何一个。

收流状态事件

方法	触发时机	数据类型
`meeting(_:didChangeReceiveStreamStatus:)`	某一路远端视频收流超时 / 恢复	`ReceiveStreamStatus`

按轨道判定：某一路视频连续一段时间没有出帧就报超时（timedOut == true），帧一恢复立即再报一次（timedOut == false）。典型用法是开关某一格画面上的「加载中」指示。订阅后首帧到达时会先收到一次恢复，据此关掉初始 loading。载荷直接复用底层 SRTC 的 ReceiveStreamStatus（需要 import SRTC），字段见类型定义。对应老 MeetingKit 的 onReceiveStreamStatusChange:streamType:status:。

不要用 connectionQualityDidChange 代替它。 质量档位是整条链路一个值，说的是「网好不好」，不是「这一格画面停没停」：单路轨道被停推、发送端摄像头卡死、某一路解码失败时，档位可以一直是 excellent。用档位驱动单格的加载指示必然误报。

与上面四个质量事件不同，这个事件两种引擎都有 —— 它由本地是否收到视频帧判定，不依赖 SFU 的信令通道。

会议外消息事件

需要先调用 enableIm()，见会议外消息。

方法	触发时机	数据类型
`meeting(_:imDidConnect:)`	`enableIm()` 成功后触发一次（1.5.0 起）	`ImConnectEventData`
`meeting(_:imDidReceiveMessage:)`	收到任意一条会议外消息，原样透传（1.5.0 起）	`ImMessageEventData`
`meeting(_:imCallCalling:)`	有人在会议里呼叫你	`ImCallCallingEventData`
`meeting(_:imMeetingRemind:)`	会议开始提醒	`ImMeetingRemindEventData`
`meeting(_:imAdminMoveOutWaitingRoom:)`	你被放行出等候室	`ImAdminMoveOutWaitingRoomEventData`
`meeting(_:imUserHelpSubMeeting:)`	有小组请求协助	`ImUserHelpSubMeetingEventData`
`meetingImIsReconnecting(_:)`	会议外消息通道开始重连	无
`meetingImDidReconnect(_:)`	会议外消息通道重连成功	无
`meeting(_:imDidDisconnect:)`	会议外消息通道被动断开：被踢、心跳超时、后端报错	`ImDisconnectEventData`

这几个连接事件与前面的会议连接事件是两条独立通道，不要混用。

1.4.1 及以前，enableIm() 只建立通道、没有把消息派发出来，呼叫 / 提醒 / 等候室放行 / 小组求助和重连、断开回调实际都收不到；1.5.0 起才真正派发
每条消息先以原始形态触发一次 imDidReceiveMessage，SDK 认识的 action 再额外派发到对应的具名事件；业务自定义的 action 只走原始透传
重连成功走 meetingImDidReconnect，不会再触发 imDidConnect
主动调用 disableIm() 不会触发 imDidDisconnect；被动断开时 ImDisconnectEventData 带 disconnectReason（SRTC ImDisconnectReason）、errorCode、errorMessage

事件标识枚举

SDK 另外公开了两个枚举，列出各事件的字符串标识：

RoomEventType —— 会议内事件标识，例如 user_enter、room_share_start；1.5.0 起新增 roomHostMoved（room_host_moved），对应 roomHostDidMove
ImEventType —— 会议外消息事件标识，例如 call_calling；1.5.0 起另有 connected、message，对应 imDidConnect、imDidReceiveMessage

Swift 侧的事件分发走上面的 SMeetingDelegate 方法，这两个枚举在正常接入中用不到，只在你需要做日志埋点或与其它端对齐事件命名时才有用。

概览

极简对接

Web SDK

Android SDK

Windows SDK

Swift SDK（iOS/macOS）

iOS SDK

HarmonyOS SDK

服务端 API

注册与注销

连接事件

成员事件

房间状态事件

消息事件

主持人指令事件

等候室事件

分组讨论事件

签到与点名事件

外设事件

音频路由事件（iOS）

通话质量事件

收流状态事件

会议外消息事件

事件标识枚举

相关页面

​注册与注销

​连接事件

​成员事件

​房间状态事件

​消息事件

​主持人指令事件

​等候室事件

​分组讨论事件

​签到与点名事件

​外设事件

​音频路由事件（iOS）

​通话质量事件

​收流状态事件

​会议外消息事件

​事件标识枚举

​相关页面

注册与注销

连接事件

成员事件

房间状态事件

消息事件

主持人指令事件

等候室事件

分组讨论事件

签到与点名事件

外设事件

音频路由事件（iOS）

通话质量事件

收流状态事件

会议外消息事件

事件标识枚举

相关页面