RTCRtpEncodingParameters - 描述了 RTCRtpSender 的编解码器的单个配置
RTCRtpEncodingParameters
是 WebRTC API 的词典,描述了 RTCRtpSender
的codec 的单个配置。在 RTCRtpSendParameters
中使用它来描述 RTP 发送方 encodings
的配置。 RTCRtpDecodingParameters
用于描述 RTP 接收器 encodings
的配置。
属性
active
如果为 true
,则当前正在积极使用所描述的编码。也就是说,对于 RTP 发送方,当前正在使用编码来发送数据,而对于接收方,则正在使用编码来解码接收到的数据。默认值为 true
。
codecPayloadType
当描述 RTCRtpSender
的编解码器时,codecPayloadType
是一个 8 位字节,用于指定用于发送流的编解码器;该值与拥有的 RTCRtpParameters
对象的 codecs
参数中的一个匹配。该值只能在创建收发器时设置。设置之后是只读的。
dtx
仅用于 kind
为 audio
的RTCRtpSender
,此属性指示是否使用不连续传输(在没有语音活动的情况下关闭电话或麦克风自动静音)。该值取自枚举的字符串类型 RTCDtxStatus
。
maxBitrate
一个无符号的长整数,指示允许这种编码的每秒最大位数。其他参数可能进一步限制比特率,例如 maxFramerate
的值或传输或物理网络限制。
maxFramerate
一个双精度浮点值,指定每秒允许进行此编码的最大帧数。
ptime
一个无符号的长整数值,指示媒体包的首选持续时间(以毫秒为单位)。这通常仅与音频编码有关。用户代理将尽力匹配此匹配,但是不能保证。
rid
一个 DOMString
,如果设置了,则指定要使用 RID 标头扩展名发送的 RTP 流 ID(RID)。无法使用 setParameters()
修改此参数。仅在首次创建收发器时才能设置其值。
scaleResolutionDownBy
仅用于其跟踪的 kind
为 video
的发送方,这是一个双精度浮点值,指定了在编码过程中按比例缩小视频的因子。默认值为 1.0,表示发送的视频大小将与原始大小相同。值 2.0 会将视频帧在每个维度上缩小 2 倍,从而使视频的大小是原始大小的 1/4。该值不得小于 1.0(您不能使用它来放大视频)。
规范
规范 | 状态 | 备注 |
---|---|---|
WebRTC 1.0: Real-time Communication Between Browsers RTCRtpEncodingParameters 的定义 |
候选推荐 | 初始定义。 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 67 | ≤79 | 46 | 不支持 | 未知 | 未知 |
active | 67 | ≤79 | 46 | 不支持 | 未知 | 未知 |
codecPayloadType | 不支持 | 不支持 | 不支持 | 不支持 | 未知 | 未知 |
dtx | 不支持 | 不支持 | 不支持 | 不支持 | 未知 | 未知 |
fec | 不支持 | 不支持 | 461 | 不支持 | 不支持 | 不支持 |
maxBitrate | 67 | ≤79 | 46 | 不支持 | 未知 | 未知 |
maxFramerate | 不支持 | 不支持 | 不支持 | 不支持 | 未知 | 未知 |
priority | 672 | ≤792 | 462 | 不支持 | 未知 | 未知 |
ptime | 不支持 | 不支持 | 不支持 | 不支持 | 未知 | 未知 |
rid | 不支持 | 不支持 | 463 | 不支持 | 不支持 | 不支持 |
rtx | 不支持 | 不支持 | 461 | 不支持 | 不支持 | 不支持 |
scaleResolutionDownBy | 74 | 不支持 | 46 | 不支持 | 未知 | 未知 |
ssrc | 不支持 | 不支持 | 461 | 不支持 | 不支持 | 不支持 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 67 | 67 | 未知 | 46 | 未知 | 未知 | 未知 |
active | 67 | 67 | 未知 | 46 | 未知 | 未知 | 未知 |
codecPayloadType | 不支持 | 不支持 | 未知 | 不支持 | 未知 | 未知 | 未知 |
dtx | 不支持 | 不支持 | 未知 | 不支持 | 未知 | 未知 | 未知 |
fec | 不支持 | 不支持 | 未知 | 461 | 未知 | 不支持 | 不支持 |
maxBitrate | 67 | 67 | 未知 | 46 | 未知 | 未知 | 未知 |
maxFramerate | 不支持 | 不支持 | 未知 | 不支持 | 未知 | 未知 | 未知 |
priority | 672 | 672 | 未知 | 462 | 未知 | 未知 | 未知 |
ptime | 不支持 | 不支持 | 未知 | 不支持 | 未知 | 未知 | 未知 |
rid | 不支持 | 不支持 | 未知 | 463 | 未知 | 不支持 | 不支持 |
rtx | 不支持 | 不支持 | 未知 | 461 | 未知 | 不支持 | 不支持 |
scaleResolutionDownBy | 74 | 74 | 未知 | 46 | 未知 | 未知 | 未知 |
ssrc | 不支持 | 不支持 | 未知 | 461 | 未知 | 不支持 | 不支持 |
1. 此非标准属性不应在生产代码中使用。
2. 此属性的标准版本是 RTCRtpSendParameters.priority
。
3. 此属性的标准版本是 RTCRtpCodecParameters.rid
。