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

在此页

The WebRTC RTCIceCandidatePairStats dictionary reports statistics which provide insight into the quality and performance of an RTCPeerConnection while connected and configured as described by the specified pair of ICE candidates.

若 RTCStats -based object's type is candidate-pair , it's an RTCIceCandidatePairStats 对象。

特性

RTCIceCandidatePairStats is based upon RTCStats and inherits its properties. In addition, it adds the following new properties:

availableIncomingBitrate 可选
Provides an informative value representing the available inbound capacity of the network by reporting the total number of bits per second available for all of the candidate pair's incoming RTP streams. This does not take into account the size of the IP overhead, nor any other transport layers such as TCP or UDP .
availableOutgoingBitrate 可选
Provides an informative value representing the available outbound capacity of the network by reporting the total number of bits per second available for all of the candidate pair's outoing RTP streams. This does not take into account the size of the IP overhead, nor any other transport layers such as TCP or UDP .
bytesReceieved 可选

The total number of payload bytes received (that is, the total number of bytes received minus any headers, padding, or other administrative overhead) on this candidate pair so far.

bytesSent 可选

The total number of payload bytes sent (that is, the total number of bytes sent minus any headers, padding, or other administrative overhead) so far on this candidate pair.

circuitBreakerTriggerCount 可选

An integer value indicating the number of times the circuit-breaker has been triggered for this particular 5-tuple (the set of five values comprising a TCP connection: source IP address, source port number, destination IP address, destination port number, and protocol). The circuit breaker is triggered whenever a connection times out or otherwise needs to be automatically aborted.

consentExpiredTimestamp 可选
DOMHighResTimeStamp value indicating the time at which the most recent STUN binding response expired. This value is undefined if no valid STUN binding responses have been sent on the candidate pair; this can only happen if responsesReceived 为 0。
consentRequestsSent 可选

The total number of consent requests that have been sent on this candidate pair.

currentRoundTripTime 可选

A floating-point value indicating the total time, in seconds, that elapsed elapsed between the most recently-sent STUN request and the response being received. This may be based upon requests that were involved in confirming permission to open the connection.

firstRequestTimestamp 可选
DOMHighResTimeStamp value which specifies the time at which the first STUN request was sent from the local peer to the remote peer for this candidate pair.
lastPacketReceivedTimestamp 可选
DOMHighResTimeStamp value indicating the time at which the last packet was received by the local peer from the remote peer for this candidate pair. Timestamps are not recorded for STUN packets.
lastPacketSentTimestamp 可选
DOMHighResTimeStamp value indicating the time at which the last packet was sent from the local peer to the remote peer for this candidate pair. Timestamps are not recorded for STUN packets.
lastRequestTimestamp 可选
DOMHighResTimeStamp value which specifies the time at which the last (most recent) STUN request was sent from the local peer to the remote peer for this candidate pair.
lastResponseTimestamp 可选
DOMHighResTimeStamp value that specifies the time at which the last (most recent) STUN response was received by the local candidate from the remote candidate in this pair.
localCandidateId 可选
The unique ID string corresponding to the RTCIceCandidate from the data included in the RTCIceCandidateStats object providing statistics for the candidate pair's local candidate.
nominated 可选
A Boolean value which, if true , indicates that the candidate pair described by this object is one which has been proposed for use, and will be (or was) used if its priority is the highest among the nominated candidate pairs. See RFC 5245, section 7.1.3.2.4 了解细节。
packetsReceived 可选

The total number of packets received on this candidate pair.

packetsSent 可选

The total number of packets sent on this candidate pair.

remoteCandidateId 可选
The unique ID string corresponding to the remote candidate from which data was taken to construct the RTCIceCandidateStats object describing the remote end of the connection.
requestsReceived 可选

The total number of connectivity check requests that have been received, including retransmissions. This value includes both connectivity checks and STUN consent checks.

requestsSent 可选
The total number of connectivity check requests that have been sent, not including retransmissions.
responsesReceived 可选

The total number of connectivity check responses that have been received.

responsesSent 可选

The total number of connectivity check responses that have been sent. This includes both connectivity check requests and STUN consent requests.

retransmissionsReceived 可选
The total number of times connectivity check request retransmissions were received. A retransmission is a connectivity check request whose TRANSACTION_TRANSMIT_COUNTER attribute's req field is greater than 1.
retransmissionsSent 可选

The total number of times connectivity check request retransmissions were sent.

