Ff142 RTCInboundRtpStreamStats fixes #40495

hamishwillee · 2025-07-22T06:15:44Z

This fixes up the RTCInboundRtpStreamStats to match the BCD as per FF142, which adds support for some more properties.

RTC is hard IMO, and the specs are not easy. A lot of this is nothing more than the spec. A little of it is. For example, I did learn some interesting things about the jitter buffer and associated stats in https://webrtchacks.com/how-webrtcs-neteq-jitter-buffer-provides-smooth-audio/

Contributes to mdn/mdn#384

Related docs work can be tracked in #40478

Removals (not in BCD): averageRtcpInterval, firCount, lastPacketReceivedTimestamp, packetsDuplicated, packetsFailedDecryption, perDscpPacketsReceived, pliCount, receiverId, sliCount,

github-actions · 2025-07-22T06:17:39Z

Preview URLs (47 pages)

Flaws (7)

Note! 42 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats
Title: RTCInboundRtpStreamStats
Flaw count: 1

macros:
- Can't resolve /en-US/docs/Web/API/RTCAudioPlayoutStats

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/playoutId
Title: RTCInboundRtpStreamStats: playoutId property
Flaw count: 2

macros:
- Can't resolve /en-US/docs/Web/API/RTCAudioPlayoutStats/id
- Can't resolve /en-US/docs/Web/API/RTCAudioPlayoutStats

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/qpSum
Title: RTCInboundRtpStreamStats: qpSum property
Flaw count: 2

macros:
- Can't resolve /en-US/docs/Web/API/RTCReceivedRtpStreamStats/framesDecoded
- Can't resolve /en-US/docs/Web/API/RTCSentRtpStreamStats/framesEncoded

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/totalInterFrameDelay
Title: RTCInboundRtpStreamStats: totalInterFrameDelay property
Flaw count: 1

macros:
- Can't resolve /en-US/docs/Web/API/RTCInboundRtpStreamStats/framesRendered

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/totalSquaredInterFrameDelay
Title: RTCInboundRtpStreamStats: totalSquaredInterFrameDelay property
Flaw count: 1

macros:
- Can't resolve /en-US/docs/Web/API/RTCInboundRtpStreamStats/framesRendered

External URLs (12)

URL: /en-US/docs/Glossary/Jitter
Title: Jitter

https://en.wikipedia.org/wiki/Packet_loss_concealment (1 time) (Note! This may be a new URL 👀)
https://webrtchacks.com/how-webrtcs-neteq-jitter-buffer-provides-smooth-audio/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/audioLevel
Title: RTCInboundRtpStreamStats: audioLevel property

https://en.wikipedia.org/wiki/DBFS (1 time) (Note! This may be a new URL 👀)
https://en.wikipedia.org/wiki/Sound_pressure (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/concealedSamples
Title: RTCInboundRtpStreamStats: concealedSamples property

https://en.wikipedia.org/wiki/Packet_loss_concealment (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/concealmentEvents
Title: RTCInboundRtpStreamStats: concealmentEvents property

https://en.wikipedia.org/wiki/Packet_loss_concealment (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/estimatedPlayoutTimestamp
Title: RTCInboundRtpStreamStats: estimatedPlayoutTimestamp property

https://en.wikipedia.org/wiki/Network_Time_Protocol (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/insertedSamplesForDeceleration
Title: RTCInboundRtpStreamStats: insertedSamplesForDeceleration property

https://webrtchacks.com/how-webrtcs-neteq-jitter-buffer-provides-smooth-audio/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/qpSum
Title: RTCInboundRtpStreamStats: qpSum property

https://en.wikipedia.org/wiki/Quantization (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/removedSamplesForAcceleration
Title: RTCInboundRtpStreamStats: removedSamplesForAcceleration property

https://webrtchacks.com/how-webrtcs-neteq-jitter-buffer-provides-smooth-audio/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/RTCInboundRtpStreamStats/silentConcealedSamples
Title: RTCInboundRtpStreamStats: silentConcealedSamples property

https://en.wikipedia.org/wiki/Comfort_noise (1 time) (Note! This may be a new URL 👀)
https://en.wikipedia.org/wiki/Packet_loss_concealment (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-08-15 01:41:41)

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

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

github-actions · 2025-07-31T00:58:03Z

This pull request has merge conflicts that must be resolved before it can be merged.

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

hamishwillee · 2025-08-04T06:02:09Z

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

+Speeding up or slowing down the audio (as tracked with {{domxref("RTCInboundRtpStreamStats.insertedSamplesForDeceleration","insertedSamplesForDeceleration")}}) may result in audible warbling or other distortion.
+The totals at the end of the call also give you some indication of how many samples or seconds were impacted, and `removedSamplesForAcceleration` can be correlated with {{domxref("RTCInboundRtpStreamStats/totalSamplesReceived","totalSamplesReceived")}} to get a relative measure of acceleration.
+Logging `insertedSamplesForDeceleration` and `removedSamplesForAcceleration` in timeslices can be helpful for isolating the times at which the problem occurred and you can then correlate other metrics in the same timeslice to determine likely causes.


