编码与格式 / 系统课时

实时通话实践

实时通话实践

本课将搭建一个最小可运行的 WebRTC 音视频通话:浏览器采集摄像头和麦克风,通过 WebSocket 交换 SDP 与 ICE Candidate,再由 RTCPeerConnection 建立点对点媒体连接。完成后,可在两个浏览器标签页中加入同一房间并看到彼此画面。

学习目标

  • 串联媒体采集、信令交换和点对点连接
  • 正确处理 Offer、Answer 与 ICE Candidate
  • 通过浏览器状态和日志验证通话是否建立

最小实现结构

示例包含一个只负责转发消息的信令服务器,以及一个浏览器页面。信令服务器不传输音视频,只把房间内一端发送的 Offer、Answer 和 ICE Candidate 转给另一端;媒体建立后主要沿 WebRTC 连接直接传输。

基础 WebRTC 通话的信令与媒体链路

准备一个空目录,并安装 WebSocket 依赖:

bash
mkdir webrtc-basic-call
cd webrtc-basic-call
npm init -y
npm install ws

预期输出:

text
added <COUNT> packages, and audited <COUNT> packages in <TIME>
found 0 vulnerabilities

<COUNT> 与 <TIME> 会随 npm 版本和本地缓存不同而变化。

编写信令服务器

新建 server.js。该服务器按房间保存连接,新客户端加入时通知房间内已有客户端;之后所有协商消息都原样转发给同房间的另一端。

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 发给对端。

html
<!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 中继服务器,否则双方可能完成信令交换却始终没有远端画面。

运行与验收

启动服务器:

bash
node server.js

预期输出:

text
Open http://localhost:8080

在同一台电脑上打开两个 http://localhost:8080 标签页,分别点击“加入通话”并授权摄像头与麦克风。第二个页面加入后,两个页面都应出现本地和远端视频,状态最终变为 connected。

验收时至少检查三点:两个页面都能看到远端画面;关闭一个页面后另一个页面不会继续收到新的信令;浏览器控制台中没有 InvalidStateError 或 addIceCandidate 调用时序错误。

常见失败处理

浏览器拒绝采集设备时,先确认页面运行在 localhost 或 HTTPS 安全上下文,并检查摄像头、麦克风权限。只有本地画面而没有远端画面时,查看 connectionState 和 ICE 状态;若长期停留在 checking,通常需要 TURN 或网络策略放行 UDP。

出现 setRemoteDescription 状态错误时,重点检查是否重复创建 Offer,或是否在收到 Answer 前再次发起协商。实际项目中应实现 Perfect Negotiation 模式,避免双方同时创建 Offer 造成碰撞。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实时通话实践

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通