state 可选
RTCStatsIceCandidatePairState object which indicates the state of the connection between the two candidates.
totalRoundTripTime 可选
A floating-point value indicating the total time, in seconds, that has elapsed between sending STUN requests and receiving responses to them, for all such requests made to date on this candidate pair. This includes botyh connectivity check and consent check requests. You can compute the average round trip time (RTT) by dividing this value by responsesReceived .
transportId 可选
DOMString that uniquely identifies the RTCIceTransport that was inspected to obtain the transport-related statistics (as found in RTCTransportStats ) used in generating this object.

过时特性

The following properties have been removed from the specification and should no longer be used. You should update any existing code to avoid using them as soon as is practical. Check the 兼容性表格 for details on which browsers support them and in which versions.

priority 可选

An integer value indicating the candidate pair's priority.

readable 可选

A Boolean value indicating whether or not data can be sent over the connection described by the candidate pair.

writable 可选

A Boolean value indicating whether or not data can be received on the connection described by the candidate pair.

非标特性

selected 可选
A Firefox-specific Boolean value which is true if the candidate pair described by this object is the one currently in use. The spec-compliant way to determine the selected candidate pair is to look for a stats object of type transport , which is an RTCTransportStats object. That object's selectedCandidatePairId property indicates whether or not the specified transport is the one being used.

用法注意事项

The currently-active ICE candidate pair—if any—can be obtained by calling the RTCIceTransport 方法 getSelectedCandidatePair() , which returns an RTCIceCandidatePair object, or null if there isn't a pair selected. The active candidate pair describes the current configuration of the two ends of the RTCPeerConnection .

Any candidate pair that isn't the active pair of candidates for a transport gets deleted if the RTCIceTransport performs an ICE restart, at which point the state of the ICE transport returns to new and negotiation starts once again. For more information, see ICE restart in Lifetime of a WebRTC session .

范例

This example computes the average time elapsed between connectivity checks if the RTCStats 对象 rtcStats 是 RTCIceCandidatePairStats 对象。 

if (rtcStats && rtcStats.type === "candidate-pair") {
  let elapsed = (rtcStats.lastRequestTimestamp - rtcStats.firstRequestTimestamp)
                  / rtcStats.requestsSent;
  log("Average time between ICE connectivity checks: " + elapsed + " ms.");
}

The code begins by looking at rtcStats to see if its type is candidate-pair . If it is, then we know that rtcStats is in fact an RTCIceCandidatePairStats object. If so, we compute the average time elapsed between STUN connectivity checks and log that information.

规范

