RTCPeerConnection.ondatachannel - Web API 接口参考 编辑

这是一个实验中的功能
此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

RTCPeerConnection.ondatachannel 属性是一个EventHandler，当这个datachannel事件在RTCPeerConnection发生时，它指定的那个事件处理函数就会被调用。这个事件继承于 RTCDataChannelEvent，当远方伙伴调用createDataChannel()时这个事件被加到这个连接（RTCPeerConnection）中。

在这个事件被收到的同时，这个RTCDataChannel 实际上并没有打开，确保在open这个事件在RTCDataChannel触发以后才去使用它。

语法

RTCPeerConnection.ondatachannel = function;

值

将这个属性设置为接受一个参数的函数：这个参数是一个RTCDataChannelEvent，它的channel属性是一个已经创建了的RTCDataChannel对象

示例

pc.ondatachannel = function(ev) {
  console.log('Data channel is created!');
  ev.channel.onopen = function() {
    console.log('Data channel is open and ready to be used.');
  };
};

规范

Specification	Status	Comment
WebRTC 1.0: Real-time Communication Between Browsers RTCPeerConnection.ondatachannel	Candidate Recommendation	Initial specification.

浏览器支持

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

• Desktop
• Mobile

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	(Yes) [1]	18 (18) [2]	未实现	(Yes)	?

Feature	Android	Chrome for Android	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile
Basic support	?	?	22.0 (22) [2]	未实现	?	?

[1] Though this property is not prefixed, the interface it belongs to is.

[2] This property's name isn't prefixed, but the interface it's in, RTCPeerConnection, was prefixed as MozRTCPeerConnection until Firefox 44.

相关阅读

• The datachannel event and its type, RTCDataChannelEvent.
• RTCPeerConnection.createDataChannel()
• A simple RTCDataChannel sample