RTCOutboundRtpStreamStats: qualityLimitationReason property

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The qualityLimitationReason property of the RTCOutboundRtpStreamStats dictionary is a string indicating the reason why the media quality in the stream is currently being reduced by the codec during encoding, or none if no quality reduction is being performed.

This quality reduction may include changes such as reduced frame rate or resolution, or an increase in compression factor. Note that the user agent report the most limiting factor. If the most limiting factor cannot be determined the result will be reported using the priority order: "bandwidth", "cpu", "other".

The amount of time the encoded media has had its quality reduced in each of the potential ways that can be done can be found in qualityLimitationDurations.

Note: The property is undefined for audio streams.

Value

A string with one of the following values:

none

The quality is not limited.

cpu

The quality is primarily limited due to CPU load.

bandwidth

The quality is primarily limited due to congestion cues during bandwidth estimation, such as inter-arrival time and round-trip time.

other

The quality is primarily limited for a reason other than the above.

Examples

Specifications

Specification
Identifiers for WebRTC's Statistics API
# dom-rtcoutboundrtpstreamstats-qualitylimitationreason

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
qualityLimitationReason in 'outbound-rtp' stats
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.