规范 状态 注释
Identifiers for WebRTC's Statistics API
The definition of 'RTCIceCandidatePairStats' 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
RTCIceCandidatePairStats Chrome 56 Edge ≤79 Firefox 29 IE No Opera ? Safari ? WebView Android 56 Chrome Android 56 Firefox Android 29 Opera Android ? Safari iOS ? Samsung Internet Android 6.0
availableIncomingBitrate Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android Yes Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
availableOutgoingBitrate Chrome Yes Edge ≤79 Firefox No IE No Opera ? Safari ? WebView Android Yes Chrome Android Yes Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android Yes
bytesReceived Chrome Yes Edge ≤79 Firefox 56 IE No Opera ? Safari ? WebView Android Yes Chrome Android Yes Firefox Android 56 Opera Android ? Safari iOS ? Samsung Internet Android Yes
bytesSent Chrome Yes Edge ≤79 Firefox 56 IE No Opera ? Safari ? WebView Android Yes Chrome Android Yes Firefox Android 56 Opera Android ? Safari iOS ? Samsung Internet Android Yes
circuitBreakerTriggerCount Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
consentExpiredTimestamp Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
consentRequestsSent Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
currentRoundTripTime Chrome 71
71
Yes Alternate Name
Alternate Name Uses the non-standard name: currentRtt
Edge ≤79
≤79
≤79 Alternate Name
Alternate Name Uses the non-standard name: currentRtt
Firefox No IE No Opera ? Safari ? WebView Android Yes Chrome Android 71
71
Yes Alternate Name
Alternate Name Uses the non-standard name: currentRtt
Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android 10.0
10.0
Yes Alternate Name
Alternate Name Uses the non-standard name: currentRtt
firstRequestTimeStamp Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
lastPacketReceivedTimestamp Chrome No Edge No Firefox 56 IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android 56 Opera Android ? Safari iOS ? Samsung Internet Android No
lastPacketSentTimestamp Chrome No Edge No Firefox 56 IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android 56 Opera Android ? Safari iOS ? Samsung Internet Android No
lastReponseTimestamp Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
lastRequestTimestamp Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
localCandidateId Chrome No Edge No Firefox 29 IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android 29 Opera Android ? Safari iOS ? Samsung Internet Android No
nominated Chrome No Edge No Firefox 56 IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android 56 Opera Android ? Safari iOS ? Samsung Internet Android No
packetsReceived Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
packetsSent Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
priority 非标 Chrome No Edge No Firefox 42
42
29 Alternate Name
Alternate Name Uses the non-standard name: mozPriority
IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android 42
42
29 Alternate Name
Alternate Name Uses the non-standard name: mozPriority
Opera Android ? Safari iOS ? Samsung Internet Android No
readable 非标 Chrome No Edge No Firefox 56 IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android 56 Opera Android ? Safari iOS ? Samsung Internet Android No
remoteCandidateId Chrome No Edge No Firefox 29 IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android 29 Opera Android ? Safari iOS ? Samsung Internet Android No
requestsReceived Chrome Yes Edge ≤79 Firefox No IE No Opera ? Safari ? WebView Android Yes Chrome Android Yes Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android Yes
requestsSent Chrome Yes Edge ≤79 Firefox No IE No Opera ? Safari ? WebView Android Yes Chrome Android Yes Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android Yes
responsesReceived Chrome Yes Edge ≤79 Firefox No IE No Opera ? Safari ? WebView Android Yes Chrome Android Yes Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android Yes
responsesSent Chrome Yes Edge ≤79 Firefox No IE No Opera ? Safari ? WebView Android Yes Chrome Android Yes Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android Yes
retransmissionsReceived Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
retransmissionsSent Chrome No Edge No Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android No
state Chrome No Edge No Firefox 29 IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android 29 Opera Android ? Safari iOS ? Samsung Internet Android No
totalRoundTripTime Chrome 71
71
Yes Alternate Name
Alternate Name Uses the non-standard name: totalRtt
Edge ≤79
≤79
≤79 Alternate Name
Alternate Name Uses the non-standard name: totalRtt
Firefox No IE No Opera ? Safari ? WebView Android No Chrome Android 71
71
Yes Alternate Name
Alternate Name Uses the non-standard name: totalRtt
Firefox Android No Opera Android ? Safari iOS ? Samsung Internet Android 10.0
10.0
Yes Alternate Name
Alternate Name Uses the non-standard name: totalRtt
transportId Chrome No Edge No Firefox 56
56
29 Alternate Name
Alternate Name Uses the non-standard name: componentId
IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android 56
56
29 Alternate Name
Alternate Name Uses the non-standard name: componentId
Opera Android ? Safari iOS ? Samsung Internet Android No
writable 非标 Chrome Yes
Yes
Chrome does not currently use the specification's algorithm to determine the value of writable ; it may not match the behavior of other browsers.
Edge ≤79
≤79
Edge does not currently use the specification's algorithm to determine the value of writable ; it may not match the behavior of other browsers.
Firefox 56 IE No Opera ? Safari ? WebView Android Yes Chrome Android Yes
Yes
Chrome does not currently use the specification's algorithm to determine the value of writable ; it may not match the behavior of other browsers.
Firefox Android 56 Opera Android ? Safari iOS ? Samsung Internet Android Yes
Yes
Samsung Internet does not currently use the specification's algorithm to determine the value of writable ; it may not match the behavior of other browsers.

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

非标。预期跨浏览器支持较差。

非标。预期跨浏览器支持较差。

见实现注意事项。

使用非标名称。

元数据

  • 最后修改：
  1. WebRTC API
  2. RTCIceCandidatePairStats
  3. 特性
    1. availableOutgoingBitrate
    2. bytesReceived
    3. circuitBreakerTriggerCount
    4. consentExpiredTimestamp
    5. firstRequestTimestamp
    6. lastPacketReceivedTimestamp
    7. lastPacketSentTimestamp
    8. lastRequestTimestamp
    9. lastResponseTimestamp
    10. localCandidateId
    11. nominated
    12. packetsReceived
    13. packetsSent
    14. priority
    15. readable
    16. remoteCandidateId
    17. requestsReceived
    18. requestsSent
    19. responsesReceived
    20. responsesSent
    21. retransmissionsReceived
    22. state
    23. totalRoundTripTime
    24. transportId
    25. writable
  4. 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. RTCPeerConnection
    13. RTCPeerConnectionIceErrorEvent
    14. RTCPeerConnectionIceEvent
    15. RTCRtpReceiver
    16. RTCRtpSender
    17. RTCRtpTransceiver
    18. RTCSctpTransport
    19. RTCSessionDescription
    20. RTCStatsEvent
    21. RTCStatsReport
    22. RTCTrackEvent

版权所有  © 2014-2026 乐数软件    

工业和信息化部： 粤ICP备14079481号-1