RTCOutboundRtpStreamStats: qualityLimitationReason property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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.
Specifications
| Specification |
|---|
| Identifiers for WebRTC's Statistics API # dom-rtcoutboundrtpstreamstats-qualitylimitationreason |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
qualityLimitationReason in 'outbound-rtp' stats
|
|
|
|
|
|
|
|
|
|
|
|
|
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.