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

创建 DataChannel 触发协商

创建 DataChannel 触发协商

在浏览器中建立 WebRTC 数据连接时,先创建 RTCDataChannel,再生成 SDP Offer,可以让数据通道所需的 SCTP 传输进入会话协商。本课通过一个可直接运行的双端示例,完成通道创建、传输选项配置、Offer/Answer 交换和消息收发验证,并区分创建通道与真正连通的时机。

学习目标

  • 掌握 createDataChannel() 与 createOffer() 的正确调用顺序,理解数据通道如何进入 SDP 协商。
  • 能够配置 ordered、maxRetransmits 等选项,并判断不同可靠性策略的适用场景。
  • 能够运行浏览器内双端示例,验证 DataChannel 从创建到打开、发送和接收消息的过程。

为什么要在生成 Offer 前创建 DataChannel

WebRTC 的 RTCPeerConnection 负责协商和建立端到端连接,RTCDataChannel 则提供基于 SCTP、通常经过 DTLS 加密保护的数据传输能力。即使没有音视频轨道,也可以只使用 DataChannel 传输文本或二进制消息。

在首次协商前执行 pc.createDataChannel('chat'),会使连接具备需要协商的数据传输部分。随后调用 createOffer(),生成的 SDP 通常包含 m=application 媒体描述,以及 UDP/DTLS/SCTP、a=sctp-port 等相关信息。

推荐的首次建连顺序如下:

  1. 创建 RTCPeerConnection,配置需要的 ICE 服务器。
  2. 发起端调用 createDataChannel(),注册通道事件。
  3. 发起端调用 createOffer(),再执行 setLocalDescription()。
  4. 通过信令向接收端发送 Offer;接收端执行 setRemoteDescription()。
  5. 接收端调用 createAnswer() 和 setLocalDescription(),再通过信令返回 Answer。
  6. 发起端执行 setRemoteDescription(answer),双方交换 ICE Candidate,等待通道触发 open。

创建 DataChannel 与 SDP 协商的双端时序图

这里有两个容易混淆的时机:createDataChannel() 返回时,通道通常仍处于 connecting;接收端的 datachannel 事件表示获得远端创建的通道对象,不表示已经可以发送数据。真正允许发送应用消息的时机是 readyState === 'open'。

如果连接已经完成首次协商,之后才创建新的协商内 DataChannel,可能触发 negotiationneeded,需要重新协商。首次建连时先创建通道,可以避免为添加第一个数据通道额外进行一轮协商。

配置数据通道的传输选项

createDataChannel(label, options) 的第一个参数是通道名称,第二个参数用于选择消息顺序、可靠性和通道协商方式。以下选项适用于支持标准 WebRTC DataChannel API 的现代浏览器。

选项 默认值 作用与使用建议
ordered true 按顺序交付消息;聊天、指令序列建议保持开启
maxRetransmits 未设置 限制丢失消息的重传次数;0 表示不进行SCTP重传
maxPacketLifeTime 未设置 限制消息重传的时间预算,单位毫秒
negotiated false false 时由带内机制协商通道;true 时双方必须自行使用一致的通道ID
id 自动分配 SCTP Stream ID;通常不必手动指定
protocol 空字符串 应用自定义子协议标识,不会自动改变底层传输协议

maxRetransmits 和 maxPacketLifeTime 不能同时设置。两者都不设置时,采用可靠传输;但可靠传输也不意味着断线后消息一定能送达,应用仍需要处理连接失败。

例如,聊天消息可以使用默认的可靠有序通道,而每隔50毫秒发送一次、过期即可丢弃的游戏位置更新,可以考虑以下配置:

js
// 片段示例:pc 为已经创建的 RTCPeerConnection
const positionChannel = pc.createDataChannel('position', {
  ordered: false,
  maxRetransmits: 0
});

这段代码依赖已存在的 pc,不能单独运行。其生效行为是创建一个无序、无SCTP重传的数据通道。maxRetransmits: 0 不保证消息必然丢失或立即送达;网络正常时消息仍可成功接收。

运行最小双端 DataChannel 示例

下面使用一个 HTML 文件在同一浏览器页面内创建两个 RTCPeerConnection,模拟两个对等节点。Offer、Answer 和 ICE Candidate 直接在 JavaScript 中传递,省去外部信令服务器,便于独立验证 DataChannel API。

