RTCRemoteInboundRtpStreamStats
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
The RTCRemoteInboundRtpStreamStats
dictionary of the WebRTC API is used to report statistics from the remote endpoint about a particular incoming RTP stream.
These will correspond to an outgoing RTP stream at the local end of the RTCPeerConnection
.
The statistics can be obtained by iterating the RTCStatsReport
returned by RTCPeerConnection.getStats()
or RTCRtpReceiver.getStats()
until you find a report with the type
of remote-inbound-rtp
.
Instance properties
Remote inbound specific statistics
fractionLost
Optional-
A number indicating the fraction of packets lost for this SSRC since the last sender or receiver report.
localId
Optional-
A string that is used to find the local
RTCOutboundRtpStreamStats
object that shares the same synchronization source (SSRC). roundTripTime
Optional-
A number that indicates the estimated round trip time (RTT) for this SSRC, in seconds. This property will not exist until valid RTT data has been received.
roundTripTimeMeasurements
Optional-
A positive integer indicating the total number of valid round trip time measurements received for this synchronization source (SSRC).
totalRoundTripTime
Optional-
A 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
totalRoundTripTime
byroundTripTimeMeasurements
.
Received RTP stream statistics
jitter
Optional-
A number indicating the packet jitter for this synchronization source, measured in seconds.
packetsLost
Optional-
An integer indicating the total number of RTP packets lost for this SSRC, as measured at the remote endpoint. This value can be negative if duplicate packets were received.
packetsReceived
Optional Experimental-
A positive integer indicating the total number of RTP packets received for this SSRC, including retransmissions.
Common RTP stream statistics
codecId
Optional-
A string that uniquely identifies the object that was inspected to produce the
RTCCodecStats
object associated with this RTP stream. kind
-
A string indicating whether the
MediaStreamTrack
associated with the stream is an audio or a video track. ssrc
-
A positive integer that identifies the SSRC of the RTP packets in this stream.
transportId
Optional-
A string that uniquely identifies the object which was inspected to produce the
RTCTransportStats
object 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
DOMHighResTimeStamp
object indicating the time at which the sample was taken for this statistics object. type
-
A string with the value
"inbound-rtp"
, indicating the type of statistics that the object contains.
Examples
Given a variable peerConnection
that is an instance of an RTCPeerConnection
, the code below uses await
to wait for the statistics report, and then iterates it using RTCStatsReport.forEach()
.
It then filters the dictionaries for just those reports that have the type of remote-inbound-rtp
and logs the result.
const stats = await myPeerConnection.getStats();
stats.forEach((report) => {
if (report.type === "remote-inbound-rtp") {
console.log("Remote Inbound RTP Stream Stats:");
console.log(`id: ${report.id}`);
console.log(`timestamp: ${report.timestamp}`);
console.log(`transportId: ${report.transportId}`);
console.log(`ssrc: ${report.ssrc}`);
console.log(`kind: ${report.kind}`);
console.log(`codecId: ${report.codecId}`);
console.log(`packetsReceived: ${report.packetsReceived}`);
console.log(`packetsLost: ${report.packetsLost}`);
console.log(`jitter: ${report.jitter}`);
console.log(`totalRoundTripTime: ${report.totalRoundTripTime}`);
console.log(
`roundTripTimeMeasurements: ${report.roundTripTimeMeasurements}`,
);
console.log(`roundTripTime: ${report.roundTripTime}`);
console.log(`localId: ${report.localId}`);
console.log(`fractionLost: ${report.fractionLost}`);
}
});
Specifications
Specification |
---|
Identifiers for WebRTC's Statistics API # dom-rtcstatstype-remote-inbound-rtp |
Browser compatibility
BCD tables only load in the browser