This was a hard one to get info about. The information here comes from the discussion in w3c/webrtc-stats#809 (comment) - it is duplicated in the decel. property.

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

RTCInboundRtpStreamStats/receiverId - delete/redirect RTCInboundRtpStreamStats.packetsFailedDecryption - delete/redirect RTCInboundRtpStreamStats/packetsDuplicated - delete/redirect RTCInboundRtpStreamStats/perDscpPacketsReceived - delete/redirect RTCInboundRtpStreamStats.sliCount - delete/redirect

hamishwillee · 2025-08-10T23:22:29Z

@wbamberg Would be great to get a review when you have time. I'm away for a few weeks after next week so hoping to have it ready before then.

wbamberg · 2025-08-11T23:52:14Z

@wbamberg Would be great to get a review when you have time. I'm away for a few weeks after next week so hoping to have it ready before then.

Sorry, looking now.

wbamberg

I had a few little comments, but since I'll be away for the rest of this week, and I think you're away after the end of the week, I'll approve this so you can merge after making the updates, assuming you think they are worth doing. I think most of them should be pretty clear cut.

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

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

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

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

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

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

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

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

Co-authored-by: wbamberg <[email protected]>

hamishwillee · 2025-08-15T01:41:08Z

Thanks very much for the review and approval @wbamberg - appreciate how "not fun" it is. All the suggestions made sense and have been integrated.

On the plus side, the stats todo list is starting to look a little less horrible mdn/mdn#384 (comment)

* RTCInboundRtpStreamStats - update to only supported members (placholders) * RTCInboundRtpStreamStats.keyFramesDecoded - add * RTCInboundRtpStreamStats.headerBytesReceived - add * RTCInboundRtpStreamStats.frameHeight/.frameWidth - add * RTCInboundRtpStreamStats.framesPerSecond - add * RTCInboundRtpStreamStats.framesReceived - add * RTCInboundRtpStreamStats.audioLevel - add * RTCInboundRtpStreamStats.totalAudioEnergy * RTCInboundRtpStreamStats.concealedSamples * RTCInboundRtpStreamStats.concealmentEvents * RTCInboundRtpStreamStats.estimatedPlayoutTimestamp * RTCInboundRtpStreamStats.silentConcealedSamples * RTCInboundRtpStreamStats.framesAssembledFromMultiplePackets add * RTCInboundRtpStreamStats.totalAssemblyTime add * RTCInboundRtpStreamStats.freezeCount add * RTCInboundRtpStreamStats.insertedSamplesForDeceleration add * RTCInboundRtpStreamStats.jitterBufferDelay add * Improve inserted/removedSamples * Jitter related stats * RTCInboundRtpStreamStats.packetsDiscarded add * RTCInboundRtpStreamStats.packetsLost add * RTCInboundRtpStreamStats.packetsReceived add * RTCInboundRtpStreamStats.pauseCount add * RTCInboundRtpStreamStats.totalPausesDuration add * RTCInboundRtpStreamStats.playoutId add * RTCInboundRtpStreamStats.totalDecodeTime add * RTCInboundRtpStreamStats tidy a few * Update files/en-us/web/api/rtcinboundrtpstreamstats/playoutid/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * totalFreezesDuration - add * totalInterFrameDelay - add * totalProcessingDelay - add * totalSamplesDuration - add * totalSamplesReceived - add * totalSquaredInterFrameDelay - add * trackIdentifier - add * accel/decel fixes * RTCInboundRtpStreamStats.averageRtcpInterval - delete/redirect RTCInboundRtpStreamStats/receiverId - delete/redirect RTCInboundRtpStreamStats.packetsFailedDecryption - delete/redirect RTCInboundRtpStreamStats/packetsDuplicated - delete/redirect RTCInboundRtpStreamStats/perDscpPacketsReceived - delete/redirect RTCInboundRtpStreamStats.sliCount - delete/redirect * Try revert screwed up _wikihistory.json * playoutid fix * Apply suggestions from code review Co-authored-by: wbamberg <[email protected]> --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: wbamberg <[email protected]>

github-actions bot added the Content:WebAPI Web API docs label Jul 22, 2025

hamishwillee mentioned this pull request Jul 22, 2025

WebRTC stats - update to spec and remove dictionaries mdn/mdn#384

Open

3 tasks

github-actions bot added the size/m [PR only] 51-500 LoC changed label Jul 22, 2025

hamishwillee mentioned this pull request Jul 22, 2025

[WebAPI] Implement some missing stats in RTCInboundRtpStreamStats #40478

Closed

8 tasks

github-actions bot added size/l [PR only] 501-1000 LoC changed and removed size/m [PR only] 51-500 LoC changed labels Jul 22, 2025

hamishwillee changed the title ~~Ff142 rtcinboundrtpstreamstats fixes~~ Ff142 RTCInboundRtpStreamStats fixes Jul 22, 2025

hamishwillee removed the size/l [PR only] 501-1000 LoC changed label Jul 22, 2025

