RTCPeerConnection.iceGatheringState

只读属性 RTCPeerConnection.iceGatheringState 返回一个描述连接的 ICE 收集状态的字符串。比如当 ICE 候选收集完成的时候,你可以通过该属性的变化侦测到。

通过监听 icegatheringstatechange 类型的事件,你可以侦测到该属性的变化。

可能的值是:

new

对等连接刚刚创建,尚未进行任何网络连接。

gathering

ICE 代理正在收集候选的连接。

complete

ICE 代理完成了候选的收集。如果发生了需要收集的新候选,例如一个新接口的增加或者一个新的 ICE 服务器的增加,状态将恢复到 gathering,并去收集这些候选。

示例

js
const pc = new RTCPeerConnection();
const state = pc.iceGatheringState;

规范

Specification
WebRTC: Real-Time Communication in Browsers
# dom-peerconnection-ice-gathering-state

浏览器兼容性

BCD tables only load in the browser

参见