P2P 与分布式存储 / 系统课时

交换 Offer/Answer 完成协商

交换 Offer/Answer 完成协商

两个浏览器即使已经获得对方的网络地址,也不能直接开始 WebRTC 通信。双方需要先通过 SDP Offer 和 Answer 协商媒体能力、数据通道及传输参数。本课将实现一套最小双端协商流程,正确设置本地与远端描述,并验证连接状态及数据通道是否可用。

学习目标

  • 理解 Offer、Answer、SDP 与信令服务器各自承担的职责。
  • 正确使用 createOffer()、createAnswer()、setLocalDescription() 和 setRemoteDescription()。
  • 在两个浏览器中完成协商,验证连接建立,并识别常见的协商顺序错误。

Offer 和 Answer 分别负责什么

WebRTC 使用 RTCPeerConnection 管理端到端连接。SDP(Session Description Protocol)描述待协商的会话参数,包括媒体类型、编解码能力、ICE 参数、DTLS 指纹及数据通道相关信息。SDP 不是应用业务数据,也不负责把消息发送给远端。

Offer 由发起方创建,表示它希望建立的会话;Answer 由响应方根据收到的 Offer 创建,表示双方能够接受的协商结果。一次正常的初始协商遵循以下顺序:

  1. A 创建 RTCPeerConnection,添加数据通道或媒体轨道。
  2. A 调用 createOffer(),再通过 setLocalDescription() 保存本地 Offer。
  3. A 使用应用信令通道将 Offer 发送给 B。
  4. B 调用 setRemoteDescription() 设置远端 Offer,再创建 Answer。
  5. B 调用 setLocalDescription() 设置本地 Answer,并通过信令发送给 A。
  6. A 调用 setRemoteDescription() 设置远端 Answer,完成本轮 SDP 协商。

WebRTC Offer Answer 双端协商时序图

信令服务器只负责转发 Offer、Answer 和 ICE Candidate 等消息。WebRTC 不规定信令协议,实际项目可以使用 WebSocket、HTTP 或其他可靠消息机制。服务器无需解析 SDP 内容,但应根据会话 ID 和发送方身份正确路由消息。

用两个浏览器完成最小协商

下面的示例使用浏览器原生 WebRTC API,通过手动复制 JSON 信令消息连接两个页面,不依赖第三方库或信令服务器。这样可以直接观察 Offer、Answer 的生成、传递和应用顺序。

新建 index.html,写入完整示例。使用 Chrome、Edge 或 Firefox 的现代版本,分别打开两个页面。代码通过 onicecandidate 收集候选,并等待 ICE 收集完成后再复制 SDP,因此采用非 Trickle ICE 的演示方式。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>WebRTC Offer/Answer 演示</title>
</head>
<body>
  <button id="offer">创建 Offer(A)</button>
  <button id="answer">接收 Offer 并创建 Answer(B)</button>
  <button id="apply">接收 Answer(A)</button>
  <p>本地信令:复制到另一个页面的远端信令输入框</p>
  <textarea id="local" rows="12" cols="75" readonly></textarea>
  <p>远端信令:</p>
  <textarea id="remote" rows="12" cols="75"></textarea>
  <p id="status">尚未协商</p>
  <script>
    const pc = new RTCPeerConnection();
    const status = document.querySelector('#status');
    const local = document.querySelector('#local');
    const remote = document.querySelector('#remote');

    pc.onconnectionstatechange = () => {
      status.textContent = `连接状态:${pc.connectionState}`;
    };

    pc.ondatachannel = (event) => {
      const channel = event.channel;
      channel.onopen = () => {
        status.textContent = 'B:数据通道已打开';
        channel.send('Hello from B');
      };
      channel.onmessage = (event) => {
        status.textContent = `B 收到:${event.data}`;
      };
    };

    // 等待ICE收集结束,使复制的SDP包含已收集候选。
    function waitForIceComplete() {
      if (pc.iceGatheringState === 'complete') return Promise.resolve();
      return new Promise((resolve) => {
        const check = () => {
          if (pc.iceGatheringState === 'complete') {
            pc.removeEventListener('icegatheringstatechange', check);
            resolve();
          }
        };
        pc.addEventListener('icegatheringstatechange', check);
        check();
      });
    }

    async function publishLocalDescription() {
      await waitForIceComplete();
      local.value = JSON.stringify(pc.localDescription);
    }

    document.querySelector('#offer').onclick = async () => {
      try {
        const channel = pc.createDataChannel('chat');
        channel.onopen = () => {
          status.textContent = 'A:数据通道已打开';
          channel.send('Hello from A');
        };
        channel.onmessage = (event) => {
          status.textContent = `A 收到:${event.data}`;
        };
        const offer = await pc.createOffer();
        await pc.setLocalDescription(offer);
        await publishLocalDescription();
        status.textContent = 'A:Offer 已生成';
      } catch (error) {
        status.textContent = `${error.name}: ${error.message}`;
      }
    };

    document.querySelector('#answer').onclick = async () => {
      try {
        const offer = JSON.parse(remote.value);
        if (offer.type !== 'offer') throw new Error('需要 Offer');
        await pc.setRemoteDescription(offer);
        const answer = await pc.createAnswer();
        await pc.setLocalDescription(answer);
        await publishLocalDescription();
        status.textContent = 'B:Answer 已生成';
      } catch (error) {
        status.textContent = `${error.name}: ${error.message}`;
      }
    };

    document.querySelector('#apply').onclick = async () => {
      try {
        const answer = JSON.parse(remote.value);
        if (answer.type !== 'answer') throw new Error('需要 Answer');
        await pc.setRemoteDescription(answer);
        status.textContent = 'A:Answer 已应用,等待连接';
      } catch (error) {
        status.textContent = `${error.name}: ${error.message}`;
      }
    };
  </script>
