Specify fecBytesReceived (#762)

* Specify fecBytesReceived similar to how retransmittedBytesReceived is defined. Fixes #751 * sometimes FEC can use a different ssrc but still gets accounted for on the primary one
w3c · Jun 15, 2023 · 611d409 · 611d409
1 parent 6e9db1c
commit 611d409
Showing 1 changed file with 25 additions and 3 deletions.
diff --git a/webrtc-stats.html b/webrtc-stats.html
@@ -466,6 +466,13 @@ <h3>
               and {{RTCInboundRtpStreamStats/retransmittedBytesReceived}} counters of the relevant
               {{RTCInboundRtpStreamStats}} objects.
             </p>
+            <p>
+              FEC streams do not show up as separate
+              {{RTCInboundRtpStreamStats}} objects but affect the {{RTCReceivedRtpStreamStats/packetsReceived}},
+              {{RTCInboundRtpStreamStats/bytesReceived}}, {{RTCInboundRtpStreamStats/fecPacketsReceived}}
+              and {{RTCInboundRtpStreamStats/fecBytesReceived}} counters of the relevant
+              {{RTCInboundRtpStreamStats}} objects.
+            </p>
           </dd>
           <dt>
             <dfn>outbound-rtp</dfn>
@@ -984,6 +991,7 @@ <h3>
              DOMHighResTimeStamp  lastPacketReceivedTimestamp;
              unsigned long long   headerBytesReceived;
              unsigned long long   packetsDiscarded;
+             unsigned long long   fecBytesReceived;
              unsigned long long   fecPacketsReceived;
              unsigned long long   fecPacketsDiscarded;
              unsigned long long   bytesReceived;
@@ -1275,15 +1283,29 @@ <h2>
                   Calculated as defined in [[!RFC7002]] section 3.2 and Appendix A.a.
                 </p>
               </dd>
+              <dt>
+                <dfn>fecBytesReceived</dfn> of type <span class=
+                "idlMemberType">unsigned long long</span>
+              </dt>
+              <dd>
+                <p>
+                  Total number of RTP FEC bytes received for this <a>SSRC</a>, only including payload bytes.
+                  This is a subset of {{RTCInboundRtpStreamStats/bytesReceived}}. If a FEC mechanism that
+                  uses a different {{RTCRtpStreamStats/ssrc}} was negotiated, FEC packets are sent over a
+                  separate ssrc but is still accounted for here.
+                </p>
+              </dd>
               <dt>
                 <dfn>fecPacketsReceived</dfn> of type <span class=
                 "idlMemberType">unsigned long long</span>
               </dt>
               <dd>
                 <p>
-                  Total number of RTP FEC packets received for this <a>SSRC</a>. This counter can also be
-                  incremented when receiving FEC packets in-band with media packets (e.g., with
-                  Opus).
+                  Total number of RTP FEC packets received for this <a>SSRC</a>. If a FEC mechanism that
+                  uses a different {{RTCRtpStreamStats/ssrc}} was negotiated, FEC packets are sent over a
+                  separate ssrc but is still accounted for here.
+                  This counter can also be incremented when receiving FEC packets in-band with media packets
+                  (e.g., with Opus).
                 </p>
               </dd>
               <dt>