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

验证 DataChannel 双向消息

验证 DataChannel 双向消息

WebRTC 的 SDP 协商完成、ICE 连接成功,并不代表应用数据已经可以正常收发。本课使用两个浏览器页面验证 DataChannel 的双向消息传输,再通过 WebRTC 统计信息找到实际选中的 ICE 候选对,判断数据走的是直连路径还是 TURN 中继路径。

学习目标

  • 正确等待 DataChannel 进入 open 状态,并完成双向消息收发验证。
  • 使用 getStats() 定位选中的 ICE 候选对,识别 host、srflx 和 relay 类型。
  • 区分应用层消息成功、ICE 连通性成功与实际传输路径,完成可重复的验收。

DataChannel 的 open 状态意味着什么

RTCDataChannel.readyState 有四种状态:connecting、open、closing 和 closed。只有进入 open,应用才应该开始发送正常业务消息。RTCPeerConnection.connectionState 为 connected 不能替代 DataChannel 的状态检查,因为两者描述的对象不同。

检查对象 通过条件 能证明什么
pc.connectionState connected PeerConnection 的传输连接已建立
channel.readyState open 当前 DataChannel 可以发送数据
channel.onmessage 收到预期消息 对端消息到达应用层
candidate-pair 统计 找到选中的候选对 能识别当前 ICE 传输路径

验证时应先监听 open、message、error 和 close 事件。若注册监听器时通道已经是 open,还应直接执行发送逻辑,避免错过已经触发的事件。

用两个浏览器页面完成双向收发

下面的最小示例使用同一浏览器的两个标签页,通过 BroadcastChannel 在本地交换 SDP 和 ICE 候选。它不需要单独部署信令服务器,适合验证 DataChannel 事件与双向收发。由于两个标签页运行在同一设备上,这个示例不能用于证明跨 NAT 穿透成功;真实网络路径应在跨设备测试中检查。

准备一个 index.html,在文件中写入以下完整代码。使用支持 WebRTC 的现代 Chromium 或 Firefox 浏览器,并通过本地 HTTP 服务访问。打开两个同源标签页,先在一个页面点击“发起连接”,另一个页面会自动应答。

html
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>DataChannel 双向验证</title>
<button id="start">发起连接</button>
<pre id="log"></pre>
<script>
const log = (...args) => {
  document.querySelector('#log').textContent += args.join(' ') + '\n';
};
const signaling = new BroadcastChannel('webrtc-data-test');
const pc = new RTCPeerConnection();
let channel;
let pending = [];
let remoteReady = false;

function bindChannel(dc) {
  channel = dc;
  dc.addEventListener('open', () => {
    log('DataChannel open');
    if (dc.label === 'test') dc.send('PING:A');
  });
  dc.addEventListener('message', event => {
    log('收到:', event.data);
    if (event.data === 'PING:A') dc.send('PONG:B');
    if (event.data === 'PONG:B') dc.send('ACK:A');
  });
  dc.addEventListener('error', event => log('通道错误:', event.type));
  dc.addEventListener('close', () => log('DataChannel closed'));
}

pc.addEventListener('datachannel', event => bindChannel(event.channel));
pc.addEventListener('icecandidate', event => {
  if (event.candidate) signaling.postMessage({candidate: event.candidate.toJSON()});
});

signaling.onmessage = async ({data}) => {
  try {
    if (data.description) {
      if (data.description.type === 'offer') {
        if (pc.signalingState !== 'stable') return;
        await pc.setRemoteDescription(data.description);
        remoteReady = true;
        for (const candidate of pending.splice(0)) await pc.addIceCandidate(candidate);
        await pc.setLocalDescription(await pc.createAnswer());
        signaling.postMessage({description: pc.localDescription});
      } else if (data.description.type === 'answer' && pc.signalingState === 'have-local-offer') {
        await pc.setRemoteDescription(data.description);
        remoteReady = true;
        for (const candidate of pending.splice(0)) await pc.addIceCandidate(candidate);
      }
    } else if (data.candidate) {
      if (remoteReady) await pc.addIceCandidate(data.candidate);
      else pending.push(data.candidate);
    }
  } catch (error) {
    log('信令处理失败:', error.message);
  }
};

document.querySelector('#start').onclick = async () => {
  if (pc.signalingState !== 'stable' || channel) return;
  // 仅由发起端创建通道,接收端通过 datachannel 事件获取。
  bindChannel(pc.createDataChannel('test'));
  await pc.setLocalDescription(await pc.createOffer());
  signaling.postMessage({description: pc.localDescription});
};
</script>
</html>

启动本地服务:

bash
python -m http.server 8000

预期结果:终端显示 HTTP 服务已启动,监听端口为 8000;实际启动提示因 Python 版本而异。访问 http://localhost:8000/ 并打开第二个标签页。这里的端口是示例固定配置,修改命令时应同步修改访问地址。

发起端页面的预期输出:

text
DataChannel open
收到: PONG:B

接收端页面的预期输出:

text
DataChannel open
收到: PING:A
收到: ACK:A

这三条消息形成完整的应用层确认链:A 发送 PING:A,B 收到后回复 PONG:B,A 收到后发送 ACK:A,B 再次收到确认。两端均出现预期记录,才算通过本例的双向收发验收。

