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 等相关信息。
推荐的首次建连顺序如下:
- 创建
RTCPeerConnection,配置需要的 ICE 服务器。 - 发起端调用
createDataChannel(),注册通道事件。 - 发起端调用
createOffer(),再执行setLocalDescription()。 - 通过信令向接收端发送 Offer;接收端执行
setRemoteDescription()。 - 接收端调用
createAnswer()和setLocalDescription(),再通过信令返回 Answer。 - 发起端执行
setRemoteDescription(answer),双方交换 ICE Candidate,等待通道触发open。

这里有两个容易混淆的时机: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毫秒发送一次、过期即可丢弃的游戏位置更新,可以考虑以下配置:
// 片段示例: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 打开,然后点击页面中的按钮。
<!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>预期页面结果如下。事件和异步任务的执行顺序可能导致部分日志先后不同,但正常连通时应出现这些关键信息:
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(); 后增加以下调试语句。
// 片段示例:放在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 内容由浏览器实现决定,不应把示例环境中的数值写死为协议要求。
排查时可以依次检查以下三个层面:
- 协商内容:Offer 是否包含
m=application;如果没有,确认是否在createOffer()之前创建了通道。 - 连接状态:检查
pc.iceConnectionState、pc.connectionState和pc.sctp;ICE 成功不一定意味着 SCTP 通道已经打开。 - 通道状态:观察
channel.readyState,状态可能经历connecting、open、closing、closed。只有open才能正常调用send()。

如果调用 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。这三项分别验证协商内容、通道可用性和应用消息传递,缺少任何一项都不能认定数据连接已完整建立。