将以下内容保存为 datachannel-demo.html,使用现代 Chrome、Edge 或 Firefox 打开,然后点击页面中的按钮。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>WebRTC DataChannel Demo</title>
</head>
<body>
  <button id="start">建立数据通道</button>
  <pre id="log"></pre>
  <script>
    const log = message => {
      document.querySelector('#log').textContent += message + '\n';
    };

    document.querySelector('#start').onclick = async () => {
      const button = document.querySelector('#start');
      button.disabled = true;
      const a = new RTCPeerConnection();
      const b = new RTCPeerConnection();

      // 交换本地ICE候选;实际跨设备通信应通过信令服务器转发。
      a.onicecandidate = event => {
        if (event.candidate) {
          b.addIceCandidate(event.candidate).catch(console.error);
        }
      };
      b.onicecandidate = event => {
        if (event.candidate) {
          a.addIceCandidate(event.candidate).catch(console.error);
        }
      };

      b.ondatachannel = event => {
        const receiver = event.channel;
        log('B 收到通道:' + receiver.label);
        receiver.onmessage = message => {
          log('B 收到消息:' + message.data);
          receiver.send('pong');
        };
      };

      // 必须在首次createOffer之前创建通道。
      const channel = a.createDataChannel('chat', {
        ordered: true
      });
      log('A 创建通道:' + channel.readyState);

      channel.onopen = () => {
        log('A 通道已打开');
        channel.send('ping');
      };
      channel.onmessage = event => {
        log('A 收到消息:' + event.data);
      };

      try {
        const offer = await a.createOffer();
        await a.setLocalDescription(offer);
        await b.setRemoteDescription(a.localDescription);

        const answer = await b.createAnswer();
        await b.setLocalDescription(answer);
        await a.setRemoteDescription(b.localDescription);

        log('Offer/Answer 协商完成');
      } catch (error) {
        log('协商失败:' + error.message);
        a.close();
        b.close();
      }
    };
  </script>
</body>
</html>

预期页面结果如下。事件和异步任务的执行顺序可能导致部分日志先后不同,但正常连通时应出现这些关键信息:

text
A 创建通道:connecting
B 收到通道:chat
Offer/Answer 协商完成
A 通道已打开
B 收到消息:ping
A 收到消息:pong

该示例使用同一页面内的两个 PeerConnection,浏览器通常可以通过本机候选地址完成连接,因此没有配置 STUN 或 TURN。跨公网部署时,不能照搬这种直接传递信令的方式;需要使用真实信令服务,并根据网络环境配置 iceServers。

示例中的 ICE Candidate 使用异步转发,实际项目应缓存远端描述尚未设置时到达的候选,待 setRemoteDescription() 成功后再调用 addIceCandidate(),避免时序竞争。

检查 SDP 与通道状态

要确认 DataChannel 已进入首次协商,可以在示例中的 const offer = await a.createOffer(); 后增加以下调试语句。

js
// 片段示例:放在createOffer成功之后、setLocalDescription之前。
console.log(offer.sdp.split('\r\n').filter(line =>
  line.startsWith('m=application') ||
  line.startsWith('a=sctp-port:')
));

预期结果:控制台输出一个数组,其中包含以 m=application 和 a=sctp-port: 开头的 SDP 行。具体端口、媒体格式与 SDP 内容由浏览器实现决定,不应把示例环境中的数值写死为协议要求。

排查时可以依次检查以下三个层面:

  1. 协商内容:Offer 是否包含 m=application;如果没有,确认是否在 createOffer() 之前创建了通道。
  2. 连接状态:检查 pc.iceConnectionState、pc.connectionState 和 pc.sctp;ICE 成功不一定意味着 SCTP 通道已经打开。
  3. 通道状态:观察 channel.readyState,状态可能经历 connecting、open、closing、closed。只有 open 才能正常调用 send()。

DataChannel 创建、连接与关闭状态图

如果调用 send() 时通道仍处于 connecting,浏览器会抛出 InvalidStateError。因此业务代码应通过 open 事件或 readyState 检查控制发送时机,而不是在 setRemoteDescription() 返回后立即发送。

此外,send() 返回并不代表对端已经处理消息。对于大批量数据,还应关注 bufferedAmount,必要时结合 bufferedAmountLowThreshold 和 bufferedamountlow 事件实施发送背压,避免无限积压。

处理协商与传输中的常见问题

创建了通道却没有收到 datachannel 事件:先确认发起端是在生成 Offer 前创建通道,再检查接收端是否注册了 pc.ondatachannel,以及是否正确执行 setRemoteDescription()。事件监听应尽早注册,避免遗漏。

Offer/Answer 已完成,但通道始终处于 connecting:检查 ICE Candidate 是否完整交换、是否存在网络或防火墙限制,以及 ICE 是否进入失败状态。跨不同 NAT 网络时,可能需要 STUN 获取服务器反射候选,并配置 TURN 中继作为回退路径。

使用 negotiated: true 后接收端没有触发 datachannel:这是预期行为。手动协商模式不会通过带内机制自动创建远端通道,双方必须分别调用 createDataChannel(),并使用相同的 id。初学和普通聊天场景建议保持 negotiated: false。

消息发送后页面卡顿或连接被关闭:避免把大型文件一次性作为单条消息发送。应结合双方支持的消息大小限制进行分块,并使用 bufferedAmount 控制发送速度。应用层还需要处理失败重试和断线恢复。

最终验收时,应同时看到 SDP 中的数据传输描述、DataChannel 的 open 事件,以及对端实际收到的 ping 和 pong。这三项分别验证协商内容、通道可用性和应用消息传递,缺少任何一项都不能认定数据连接已完整建立。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建 DataChannel 触发协商

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

登录哪都通