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

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

RTCPeerConnection.iceConnectionState 是一个只读属性，用于描述连接的ICE连接状态，返回值为枚举类型。

语法

 var state = peerConnection.iceConnectionState;

返回值

RTCIceConnectionState的返回值为下面列举中的一种:

• "new": ICE 代理正在搜集地址或者等待远程候选可用。
• "checking": ICE 代理已收到至少一个远程候选，并进行校验，无论此时是否有可用连接。同时可能在继续收集候选。
• "connected": ICE代理至少对每个候选发现了一个可用的连接，此时仍然会继续测试远程候选以便发现更优的连接。同时可能在继续收集候选。
• "completed": ICE代理已经发现了可用的连接，不再测试远程候选。
• "failed": ICE候选测试了所有远程候选没有发现匹配的候选。也可能有些候选中发现了一些可用连接。
• "disconnected": 测试不再活跃，这可能是一个暂时的状态，可以自我恢复。
• "closed": ICE代理关闭，不再应答任何请求。

例子

var pc = new RTCPeerConnection();
var state = pc.iceConnectionState;

规范

Specification	Status	Comment
WebRTC 1.0: Real-time Communication Between Browsers RTCPeerConnection.iceConnectionState	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]	(Yes) [1]	未实现	(Yes)	?

Feature	Android	Chrome for Android	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile
Basic support	?	?	?	未实现	?	?

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

参考文档

• WebRTC