大网数据广告活动
Web 标准与前端开发

RTCIceTransport: gatheringState property

· 52CE 我爱测

The **`gatheringState`** read-only property of the RTCIceTransport interface returns a string that indicates the current gathering state of the ICE agent for this transport: `"new"`, `"gathering"`, or `"complete"`.

WebRTC

The gatheringState read-only property of the RTCIceTransport interface returns a string that indicates the current gathering state of the ICE agent for this transport: "new", "gathering", or "complete".

You can detect when the value of this property changes by watching for an event of type RTCIceTransport/gatheringstatechange_event.

Note that gatheringState represents the gathering state of just this transport, while RTCPeerConnection.iceGatheringState represents the overall gathering state of the whole connection, including every RTCIceTransport used by every RTCRtpSender and every RTCRtpReceiver on the entire connection.

Value

A string that indicates the current state of the ICE agent's candidate gathering process:

  • "new"
    • : The RTCIceTransport is newly created and has not yet started to gather ICE candidates.
  • "gathering"
    • : The transport is in the process of gathering candidates.
  • "complete"
    • : The transport has finished gathering ICE candidates and has sent the end-of-candidates indicator to the remote device. The transport won't gather any further candidates unless an ICE restart occurs, at which point the gathering process starts over from scratch.

Specifications

Browser compatibility

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。