RTCIceTransport: gatheringState 属性

Baseline 2024
新推出

自 ⁨2024 年 4 月⁩ 起,此功能可在最新的设备和浏览器版本中运行。此功能可能不适用于较旧的设备或浏览器。

RTCIceTransport 接口的只读属性 gatheringState 返回一个字符串,表示此传输的 ICE 代理当前的收集状态:"new""gathering""complete"

您可以通过监视类型为 gatheringstatechange 的事件来检测此属性的值何时发生变化。

请注意,gatheringState 仅表示此传输的收集状态,而 RTCPeerConnection.iceGatheringState 表示整个连接的整体收集状态,包括整个连接上每个 RTCRtpSender 和每个 RTCRtpReceiver 使用的所有 RTCIceTransport

一个指示 ICE 代理当前候选收集过程状态的字符串

"new"

RTCIceTransport 是新创建的,尚未开始收集 ICE 候选。

"gathering"

传输正在收集候选。

"complete"

传输已完成 ICE 候选的收集,并将“候选结束”指示发送给了远程设备。除非发生 ICE 重启,否则传输不会再收集任何候选,届时收集过程将从头开始。

规范

规范
WebRTC:浏览器中的实时通信
# dom-icetransport-gatheringstate

浏览器兼容性