github-actions bot added the size/l [PR only] 501-1000 LoC changed label Jul 22, 2025

hamishwillee force-pushed the ff142_rtcinboundrtpstreamstats_fixes branch from 51a0ae6 to c05ddd2 Compare July 25, 2025 06:20

github-actions bot added size/xl [PR only] >1000 LoC changed and removed size/l [PR only] 501-1000 LoC changed labels Jul 25, 2025

hamishwillee mentioned this pull request Jul 28, 2025

insertedSamplesForDeceleration and removedSamplesForAcceleration of inbound stats confusing w3c/webrtc-stats#809

Open

hamishwillee commented Jul 28, 2025

View reviewed changes

files/en-us/web/api/rtcinboundrtpstreamstats/insertedsamplesfordeceleration/index.md Show resolved Hide resolved

hamishwillee commented Jul 28, 2025

View reviewed changes

files/en-us/web/api/rtcinboundrtpstreamstats/removedsamplesforacceleration/index.md Show resolved Hide resolved

hamishwillee force-pushed the ff142_rtcinboundrtpstreamstats_fixes branch from 11836de to 253ee5f Compare July 29, 2025 07:17

github-actions bot added Content:Glossary Glossary entries merge conflicts 🚧 [PR only] labels Jul 29, 2025

github-actions bot reviewed Aug 4, 2025

View reviewed changes

files/en-us/web/api/rtcinboundrtpstreamstats/playoutid/index.md Outdated Show resolved Hide resolved

hamishwillee force-pushed the ff142_rtcinboundrtpstreamstats_fixes branch from 7b68da0 to c326b31 Compare August 4, 2025 02:38

github-actions bot removed the merge conflicts 🚧 [PR only] label Aug 4, 2025

hamishwillee commented Aug 4, 2025

View reviewed changes

hamishwillee marked this pull request as ready for review August 4, 2025 06:02

hamishwillee requested review from a team as code owners August 4, 2025 06:02

hamishwillee requested review from sideshowbarker and wbamberg and removed request for a team August 4, 2025 06:02

hamishwillee and others added 19 commits August 11, 2025 09:21

RTCInboundRtpStreamStats.packetsLost add

0ba7102

RTCInboundRtpStreamStats.packetsReceived add

a03b743

RTCInboundRtpStreamStats.pauseCount add

6a6666c

RTCInboundRtpStreamStats.totalPausesDuration add

23dcada

RTCInboundRtpStreamStats.playoutId add

5de7a40

RTCInboundRtpStreamStats.totalDecodeTime add

91798f8

RTCInboundRtpStreamStats tidy a few

6e23eac

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

fe45435

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

totalFreezesDuration - add

4188083

totalInterFrameDelay - add

d95f23c

totalProcessingDelay - add

4725b87

totalSamplesDuration - add

b38e9c6

totalSamplesReceived - add

38a20c2

totalSquaredInterFrameDelay - add

c308c65

trackIdentifier - add

bace0a9

accel/decel fixes

16821b8

Try revert screwed up _wikihistory.json

f2fce13

playoutid fix

5ad7997

hamishwillee force-pushed the ff142_rtcinboundrtpstreamstats_fixes branch from ab64e7d to 5ad7997 Compare August 10, 2025 23:21

sideshowbarker removed request for a team and sideshowbarker August 11, 2025 18:29

wbamberg approved these changes Aug 13, 2025

View reviewed changes

Apply suggestions from code review

91c668a

Co-authored-by: wbamberg <[email protected]>

hamishwillee merged commit 9dd28ca into mdn:main Aug 15, 2025
8 checks passed

wbamberg mentioned this pull request Aug 25, 2025

Editorial review: Document RTCEncodedAudioFrame.getMetadata() audioLevel return property #40835

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Ff142 RTCInboundRtpStreamStats fixes #40495

Ff142 RTCInboundRtpStreamStats fixes #40495

Uh oh!

hamishwillee commented Jul 22, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Jul 22, 2025 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Jul 31, 2025

Uh oh!

Uh oh!

hamishwillee Aug 4, 2025

Uh oh!

hamishwillee commented Aug 10, 2025

Uh oh!

wbamberg commented Aug 11, 2025

Uh oh!

wbamberg left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

hamishwillee commented Aug 15, 2025

Uh oh!

Uh oh!

Uh oh!

Ff142 RTCInboundRtpStreamStats fixes #40495

Ff142 RTCInboundRtpStreamStats fixes #40495

Uh oh!

Conversation

hamishwillee commented Jul 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jul 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Jul 31, 2025

Uh oh!

Uh oh!

hamishwillee Aug 4, 2025

Choose a reason for hiding this comment

Uh oh!

hamishwillee commented Aug 10, 2025

Uh oh!

wbamberg commented Aug 11, 2025

Uh oh!

wbamberg left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

hamishwillee commented Aug 15, 2025

Uh oh!

Uh oh!

Uh oh!

hamishwillee commented Jul 22, 2025 •

edited

Loading

github-actions bot commented Jul 22, 2025 •

edited

Loading