RTCInboundRtpStreamStats.totalPausesDuration add

Author: hamishwillee

files/en-us/web/api/rtcinboundrtpstreamstats/index.md

@@ -75,7 +75,8 @@ The statistics can be obtained by iterating the {{domxref("RTCStatsReport")}} re
 - {{domxref("RTCInboundRtpStreamStats.packetsDiscarded", "packetsDiscarded")}}
   - : A positive integer that indicates the total number of RTP packets discarded by the jitter buffer due to late or early-arrival.
 - {{domxref("RTCInboundRtpStreamStats.pauseCount", "pauseCount")}}
-  - : TBD.
+  - : A positive integer that indicates the number of video pauses experienced by this receiver.
+    _Undefined for audio streams._
 - {{domxref("RTCInboundRtpStreamStats.playoutId", "playoutId")}}
   - : TBD.
 - {{domxref("RTCInboundRtpStreamStats.remoteId", "remoteId")}}
@@ -100,7 +101,8 @@ The statistics can be obtained by iterating the {{domxref("RTCStatsReport")}} re
 - {{domxref("RTCInboundRtpStreamStats.totalInterFrameDelay", "totalInterFrameDelay")}}
   - : TBD.
 - {{domxref("RTCInboundRtpStreamStats.totalPausesDuration", "totalPausesDuration")}}
-  - : TBD.
+  - : A positive number indicating the total time that the stream has spent with paused video, in seconds.
+    _Undefined for audio streams._
 - {{domxref("RTCInboundRtpStreamStats.totalProcessingDelay", "totalProcessingDelay")}}
   - : TBD.
 - {{domxref("RTCInboundRtpStreamStats.totalSamplesDuration", "totalSamplesDuration")}}

files/en-us/web/api/rtcinboundrtpstreamstats/totalpausesduration/index.md

@@ -0,0 +1,34 @@
+---
+title: "RTCInboundRtpStreamStats: totalPausesDuration property"
+short-title: totalPausesDuration
+slug: Web/API/RTCInboundRtpStreamStats/totalPausesDuration
+page-type: web-api-instance-property
+browser-compat: api.RTCStatsReport.type_inbound-rtp.totalPausesDuration
+---
+
+{{APIRef("WebRTC")}}
+
+The **`totalPausesDuration`** property of the {{domxref("RTCRemoteInboundRtpStreamStats")}} dictionary indicates the total time that the video in this stream has spent paused, in seconds
+
+A pause is counted when a new frame is rendered more than 5 seconds after the last frame was rendered, and the time taken between frames is added to the `totalPausesDuration`.
+
+The average pause duration can be calculated using `totalPausesDuration / pauseCount`.
+
+> [!NOTE]
+> The property is undefined for audio streams.
+
+## Value
+
+An positive number, in seconds.
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- {{domxref("RTCInboundRtpStreamStats.pauseCount", "pauseCount")}}