就业培训     下载中心     Wiki     联络
登录   注册
  1. 首页
  2. Web API
  3. RTCPeerConnection
  4. RTCPeerConnection.connectionState

在此页

只读 connectionState 特性为 RTCPeerConnection interface indicates the current state of the peer connection by returning one of the string values specified by the enum RTCPeerConnectionState .

When this property's value changes, a connectionstatechange event is sent to the RTCPeerConnection 实例。

句法 

var connectionState = RTCPeerConnection.connectionState;

值

The current state of the connection, as a value from the enum RTCPeerConnectionState .

RTCPeerConnectionState enum

RTCPeerConnectionState enum defines string constants which describe states in which the RTCPeerConnection may be. These values are returned by the connectionState property. This state essentially represents the aggregate state of all ICE transports (which are of type RTCIceTransport or RTCDtlsTransport ) being used by the connection.

常量 描述
"new" At least one of the connection's ICE transports ( RTCIceTransport s or RTCDtlsTransport s) are in the "new" state, and none of them are in one of the following states: "connecting" , "checking" , "failed" ，或 "disconnected" , or all of the connection's transports are in the "closed" 状态。
"connecting" One or more of the ICE transports are currently in the process of establishing a connection; that is, their RTCIceConnectionState 是 "checking" or "connected" , and no transports are in the "failed" 状态。 <<< Make this a link once I know where that will be documented
"connected" Every ICE transport used by the connection is either in use (state "connected" or "completed" ) or is closed (state "closed" ); in addition, at least one transport is either "connected" or "completed" .
"disconnected" At least one of the ICE transports for the connection is in the "disconnected" state and none of the other transports are in the state "failed" , "connecting" ，或 "checking" .
"failed" One or more of the ICE transports on the connection is in the "failed" 状态。
"closed" RTCPeerConnection is closed.

This value was in the RTCSignalingState enum (and therefore found by reading the value of the signalingState ) property until the May 13, 2016 draft of the specification.

范例 

var pc = new RTCPeerConnection(configuration);
/* ... */
var connectionState = pc.connectionState;

规范

规范 状态 注释
WebRTC 1.0: Real-time Communication Between Browsers
The definition of 'RTCPeerConnection.connectionState' 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. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
connectionState Chrome 72 Edge 79 Firefox No IE No Opera No Safari 11 WebView Android 72 Chrome Android 72 Firefox Android No Opera Android No Safari iOS No Samsung Internet Android 11.0

图例

完整支持

完整支持

不支持

不支持

另请参阅

元数据

  • 最后修改：
  1. WebRTC API
  2. RTCPeerConnection
  3. 构造函数
    1. RTCPeerConnection()
  4. 特性
    1. canTrickleIceCandidates
    2. connectionState
    3. currentLocalDescription
    4. currentRemoteDescription
    5. getDefaultIceServers()
    6. iceConnectionState
    7. iceGatheringState
    8. localDescription
    9. onaddstream
    10. onconnectionstatechange
    11. ondatachannel
    12. onicecandidate
    13. oniceconnectionstatechange
    14. onicegatheringstatechange
    15. onidentityresult
    16. onidpassertionerror
    17. onidpvalidationerror
    18. onnegotiationneeded
    19. onpeeridentity
    20. onremovestream
    21. onsignalingstatechange
    22. ontrack
    23. peerIdentity
    24. pendingLocalDescription
    25. pendingRemoteDescription
    26. remoteDescription
    27. sctp
    28. signalingState
  5. 方法
    1. addIceCandidate()
    2. addStream()
    3. addTrack()
    4. close()
    5. createAnswer()
    6. createDataChannel()
    7. createOffer()
    8. generateCertificate()
    9. getConfiguration()
    10. getIdentityAssertion()
    11. getReceivers()
    12. getSenders()
    13. getStats()
    14. getStreamById()
    15. getTransceivers()
    16. removeStream()
    17. removeTrack()
    18. restartIce()
    19. setConfiguration()
    20. setIdentityProvider()
    21. setLocalDescription()
    22. setRemoteDescription()
  6. 事件
    1. addstream
    2. identityresult
    3. negotiationneeded
    4. removestream
    5. signalingstatechange
  7. 继承：
    1. EventTarget
  8. 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. RTCIceTransport
    12. RTCPeerConnectionIceErrorEvent
    13. RTCPeerConnectionIceEvent
    14. RTCRtpReceiver
    15. RTCRtpSender
    16. RTCRtpTransceiver
    17. RTCSctpTransport
    18. RTCSessionDescription
    19. RTCStatsEvent
    20. RTCStatsReport
    21. RTCTrackEvent