RTCRtpReceiver:getParameters() 方法
getParameters()
方法是 RTCRtpReceiver
接口的方法,它返回一个对象,描述了接收器 track
如何解码的当前配置。
语法
getParameters()
参数
无。
返回值
一个指示接收器当前配置的对象。
编解码器
-
一个对象数组,描述了接收器准备使用的 媒体编解码器。这是接收器已指示其首选的编解码器子集,以及远程端点已指示其准备发送的编解码器子集。此参数一旦最初设置,就不能更改。
数组中的每个编解码器对象可能具有以下属性
channels
可选-
一个正整数,指示编解码器支持的通道数。例如,对于音频编解码器,值 1 指定单声道声音,而 2 指示立体声。
clockRate
-
一个正整数,指定编解码器的时钟速率(以赫兹 (Hz) 为单位)。时钟速率是编解码器的 RTP 时间戳递增的速率。大多数编解码器都有特定的值或范围的值。IANA 维护着一个 编解码器及其参数列表,包括它们的时钟速率。
mimeType
-
一个字符串,指示编解码器的 MIME 媒体类型和子类型,指定为
"type/subtype"
形式的字符串。RTP 使用的 MIME 类型字符串与其他地方使用的不同。IANA 维护着一个 有效 MIME 类型注册表。另请参阅 WebRTC 使用的编解码器,了解此处可能引用的潜在编解码器的详细信息。 payloadType
-
用于识别此编解码器的 RTP 有效负载类型。
sdpFmtpLine
可选-
一个字符串,提供来自远程对等方的 SDP 中对应于编解码器 SDP 的
a=fmtp
行中的格式特定参数字段(如果存在该字段)。如果没有参数字段,则省略此属性。有关更多信息,请参阅 IETF JSEP 规范的第 5.8 节。
headerExtensions
-
一个包含零个或多个 RTP 标头扩展的数组,每个扩展都标识发送方或接收方支持的扩展。标头扩展在 RFC 3550,第 5.3.1 节 中进行了描述。此参数一旦最初设置,就不能更改。
rtcp
-
一个
RTCRtcpParameters
对象,提供用于发送方或接收方 RTCP 的配置参数。此参数一旦最初设置,就不能更改。
示例
此示例获取用于 RTCP 的 RTCRtpReceiver
的规范名称 (CNAME)。
function getRtcpCNAME(receiver) {
let parameters = receiver.getParameters();
return parameters.rtcp.cname;
}
规范
规范 |
---|
WebRTC:浏览器中的实时通信 # dom-rtcrtpreceiver-getparameters |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。