RTCRtpReceiver:getParameters() 方法

getParameters() 方法是 RTCRtpReceiver 接口的方法,它返回一个对象,描述了接收器 track 如何解码的当前配置。

语法

js
getParameters()

参数

无。

返回值

一个指示接收器当前配置的对象。

编解码器

一个对象数组,描述了接收器准备使用的 媒体编解码器。这是接收器已指示其首选的编解码器子集,以及远程端点已指示其准备发送的编解码器子集。此参数一旦最初设置,就不能更改。

数组中的每个编解码器对象可能具有以下属性

channels 可选

一个正整数,指示编解码器支持的通道数。例如,对于音频编解码器,值 1 指定单声道声音,而 2 指示立体声。

clockRate

一个正整数,指定编解码器的时钟速率(以赫兹 (Hz) 为单位)。时钟速率是编解码器的 RTP 时间戳递增的速率。大多数编解码器都有特定的值或范围的值。IANA 维护着一个 编解码器及其参数列表,包括它们的时钟速率。

mimeType

一个字符串,指示编解码器的 MIME 媒体类型和子类型,指定为 "type/subtype" 形式的字符串。RTP 使用的 MIME 类型字符串与其他地方使用的不同。IANA 维护着一个 有效 MIME 类型注册表。另请参阅 WebRTC 使用的编解码器,了解此处可能引用的潜在编解码器的详细信息。

payloadType

用于识别此编解码器的 RTP 有效负载类型

sdpFmtpLine 可选

一个字符串,提供来自远程对等方的 SDP 中对应于编解码器 SDPa=fmtp 行中的格式特定参数字段(如果存在该字段)。如果没有参数字段,则省略此属性。有关更多信息,请参阅 IETF JSEP 规范的第 5.8 节

headerExtensions

一个包含零个或多个 RTP 标头扩展的数组,每个扩展都标识发送方或接收方支持的扩展。标头扩展在 RFC 3550,第 5.3.1 节 中进行了描述。此参数一旦最初设置,就不能更改。

rtcp

一个 RTCRtcpParameters 对象,提供用于发送方或接收方 RTCP 的配置参数。此参数一旦最初设置,就不能更改。

示例

此示例获取用于 RTCPRTCRtpReceiver 的规范名称 (CNAME)。

js
function getRtcpCNAME(receiver) {
  let parameters = receiver.getParameters();

  return parameters.rtcp.cname;
}

规范

规范
WebRTC:浏览器中的实时通信
# dom-rtcrtpreceiver-getparameters

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。