RTCRemoteOutboundRtpStreamStats
The RTCRemoteOutboundRtpStreamStats dictionary of the WebRTC API is used to report statistics from remote endpoint of its outbound RTP stream, which corresponds to an inbound stream that is currently received by an RTCPeerConnection object.
The statistics can be obtained by iterating the RTCStatsReport returned by RTCPeerConnection.getStats() until you find a report with the type of remote-outbound-rtp.
Instance properties
Remote outbound specific properties
localIdOptional-
A string which is used to find the local
RTCInboundRtpStreamStatsobject which shares the same Synchronization Source (SSRC). remoteTimestampOptional-
A
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. reportsSentOptional Experimental-
A positive integer indicating the total number of RTCP Sender Report (SR) blocks sent for this synchronization source (SSRC).
roundTripTimeMeasurementsOptional Experimental-
A positive integer indicating the total number of RTCP Sender Report (SR) blocks received for this synchronization source (SSRC) that contain a DLRR (Delay Since last Receiver Report) block that can be used to derive a valid round trip time. This counter will not increment if the round trip time cannot be calculated.
totalRoundTripTimeOptional Experimental-
A real 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.
RTP sent-stream stat properties
bytesSentOptional-
A positive integer indicating the total number of bytes sent for this SSRC, including retransmissions.
packetsSentOptional-
A positive integer indicating the total number of RTP packets sent for this SSRC, including retransmissions.
RTP stream-stat properties
codecIdOptional-
A string that uniquely identifies the object that was inspected to produce the
RTCCodecStatsreport associated with this RTP stream. kind-
A string whose value is
"audio"if the associatedMediaStreamTrackis audio-only or"video"if the track contains video. This value will match that of the media type indicated byRTCCodecStats.codec, as well as the track'skindproperty. Previously calledmediaType. ssrc-
A positive integer that identifies the synchronization source (SSRC) of the RTP stream that is being sent to the remote endpoint. This value is generated per the RFC 3550 specification.
transportIdOptional-
A 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.
id-
A string that uniquely identifies the object that is being monitored to produce this set of statistics.
timestamp-
A
DOMHighResTimeStampobject indicating the time at which the sample was taken for this statistics object. type-
A string with the value
"remote-outbound-rtp", indicating the type of statistics that the object contains.
Usage notes
The RTCRemoteOutboundRtpStreamStats object's remoteTimestamp property provides statistics based on the received data's NTP timestamp taken from an RTCP 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 |
Browser compatibility
BCD tables only load in the browser