</body>
</html>

本例没有配置 STUN 或 TURN 服务器,适合先在同一台电脑的两个浏览器页面中验证。跨公网或复杂 NAT 网络不保证成功;正式部署需要配置可用的 ICE 服务器及安全信令通道。

按正确顺序交换并验证结果

分别打开页面 A 和页面 B,按以下步骤操作。不要在同一个页面中同时点击创建 Offer 和创建 Answer,因为它们代表不同的协商角色。

  1. 在页面 A 点击“创建 Offer(A)”,等待文本框生成包含 type 和 sdp 的 JSON。
  2. 将 A 的本地信令完整复制到 B 的远端信令输入框。
  3. 在 B 点击“接收 Offer 并创建 Answer(B)”,等待 Answer 生成。
  4. 将 B 的本地信令完整复制到 A 的远端信令输入框。
  5. 在 A 点击“接收 Answer(A)”,观察两个页面的状态。

预期结果:A 首先显示“Offer 已生成”,B 显示“Answer 已生成”。A 应用 Answer 后进入等待连接阶段。若 ICE 连通性检查成功,两个页面最终会建立数据通道,并分别显示收到对端发送的 Hello from B 或 Hello from A。这些状态文本来自示例代码;若连接较快,后续事件可能覆盖前一条状态。

打开浏览器开发者工具 Console,还可以在代码中临时添加以下检查语句,或通过断点观察对应对象:

js
console.log(pc.signalingState);
console.log(pc.localDescription?.type);
console.log(pc.remoteDescription?.type);
console.log(pc.connectionState);

片段示例:这四行依赖页面脚本中已创建的 pc,可以放在最后一次 setRemoteDescription() 完成后执行;由于示例使用普通脚本的顶层 const,不要假定在所有调试上下文中都能直接访问该变量。

在 A 侧完成协商后,预期控制台结果通常为:

text
stable
offer
answer
connecting

最后一行是动态状态,也可能是 connected、failed 等,取决于读取时机和实际网络。B 侧的本地、远端描述类型则分别为 answer、offer。成功完成 Offer/Answer 交换后,双方 signalingState 应回到 stable。

理解信令状态和异步执行边界

RTCPeerConnection.signalingState 反映 SDP 协商阶段。初始 Offer/Answer 的主要状态如下:

操作完成后 A 的状态 B 的状态
初始创建 stable stable
A 设置本地 Offer have-local-offer stable
B 设置远端 Offer have-local-offer have-remote-offer
B 设置本地 Answer have-local-offer stable
A 设置远端 Answer stable stable

WebRTC Offer Answer 信令状态转换图

createOffer() 和 createAnswer() 只是生成描述,并不会自动完成描述设置。调用 setLocalDescription() 或 setRemoteDescription() 后必须等待返回的 Promise 完成,才能依赖新的协商状态执行下一步。

还要区分 pc.localDescription 与最初 createOffer() 返回的对象:ICE 收集期间,浏览器可能继续把候选信息加入当前本地描述。因此本例在 ICE 收集完成后读取 pc.localDescription,避免只复制最初生成、尚未包含完整候选信息的 SDP。

正式项目通常使用 Trickle ICE:不等待全部候选收集完成,而是在设置本地描述后立即发送 Offer 或 Answer,再通过 icecandidate 事件持续发送候选,由远端调用 addIceCandidate() 添加。这样能减少等待时间,但必须处理候选先于远端描述到达时的暂存与排序。

处理协商失败和重复消息

出现异常时,先检查双方的 signalingState、描述类型和调用顺序,再排查 ICE。以下是最常见的三类问题。

现象 可能原因 修正方法
InvalidStateError 在不允许的状态设置 Offer 或 Answer 检查 signalingState,不要重复应用同一轮消息
OperationError 或 SDP 解析失败 SDP 内容损坏或协商参数不兼容 保留完整 type、sdp,不要手工修改 SDP
SDP 协商完成但无法传输 ICE 候选不可达或网络策略阻断 检查 iceConnectionState、候选对及 STUN/TURN 配置

真实信令服务应为每次协商维护 sessionId、senderId 和消息序号,确保消息属于正确会话。收到重复 Answer 时,不应再次无条件调用 setRemoteDescription();应先验证当前是否仍处于等待 Answer 的状态。

双方同时发起 Offer 还会产生 Offer 冲突(glare)。本例通过固定 A 为发起方来避免该问题;支持双方随时重新协商的应用,应采用 WebRTC 的 Perfect Negotiation 模式,通过协商角色、碰撞检测与回滚机制处理冲突,而不是简单重试两次 createOffer()。

最终验收应同时满足:A、B 的 signalingState 均为 stable,connectionState 达到 connected,数据通道进入 open,并且两端能实际收到对方的消息。仅看到 Offer 和 Answer 成功交换,不能判定 P2P 连接已经建立。

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

目录与阅读设置

阅读设置

17

记录一个想法

交换 Offer/Answer 完成协商

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

登录哪都通