RTCInboundRtpStreamStats.fecPacketsReceived

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. An FEC packet provides parity information which can be used to attempt to reconstruct RTP data packets which have been corrupted in transit.

Syntax

var fecPacketsReceived = rtcInboundRtpStreamStats.fecPacketsReceived;

Value

An unsigned integer value which 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.

Usage notes

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

See also

  • RFC 5109 (RTP Payload Format for Generic Forward Error Correction)