RTCInboundRtpStreamStats: fecPacketsReceived property
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2022.
The fecPacketsReceived property of the RTCInboundRtpStreamStats dictionary indicates how many Forward Error Correction (FEC) packets have been received by this RTP receiver from the remote peer.
A FEC packet provides parity information that can be used to attempt to reconstruct RTP data packets which have been corrupted in transit.
Value
A positive integer value.
Description
This property indicates the total number of FEC packets which have been received from the remote peer during this RTP session.
Forward Error Correction uses an exclusive-or method to perform parity checks on the received data. By using the FEC parity information to attempt to reconstruct damaged packets, it is possible to avoid the need to retransmit damaged packets, which in turn helps to reduce lag, or the need to skip damaged frames entirely.
Note: This counter may also be incremented when FEC packets arrive in-band along with media content; this can happen with Opus, for example.
It's possible that a subset of the FEC packets which have been received were discarded instead of being used. This can happen if the packets covered by the FEC packets have already been received successfully or have already been reconstructed using a previously-received FEC packet. This may also happen if the FEC packet arrives outside the window of time in which the client will attempt to use it.
If you wish to know how many of the received packets were discarded, you can examine the value of fecPacketsDiscarded.
Specifications
| Specification |
|---|
| Identifiers for WebRTC's Statistics API # dom-rtcinboundrtpstreamstats-fecpacketsreceived |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
fecPacketsReceived in 'inbound-rtp' stats
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
See also
- RFC 5109 (RTP Payload Format for Generic Forward Error Correction)