ThegetParameters() method of theRTCRtpReceiver interface returns an object describing the current configuration for how the receiver'strack is decoded.

Syntax

getParameters()

Parameters

None.

Return value

An object indicating the current configuration of the receiver.

codecs

An array of objects describing themedia codecs that the receiver is ready to use.This is the subset of codecs that the receiver has indicated it prefers and that the remote endpoint has indicated it is prepared to send.This parameter cannot be changed once initially set.

Each codec object in the array may have the following properties:

channelsOptional

A positive integer indicating the number of channels supported by the codec.For example, for audio codecs a value of 1 specifies monaural sound, while 2 indicates stereo.

clockRate

A positive integer specifying the codec's clock rate in Hertz (Hz).The clock rate is the rate at which the codec's RTP timestamp advances.Most codecs have specific values or ranges of values they permit.The IANA maintains alist of codecs and their parameters, including their clock rates.

mimeType

A string indicating the codec's MIME media type and subtype, specified as a string of the form"type/subtype".The MIME type strings used by RTP differ from those used elsewhere.IANA maintains aregistry of valid MIME types.Also seeCodecs used by WebRTC for details about potential codecs that might be referenced here.

payloadType

TheRTP payload type used to identify this codec.

sdpFmtpLineOptional

A string giving the format specific parameters field from thea=fmtp line in theSDP which corresponds to the codecSDP from the remote peer, if the field is present.If there is no parameters field, this property is left out.Seesection 5.8 of the IETF specification for JSEP for more information.

headerExtensions

An array of zero or more RTP header extensions, each identifying an extension supported by the sender or receiver.Header extensions are described inRFC 3550, section 5.3.1. This parameter cannot be changed once initially set.

rtcp

AnRTCRtcpParameters object providing the configuration parameters used forRTCP on the sender or receiver.This parameter cannot be changed once initially set.

Examples

This example obtains the canonical name (CNAME) being used forRTCP on anRTCRtpReceiver.

function getRtcpCNAME(receiver) {  let parameters = receiver.getParameters();  return parameters.rtcp.cname;}

Specifications

Browser compatibility