核心概念

​

整体模型

• SMeeting：唯一对外类，登录、会议管理、进出会议、媒体控制、主持人操作都在它上面
• RoomInfo：当前会议的房间级状态（标题、全体禁音禁画、锁定、共享状态等）
• MeetingUserInfo：会中某个成员的状态（昵称、角色、麦克风、摄像头、共享）
• SMeetingDelegate：所有会议事件的回调入口
• SMeetingRemoteVideoView / SRTCVideoView：画面渲染入口

​

会议层与 RTC 层的术语差异

​

会议生命周期

login  →  会前（创建 / 查询 / 修改会议）  →  enterRoom  →  会中  →  exitRoom  →  logout

​

会议 ID 与房间号

​

会议类型与会议模式

• MeetingType：.instant 即时会议 / .appointment 预约会议。预约会议需要额外填 planTime（秒级时间戳）和 planDur（分钟）
• MeetingMode：.normal 普通、.mix 合成、.voice 语音会议、.training 培训、.subMeeting 分会场

​

会中状态：RoomInfo 与 MeetingUserInfo

let roomInfo = meeting.getRoomInfo()          // 当前房间信息，未入会时为 nil
let users = meeting.getUsersInfoList()        // 所有成员（数组）
let usersMap = meeting.getUsersInfo()         // 所有成员（uid → 成员）
let me = try meeting.getUserInfo(meeting.currentUserId ?? "")

​

角色与权限

let me = try? meeting.getUserInfo(meeting.currentUserId ?? "")
let isAdmin = me?.role == .host || me?.role == .coHost

​

轨道描述 TrackDesc

​

媒体控制的命名规则

• 开启侧叫 requestOpenMic / requestOpenCamera / requestShare —— 带 request 是因为这些动作要先向会议申请（受全体静音、全体禁画、禁共享等房间策略约束），再在本地起流
• 关闭侧叫 closeMic / closeCamera / stopShare —— 直接停止本地流，没有申请环节，不会抛错

​

视频渲染入口

​

音频的订阅语义

• 音频：进入会议后自动订阅，不需要你逐个成员去订阅。听筒 / 外放开关走 toggleRemoteAudioMute(_:)，它只切播放，不动订阅关系
• 视频：按需订阅。大会场里如果把所有人的视频都订阅了，带宽和解码开销都不可控，所以要由你决定当前布局里哪几路需要拉流

​

事件体系

meeting.delegates.add(delegate: self)
// 不再需要时
meeting.delegates.remove(delegate: self)

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

@MainActor
final class MeetingController: ObservableObject {
    @Published var users: [MeetingUserInfo] = []
}

extension MeetingController: SMeetingDelegate {
    nonisolated func meeting(_ meeting: SMeeting, userDidEnter user: MeetingUserInfo) {
        DispatchQueue.main.async { self.users = meeting.getUsersInfoList() }
    }
}

​

会议外消息（IM）

​

底层 RTC 能力

meeting.srtc.logLevel = .debug

请始终使用 meeting.srtc，不要自行另建一个 SRTC 实例：会议与底层共享同一个实例，另起一个会导致状态分裂、消息通道重复、设备被抢占。

​

建议继续阅读

• 媒体控制
• 视频渲染
• 屏幕共享
• 主持人管控
• 类型定义