WebRTC 实战:信令、ICE/TURN 与连接生命周期
本文目录
WebRTC 提供浏览器间实时音视频和数据通道,但它不是“两个浏览器直接连一下”的单个 API。应用仍要完成用户授权、会话协商、候选交换、连接状态管理、失败恢复和资源释放。公网环境也不能假设连接一定是点对点:网络策略可能要求媒体经 TURN 中继。
先拆开三条链路
| 链路 | 负责什么 | 常见实现 |
|---|---|---|
| 媒体采集 | 取得本地麦克风/摄像头轨道 | navigator.mediaDevices.getUserMedia() |
| 信令 | 交换 offer、answer、ICE candidate 和房间控制消息 | 已鉴权的 WebSocket、HTTP 或其他应用协议;WebRTC 不规定信令传输 |
| 媒体/数据传输 | 建立连接后交换音视频轨道或数据通道消息 | RTCPeerConnection、RTCDataChannel |
信令服务不必解读 SDP 才能转发,但必须知道会话参与者、目标房间和消息类型,并做身份、房间成员资格、大小与速率校验。不要把“信令服务只转发”误解为可以接受任意用户提供的目标 ID。
采集媒体并建立 PeerConnection
摄像头和麦克风属于敏感设备能力。页面应通过明确的用户操作开始采集,解释用途并处理用户拒绝、设备不存在、设备忙和权限被撤销等失败。不要在打开页面时静默启动采集。生产配置的 STUN/TURN 地址和临时凭据由服务端安全下发,不要把 TURN 长期密钥写进前端包。
let localStream;
let peer;
let callGeneration = 0;
function closeCall() {
callGeneration += 1;
peer?.close();
peer = undefined;
localStream?.getTracks().forEach((track) => track.stop());
localStream = undefined;
const localVideo = document.querySelector('#local-video');
const remoteVideo = document.querySelector('#remote-video');
if (localVideo) localVideo.srcObject = null;
if (remoteVideo) remoteVideo.srcObject = null;
}
async function startCall(iceServers, callId) {
closeCall();
const generation = ++callGeneration;
const stream = await navigator.mediaDevices.getUserMedia({ audio: true, video: true });
if (generation !== callGeneration) {
stream.getTracks().forEach((track) => track.stop());
return null;
}
let nextPeer;
try {
nextPeer = new RTCPeerConnection({ iceServers });
for (const track of stream.getTracks()) {
nextPeer.addTrack(track, stream);
}
nextPeer.ontrack = ({ streams }) => {
const remoteVideo = document.querySelector('#remote-video');
if (remoteVideo && streams[0]) remoteVideo.srcObject = streams[0];
};
nextPeer.onicecandidate = ({ candidate }) => {
sendSignal({ type: 'ice-candidate', callId, candidate: candidate?.toJSON() ?? null });
};
localStream = stream;
peer = nextPeer;
return peer;
} catch (error) {
nextPeer?.close();
stream.getTracks().forEach((track) => track.stop());
throw error;
}
}
sendSignal 是应用自己的、经过鉴权和消息校验的信令适配器。获取媒体流失败时不应继续创建一个看似已连接的 UI;创建部分资源后发生错误,也必须进入统一清理路径。
Offer、Answer 与 ICE 候选
呼叫发起方创建 offer,设置本地描述后将它发给对端;接收方设置远端描述、创建 answer,再交换回发起方。实际连接还要交换 ICE candidates。候选可能在 SDP 之后陆续到达,因此信令层应保留会话 ID,并处理“远端描述尚未设置,candidate 已先到”的竞态:暂存候选,成功设置远端描述后按序加入;拒绝或取消会话时清空队列。
async function createOffer(peer, callId) {
const offer = await peer.createOffer();
await peer.setLocalDescription(offer);
sendSignal({ type: 'offer', callId, description: peer.localDescription });
}
async function acceptOffer(peer, callId, description) {
await peer.setRemoteDescription(description);
await flushPendingCandidates(callId, peer);
const answer = await peer.createAnswer();
await peer.setLocalDescription(answer);
sendSignal({ type: 'answer', callId, description: peer.localDescription });
}
negotiationneeded 可能在初次建连和轨道变化时再次触发。双向同时发起协商会产生 glare;成熟实现应采用 perfect negotiation 模式,区分 polite/impolite peer,并按规范处理冲突与必要的 rollback,而不是对每次事件无条件重复发 offer。通话切换设备、增删轨道或调整发送参数,也应视为新的协商状态。
候选到达时还要校验它属于当前已授权的 callId 和远端成员,再交给 addIceCandidate()。过期会话的迟到信令应被丢弃。SDP 和候选不是普通日志文本:它们包含连接协商信息,避免记录完整内容或向无关客户端广播。
STUN、TURN 和“直连”误区
ICE 会收集并检查可能的网络路径。STUN 帮助发现可用候选,但不负责中继媒体,也不能保证 NAT/防火墙环境下直连成功。TURN 在直连不可用时转发媒体,是公网产品可用性的重要组成部分;它会带来带宽、流量费用与容量规划。上线前应在受限网络、企业代理、移动网络和 IPv6/NAT 环境测量成功率,而不是只在同一 Wi-Fi 下测试。
使用自有或明确获准的 STUN/TURN 服务。TURN 长期密钥只留在服务端;向客户端签发短时、有限权限的凭据,并限制滥用和并发。不能把公共演示 STUN 服务当成生产 SLA,也不能把成功建立 WebRTC 连接描述成媒体绝不会经过服务器。
状态、恢复和结束通话
同时观察 connectionState、iceConnectionState 和 signalingState,把“正在尝试”“暂时断开”“失败”“对端关闭”区分开。短暂的 disconnected 可能恢复,不宜立即结束;进入 failed 后可按产品策略尝试 restartIce() 并重新协商,设置次数和时间上限,避免网络故障时无限重拨。按钮状态要与权限、信令和媒体状态一致。
function closeCall() {
callGeneration += 1;
peer?.close();
peer = undefined;
localStream?.getTracks().forEach((track) => track.stop());
localStream = undefined;
const localVideo = document.querySelector('#local-video');
const remoteVideo = document.querySelector('#remote-video');
if (localVideo) localVideo.srcObject = null;
if (remoteVideo) remoteVideo.srcObject = null;
}
这里的 closeCall 与前文同一函数,不应在工程里复制两份实现。实际实现还需注销信令监听、清理待处理 candidate 和超时器、结束统计轮询,并确保重复点击结束操作是幂等的。切换账号、退出房间、组件卸载和权限撤销都应走同一清理流程。
候选缓冲与结束标记
前面的 flushPendingCandidates 是应用需要实现的适配器,不是浏览器内置 API。它至少要按 callId 隔离、有长度上限、维持当前协商顺序,并在挂断时清空;不能一个全局数组服务所有房间。设置远端描述和冲刷候选也应串行,避免重复消息同时操作同一个连接。
候选为 null 或空候选可以表示候选收集结束。信令 schema 要能明确表达这个状态,不能用“值为空就丢弃”的通用过滤器悄悄删掉;接收侧依据协议调用 addIceCandidate(null)。这与过期会话、未经授权的消息是两回事,后者应直接拒绝。
若调用 addIceCandidate 时 remoteDescription 尚未设置,可能得到 InvalidStateError;候选的媒体段标识或协商信息不匹配,也可能失败。不要 catch 后统一忽略。区分等待描述、旧协商消息和当前连接真实失败,在界面提供可操作的重试路径,同时避免公开记录完整候选。
这些边界可按 MDN addIceCandidate 的参数及异常说明核对。本文代码是生命周期和信令拆分示例,仍需接入真实的房间授权、候选队列和协商冲突处理,不能直接当完整会议系统发布。
DataChannel 不是 WebSocket
RTCDataChannel 适合随实时会话传递控制或低延迟数据。默认可靠、有序语义并不适合所有遥测;可根据需求评估 ordered、maxRetransmits 或 maxPacketLifeTime,并为消息定义 schema、大小上限、确认和过载策略。观察 bufferedAmount 与 bufferedamountlow,在缓冲过高时暂停发送或丢弃明确可丢的旧状态。WebSocket 经服务器中转,通常更易运维和鉴权;DataChannel 走 WebRTC 数据传输,连接建立与网络穿透更复杂,两者不能只按“都能发消息”互换。
验收与排障
- 分别测允许/拒绝设备权限、设备缺失、设备占用、页面隐藏、切换摄像头和拔出设备。
- 用两端不同网络测试 offer/answer、候选先后到达、同时协商、取消后迟到消息、重连与重复消息。
- 在需要 TURN 的受限网络中确认候选类型、连接成功率、媒体方向、延迟、丢包和中继带宽;不要只验证 LAN。
- 用
getStats()观察候选对、往返时间、丢包和码率趋势;指标只用于诊断,不将完整 SDP、候选、设备标签或用户身份写入公开日志。 - 退出、切页、切账号和权限撤销后,确认摄像头指示灯熄灭、轨道停止、PeerConnection 关闭且信令监听已移除。
- 在桌面 Chromium、Safari/iOS、Android 浏览器和目标 WebView 上分别验证;浏览器支持不等于设备、权限策略和企业网络可用。
参考:MDN WebRTC API、MDN 信令与视频通话、MDN WebRTC connectivity、W3C WebRTC 1.0、RFC 8445 ICE。
留言提交后直接公开,请友善交流。