在此页

• 句法
• 规范
• 浏览器兼容性
• 相关话题

只读 RTCIceTransport property state returns the current state of the ICE transport, so you can determine the state of ICE gathering in which the ICE agent currently is operating.

This differs from the gatheringState , which only indicates whether or not ICE gathering is currently underway.

句法

iceState = iceTransport.state;
					

值

A DOMString , whose value is one of those found in the enumerated type RTCIceTransportState , which indicates the stage of ICE gathering that's currently underway. Its value will be one of the following:

"new"

RTCIceTransport is currently gathering local candidates, or is waiting for the remote device to begin to transmit the remote candidates, or both. In this state, checking of candidates to look for those which might be acceptable has not yet begun.

"checking"

At least one remote candidate has been received, and the RTCIceTransport has begun examining pairings of remote and local candidates in order to attempt to identify viable pairs that could be used to establish a connection. Keep in mind that gathering of local candidates may still be underway, and, similarly, the remote device also may still be gathering candidates of its own.

"connected"

A viable candidate pair has been found and selected, and the RTCIceTransport has connected the two peers together using that pair. However, there are still candidates pairings to consider, and there may still be gathering underway on one or both of the two devices.

The transport may revert from the "connected" state to the "checking" state if either peer decides to cancel consent to use the selected candidate pair, and may revert to "disconnected" if there are no candidates left to check but one or both clients are still gathering candidates.

"completed"

The transport has finished gathering local candidates and has received a notification from the remote peer that no more candidates will be sent. In addition, all candidate pairs have been considered and a pair has been selected for use. If consent checks fail on all successful candidate pairs, the transport state will change to "failed" .

"disconnected"

The ICE agent has determined that connectivity has been lost for this RTCIceTransport . This is not a failure state (that's "failed" ). A value of "disconnected" means that a transient issue has occurred that has broken the connection, but that should resolve itself automatically without your code having to take any action. See The disconnected state 了解额外细节。

"failed"

RTCIceTransport has finished the gathering process, has received the "no more candidates" notification from the remote peer, and has finished checking pairs of candidates, without successfully finding a pair that is both valid and for which consent can be obtained. This is a terminal state, indicating that the connection cannot be achieved or maintained.

"closed"

The transport has shut down and is no longer responding to STUN requests.

规范

规范	状态	注释
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCIceTransportState' in that specification.	候选推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

No compatibility data found. Please contribute data for "api.RTCIceTransportState" (depth: 1) to the MDN 兼容性数据存储库 .

元数据

• 最后修改： Mar 18, 2019

相关话题

1. WebRTC API
2. RTCIceTransport
3. 特性

   1. component
   2. gatheringState
   3. getRemoteCandidates()
   4. ongatheringstatechange
   5. onselectedcandidatepairchange
   6. onstatechange
   7. role
   8. state
4. 方法

   1. getLocalCandidates()
   2. getLocalParameters()
   3. getSelectedCandidatePair()
5. Related pages for WebRTC

   1. MediaDevices.getUserMedia()
   2. Navigator.mediaDevices
   3. RTCCertificate
   4. RTCDTMFSender
   5. RTCDTMFToneChangeEvent
   6. RTCDataChannel
   7. RTCDataChannelEvent
   8. RTCDtlsTransport
   9. RTCErrorEvent
   10. RTCIceCandidate
   11. RTCPeerConnection
   12. RTCPeerConnectionIceErrorEvent
   13. RTCPeerConnectionIceEvent
   14. RTCRtpReceiver
   15. RTCRtpSender
   16. RTCRtpTransceiver
   17. RTCSctpTransport
   18. RTCSessionDescription
   19. RTCStatsEvent
   20. RTCStatsReport
   21. RTCTrackEvent