WebRTC 规范里没有信令。它只规定了两个端点如何用一个叫 RTCPeerConnection 的对象协商媒体、建立加密通道,至于 SDP 和候选地址怎么交换,留给业务自己实现。在线教育里,这根「信令线」还额外承担了举手、上台、翻页、板书、上下课——所以它往往比媒体链路更容易出问题。
标准 WebRTC 的 offer/answer 流程:
在 SFU 架构下,这条流程会发生两次:每个客户端各自与媒体服务器建一条 PeerConnection,学生之间不存在直接的 PeerConnection。所以「老师发布、学生订阅」在底层是「老师上行到 SFU,SFU 下行给学生」。
SDP 是纯文本,按行组织,m= 段落描述一条媒体流:
| 字段 | 作用 | 排查价值 |
|---|---|---|
m= 行 | 媒体类型、端口、传输协议、载荷类型列表 | 数量对不上说明轨道没加进去 |
a=sendrecv/sendonly/recvonly/inactive | 方向 | inactive 是最常见的「连上了但没流」 |
a=rtpmap | 编码与时钟频率 | 双方无交集会导致协商失败 |
a=fmtp | 编码参数(如 Opus FEC) | 关掉 useinbandfec 会明显削弱弱网表现 |
a=rtcp-fb | 反馈机制(NACK、PLI、transport-cc) | 没有 transport-cc 就没有拥塞控制反馈 |
a=ice-ufrag / a=ice-pwd | ICE 认证 | 复用错误会导致连通性检查全失败 |
a=fingerprint | DTLS 证书指纹 | 不匹配则媒体加密握手失败 |
a=setup | DTLS 角色 | 双方都是 active/passive 会卡住 |
SDP 不是配置,是协商结果。 改 SDP 前必须理解对端会怎么响应,直接「魔改」是线上事故的常见来源。
ICE 的任务是找出两端之间可用的网络路径,流程分三步:
| 候选类型 | 来源 | 特点 |
|---|---|---|
host | 本机网卡地址 | 同局域网最快 |
srflx | STUN 服务器反射出的公网地址 | 能穿透大多数 NAT |
relay | TURN 服务器中继 | 一定可用,但成本与延迟最高 |
工程要点:
xxx.local),跨网段无法解析,表现为「本地能连、跨网连不上」。a=fingerprint 校验。| 方案 | 延迟 | 双向 | 有序 | 结论 |
|---|---|---|---|---|
| HTTP 轮询 | 高 | 否 | 单次内有序 | 仅作兜底 |
| SSE | 中 | 单向 | 是 | 只适合下行通知 |
| WebSocket | 低 | 是 | 是 | 课堂信令的标准选择 |
| DataChannel | 低 | 是 | 可配 | 依赖已建连,不能用于建连本身 |
项目同时维护两条 WS:roomServer(课堂控制)与 chatServer(聊天,独立重连与限流),互不拖累。
工程约定:
MESSAGE_TIMEOUT,避免 Promise 永挂。to 的是点播(点对点),带 method 的是广播/通知。两者混在一个通道里,必须靠结构区分而不是靠猜。currentRoomID 与本地不一致的消息要丢弃,否则切班期间会串班。项目里 ping 每 10s 一次,连续 3 次无响应判定超时;onClose / onError 走 1–6s 随机重连,避免服务端故障恢复瞬间被全部客户端打垮。随机退避比固定间隔重要,这是雪崩防护。
重连成功不等于状态正确:断线期间可能有人上台、有人下课、课件翻页、老师被踢。所以重连后要拉全量:
| 查询 | 恢复的状态 |
|---|---|
queryActiveUsers | 台上用户、自己的上下台状态 |
queryUsers | 在线名单、角色 |
queryClass | 上课状态、开始时间 |
queryDocs | 课件列表与当前页 |
queryDisableRaiseHand / queryNotices | 课堂管控与公告 |
增量重放不可行——服务端不一定保留完整历史,顺序也无法保证。全量覆盖 + 幂等处理才是正确做法。
| 层 | 职责 | 关键点 |
|---|---|---|
Sender | 语义化 API:query / broadcast / unicast / customData | 关心响应与不关心响应要分开 |
RoomServer | 消息分流、拦截、回放 | 切班窗口会拦截非白名单消息 |
V5Websocket | 连接、心跳、超时、重连 | 与 RTC 重连解耦 |
Handler | method → VM 方法 | 未知 method 静默丢弃,新增信令必须同步加路由 |
两个易错点:
toggleClass 与匹配 id 的广播,其余入队;如果广播的 id 与 toggleClass 不一致,会被永久丢弃,表现为「切班后黑屏」。| 故障 | 现象 | 正确处理 |
|---|---|---|
| WS 断开 | 收不到任何课堂事件 | WS 重连 + 拉全量状态 |
| ICE 断开 | 信令正常、媒体中断 | ICE restart;失败再重建 RTC |
| 页面长时间后台 | 心跳被节流、媒体冻结 | 监听 visibilitychange,回前台重建 |
| 服务端主动踢人 | 收到 rejoin 类消息 | 不重连,直接退出并提示 |
把三者混成一个「重连」逻辑,是弱网体验差的常见根因:媒体抖一下就重进房,学生要重新等 3 秒首帧。