W3cubDocs

/Web APIs

RTCRtpEncodingParameters

An instance of the WebRTC API's RTCRtpEncodingParameters dictionary describes a single configuration of a codec for an RTCRtpSender.

This dictionary is used to describe the configuration of an RTP sender's encodings when calling RTCRtpSender.getParameters() or RTCRtpSender.setParameters().

Instance properties

active

If true, the described encoding is currently actively being used. That is, for RTP senders, the encoding is currently being used to send data, while for receivers, the encoding is being used to decode received data. The default value is true.

dtx Deprecated Non-standard

Only used for an RTCRtpSender whose kind is audio, this property indicates whether or not to use discontinuous transmission (a feature by which a phone is turned off or the microphone muted automatically in the absence of voice activity). The value is taken either enabled or disabled.

maxBitrate

An unsigned long integer indicating the maximum number of bits per second to allow for this encoding. Other parameters may further constrain the bit rate, such as the value of maxFramerate or transport or physical network limitations.

maxFramerate

A value specifying the maximum number of frames per second to allow for this encoding.

priority

A string indicating the priority of the RTCRtpSender, which may determine how the user agent allocates bandwidth between senders. Allowed values are very-low, low (default), medium, high.

rid

A string which, if set, specifies an RTP stream ID (RID) to be sent using the RID header extension. This parameter cannot be modified using setParameters(). Its value can only be set when the transceiver is first created.

scaleResolutionDownBy

Only used for senders whose track's kind is video, this is a double-precision floating-point value specifying a factor by which to scale down the video during encoding. The default value, 1.0, means that the sent video's size will be the same as the original. A value of 2.0 scales the video frames down by a factor of 2 in each dimension, resulting in a video 1/4 the size of the original. The value must not be less than 1.0 (you can't use this to scale the video up).

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
RTCRtpEncodingParameters 67 ≤79 46 No 54 11 67 67 46 48 11 9.0
active 67 ≤79 110 No 54 11 67 67 110 48 11 9.0
dtx No No No No No 11 No No No No 11 No
fec No No 46 No No No No No 46 No No No
maxBitrate 67 ≤79 46 No 54 11 67 67 46 48 11 9.0
maxFramerate 81 81
101Zero is treated as 'no fps limit' (see bug 1611957).
No 68 11 81 81
101Zero is treated as 'no fps limit' (see bug 1611957).
58 11 13.0
priority 67 ≤79
46In version 110 and later the default priority is low.
No 54 11 67 67
46In version 110 and later the default priority is low.
48 11 9.0
rid No No 46 No No No No No 46 No No No
rtx No No 46 No No No No No 46 No No No
scaleResolutionDownBy 74 79 46 No 62 11 74 74 46 53 11 11.0
ssrc No No 46 No No No No No 46 No No No

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCRtpEncodingParameters