RTCRemoteOutboundRtpStreamStats
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since May 2021.
* Some parts of this feature may have varying levels of support.
TheRTCRemoteOutboundRtpStreamStats dictionary of theWebRTC API is used to report statistics from a remote endpoint about its outbound RTP stream.This will correspond to an inbound stream that is currently being received by the localRTCPeerConnection object.
The statistics can be obtained by iterating theRTCStatsReport returned byRTCPeerConnection.getStats() until you find a report with thetype ofremote-outbound-rtp.
In this article
Instance properties
>Remote outbound specific statistics
localIdOptionalA string which is used to find the local
RTCInboundRtpStreamStatsobject that shares the samesynchronization source (SSRC).remoteTimestampOptionalA
DOMHighResTimeStampspecifying the timestamp (on the remote device) at which the statistics in theRTCRemoteOutboundRtpStreamStatsobject were sent by the remote endpoint. This is different from thetimestamp; it represents the time at which the object's statistics were received or generated by the local endpoint.reportsSentOptionalExperimentalA positive integer indicating the total number ofRTCP Sender Report (SR) blocks sent for thissynchronization source (SSRC).
roundTripTimeMeasurementsOptionalExperimentalA positive number that represents the total number of valid round trip time measurements received for thissynchronization source (SSRC).
totalRoundTripTimeOptionalExperimentalA number indicating the cumulative sum of all round trip time measurements since the beginning of the session, in seconds.The average round trip time can be computed by dividing
totalRoundTripTimebyroundTripTimeMeasurements.
Sent RTP stream statistics
bytesSentOptionalA positive integer indicating the total number of bytes sent for this SSRC, including retransmissions.
packetsSentOptionalA positive integer indicating the total number of RTP packets sent for this SSRC, including retransmissions.
Common RTP stream statistics
codecIdOptionalA string that uniquely identifies the object that was inspected to produce the
RTCCodecStatsreport associated with thisRTP stream.kindA string indicating whether the
MediaStreamTrackassociated with the stream is an audio or a video track.ssrcA positive integer that identifies the synchronization source (SSRC) of the RTP packets in this stream.
transportIdOptionalA string that uniquely identifies the object that was inspected to produce the
RTCTransportStatsreport associated with this RTP stream.
Common instance properties
The following properties are common to all WebRTC statistics objects.
idA string that uniquely identifies the object that is being monitored to produce this set of statistics.
timestampA
DOMHighResTimeStampobject indicating the time at which the sample was taken for this statistics object.typeA string with the value
"remote-outbound-rtp", indicating the type of statistics that the object contains.
Usage notes
TheRTCRemoteOutboundRtpStreamStats object'sremoteTimestamp property provides statistics based on the received data's NTP timestamp taken from anRTCP Sender Report (SR) block.Be aware that the remote clock may not be synchronized with the local clock (either in current time or speed at which time elapses).
Specifications
| Specification |
|---|
| Identifiers for WebRTC's Statistics API> # dom-rtcstatstype-remote-outbound-rtp> |