编码与格式 / 系统课时
实时通话实践
实时通话实践
本课将搭建一个最小可运行的 WebRTC 音视频通话:浏览器采集摄像头和麦克风,通过 WebSocket 交换 SDP 与 ICE Candidate,再由 RTCPeerConnection 建立点对点媒体连接。完成后,可在两个浏览器标签页中加入同一房间并看到彼此画面。
学习目标
- 串联媒体采集、信令交换和点对点连接
- 正确处理 Offer、Answer 与 ICE Candidate
- 通过浏览器状态和日志验证通话是否建立
最小实现结构
示例包含一个只负责转发消息的信令服务器,以及一个浏览器页面。信令服务器不传输音视频,只把房间内一端发送的 Offer、Answer 和 ICE Candidate 转给另一端;媒体建立后主要沿 WebRTC 连接直接传输。

准备一个空目录,并安装 WebSocket 依赖:
mkdir webrtc-basic-call
cd webrtc-basic-call
npm init -y
npm install ws预期输出:
added <COUNT> packages, and audited <COUNT> packages in <TIME>
found 0 vulnerabilities<COUNT> 与 <TIME> 会随 npm 版本和本地缓存不同而变化。
编写信令服务器
新建 server.js。该服务器按房间保存连接,新客户端加入时通知房间内已有客户端;之后所有协商消息都原样转发给同房间的另一端。
const http = require("http");
const fs = require("fs");
const path = require("path");
const WebSocket = require("ws");
const server = http.createServer((req, res) => {
const filePath = path.join(__dirname, "index.html");
fs.readFile(filePath, (error, content) => {
if (error) {
res.writeHead(500, { "Content-Type": "text/plain; charset=utf-8" });
res.end("无法读取 index.html");
return;
}
res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
res.end(content);
});
});
const wss = new WebSocket.Server({ server });
const rooms = new Map();
wss.on("connection", (socket) => {
let currentRoom = null;
socket.on("message", (raw) => {
const message = JSON.parse(raw.toString());
if (message.type === "join") {
currentRoom = message.room;
const peers = rooms.get(currentRoom) ?? new Set();
peers.add(socket);
rooms.set(currentRoom, peers);
// 第二个客户端加入后,通知房间内已有客户端创建 Offer。
if (peers.size === 2) {
for (const peer of peers) {
if (peer !== socket && peer.readyState === WebSocket.OPEN) {
peer.send(JSON.stringify({ type: "peer-ready" }));
}
}
}
return;
}
const peers = rooms.get(currentRoom) ?? [];
for (const peer of peers) {
if (peer !== socket && peer.readyState === WebSocket.OPEN) {
peer.send(JSON.stringify(message));
}
}
});
socket.on("close", () => {
const peers = rooms.get(currentRoom);
if (!peers) return;
peers.delete(socket);
if (peers.size === 0) rooms.delete(currentRoom);
});
});
server.listen(8080, () => {
console.log("Open http://localhost:8080");
});这段代码是完整示例,但仅适合本地双人演示。生产环境还需要身份认证、房间权限、心跳、消息校验和多实例间的状态同步。
编写浏览器页面
新建 index.html。页面启动后先采集本地媒体,再加入固定房间 demo-room。第一个客户端收到 peer-ready 后创建 Offer,第二个客户端收到 Offer 后返回 Answer,双方都把新产生的 ICE Candidate 发给对端。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>WebRTC Basic Call</title>
<style>
video { width: 46%; background: #111; margin: 1%; }
</style>
</head>
<body>
<button id="start">加入通话</button>
<p id="status">未连接</p>
<video id="localVideo" autoplay muted playsinline></video>
<video id="remoteVideo" autoplay playsinline></video>
<script>
const startButton = document.querySelector("#start");
const statusText = document.querySelector("#status");
const localVideo = document.querySelector("#localVideo");
const remoteVideo = document.querySelector("#remoteVideo");
let socket;
let peerConnection;
let localStream;
const rtcConfig = {
iceServers: [{ urls: "stun:stun.l.google.com:19302" }]
};
function send(message) {
socket.send(JSON.stringify(message));
}
async function createPeerConnection() {
peerConnection = new RTCPeerConnection(rtcConfig);
// 每条本地轨道都加入连接,远端才能接收音视频。
for (const track of localStream.getTracks()) {
peerConnection.addTrack(track, localStream);
}
peerConnection.ontrack = (event) => {
remoteVideo.srcObject = event.streams[0];
};
peerConnection.onicecandidate = (event) => {
if (event.candidate) {
send({ type: "candidate", candidate: event.candidate });
}
};
peerConnection.onconnectionstatechange = () => {
statusText.textContent = `连接状态:${peerConnection.connectionState}`;
};
}
startButton.addEventListener("click", async () => {
startButton.disabled = true;
localStream = await navigator.mediaDevices.getUserMedia({
audio: true,
video: true
});
localVideo.srcObject = localStream;
await createPeerConnection();
socket = new WebSocket(`ws://${location.host}`);
socket.onopen = () => send({ type: "join", room: "demo-room" });
socket.onmessage = async (event) => {
const message = JSON.parse(event.data);
if (message.type === "peer-ready") {
const offer = await peerConnection.createOffer();
await peerConnection.setLocalDescription(offer);
send({ type: "offer", sdp: peerConnection.localDescription });
} else if (message.type === "offer") {
await peerConnection.setRemoteDescription(message.sdp);
const answer = await peerConnection.createAnswer();
await peerConnection.setLocalDescription(answer);
send({ type: "answer", sdp: peerConnection.localDescription });
} else if (message.type === "answer") {
await peerConnection.setRemoteDescription(message.sdp);
} else if (message.type === "candidate") {
await peerConnection.addIceCandidate(message.candidate);
}
};
});
</script>
</body>
</html>页面中的 STUN 服务仅用于发现公网候选地址。某些 NAT 或企业网络无法建立直连时,还需要配置 TURN 中继服务器,否则双方可能完成信令交换却始终没有远端画面。
运行与验收
启动服务器:
node server.js预期输出:
Open http://localhost:8080在同一台电脑上打开两个 http://localhost:8080 标签页,分别点击“加入通话”并授权摄像头与麦克风。第二个页面加入后,两个页面都应出现本地和远端视频,状态最终变为 connected。
验收时至少检查三点:两个页面都能看到远端画面;关闭一个页面后另一个页面不会继续收到新的信令;浏览器控制台中没有 InvalidStateError 或 addIceCandidate 调用时序错误。
常见失败处理
浏览器拒绝采集设备时,先确认页面运行在 localhost 或 HTTPS 安全上下文,并检查摄像头、麦克风权限。只有本地画面而没有远端画面时,查看 connectionState 和 ICE 状态;若长期停留在 checking,通常需要 TURN 或网络策略放行 UDP。
出现 setRemoteDescription 状态错误时,重点检查是否重复创建 Offer,或是否在收到 Answer 前再次发起协商。实际项目中应实现 Perfect Negotiation 模式,避免双方同时创建 Offer 造成碰撞。