本示例要求两个标签页处于同一浏览器存储分区,并且只打开一个发起端和一个接收端。BroadcastChannel 只承担本地信令交换,不承载 DataChannel 的业务消息。实际项目应使用自己的 WebSocket 信令服务替换它,并通过会话 ID 将消息路由到正确的远端。

找到实际选中的 ICE 候选对

双向消息成功之后,需要回答第二个问题:这些消息究竟通过哪条网络路径传输?WebRTC 的 ICE 机制会检查候选地址组合,并选择可用的候选对。getStats() 可以读取当前连接的统计信息。

在已有 pc 变量的页面中执行以下片段。它依赖前面建立的 RTCPeerConnection,因此属于片段示例,应在 DataChannel 进入 open 后调用。

js
async function inspectSelectedPair(pc) {
  const stats = await pc.getStats();
  const transports = [...stats.values()].filter(s => s.type === 'transport');
  const selectedIds = new Set(transports.map(s => s.selectedCandidatePairId).filter(Boolean));
  const pair = [...stats.values()].find(s =>
    s.type === 'candidate-pair' &&
    (selectedIds.has(s.id) || (s.selected === true && s.state === 'succeeded'))
  );
  if (!pair) {
    console.log('尚未找到选中的候选对');
    return;
  }
  const local = stats.get(pair.localCandidateId);
  const remote = stats.get(pair.remoteCandidateId);
  console.table({
    localType: local?.candidateType,
    remoteType: remote?.candidateType,
    state: pair.state,
    bytesSent: pair.bytesSent,
    bytesReceived: pair.bytesReceived
  });
}

inspectSelectedPair(pc);

预期结果:控制台显示一张表,包含本地候选类型、远端候选类型、候选对状态以及累计收发字节数。候选类型取决于实际网络,不能预先指定;部分浏览器可能不提供所需统计字段,此时会显示“尚未找到选中的候选对”。

候选类型 含义 路径判断
host 本机网络接口候选,可能以 mDNS 名称表示 非 TURN 中继候选
srflx 服务器反射候选,通常由 STUN 获得 非 TURN 中继候选
relay TURN 分配的中继候选 该端使用 TURN 中继

如果选中的本地候选或远端候选为 relay,说明选定路径包含 TURN 中继。两端都是 host 或 srflx 等非中继候选时,说明这条 ICE 候选路径未使用 TURN 中继,但不能仅凭候选类型证明它跨越了哪种 NAT,也不能证明路径经过公网。

WebRTC 双向消息确认与 ICE 选中候选对的关系图

验证消息确实经过选中路径

bytesSent 和 bytesReceived 是候选对统计对象中的累计字节数。可以在发送测试消息前后分别采样,检查计数是否增长,但需要注意 ICE 检查、保活以及其他协议流量也可能影响计数。因此,字节增长只能作为辅助证据,不能单独证明某一条应用消息已经送达。

建议按以下顺序完成真实网络验收:

  1. 在不同设备或不同网络的浏览器中建立 WebRTC 连接,使用实际信令服务器完成 Offer、Answer 和 ICE 候选交换。
  2. 等待两端 DataChannel 均为 open,发送带唯一消息 ID 的测试消息,并要求对端原样确认该 ID。
  3. 在发送前后分别调用 getStats(),记录选中候选对 ID、两端候选类型、候选对状态及字节计数。
  4. 使用浏览器的 chrome://webrtc-internals 或 Firefox 的 about:webrtc 辅助检查连接状态和候选信息;具体字段展示随浏览器版本变化。
  5. 在提供有效 TURN 服务的前提下,将两端 RTCPeerConnection 的 iceTransportPolicy 设置为 relay,重新建立连接并重复测试,验证中继路径。

iceTransportPolicy: 'relay' 必须在创建连接时通过配置对象设置,或通过受支持的 setConfiguration() 更新后重新进行必要的 ICE 协商。不能仅修改应用变量就认为当前连接已经切换路径。

常见失败如何定位

现象 优先检查 修复方式
DataChannel 一直 connecting SDP 是否完整交换、ICE 是否连通、DTLS 是否完成 检查信令日志和 connectionState,确认候选已正确添加
A 能发送但 B 没有消息 B 是否监听 datachannel 与 message 在接收端绑定事件后再发起协商
消息只出现一次 是否把 send() 当成双向确认 增加 PING、PONG、ACK 三段消息
候选对包含 relay TURN 是否参与选中路径 如需测试直连,检查 NAT 条件和候选对选择;不要直接判为故障
relay-only 模式连接失败 TURN 凭据、端口、传输协议与服务器可达性 检查 TURN 分配与 ICE 检查,确认服务端允许对应传输
找不到候选对统计 浏览器版本、统计字段、采样时机 等待连接稳定,结合浏览器 WebRTC 诊断页面核对

验收记录至少保留两端 DataChannel 状态、消息 ID 的完整确认链、选中候选对的本地与远端类型,以及是否启用了 relay-only 测试。只有应用消息得到双向确认,并且候选对统计与预期传输模式一致,才能认为本次 DataChannel 数据传输验证通过。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证 DataChannel 双向消息

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

登录哪都通