RTCRtpSender

Baseline 广泛可用 *

此功能已非常成熟,可在许多设备和浏览器版本上运行。自 2018 年 1 月起,它已在所有浏览器中可用。

* 此特性的某些部分可能存在不同级别的支持。

RTCRtpSender 接口提供了控制和获取有关特定 MediaStreamTrack 如何被编码并发送给远程对等端(peer)的详细信息的能力。

通过它,您可以配置相应轨道的编码,获取设备媒体功能的信息,等等。您还可以访问一个 RTCDTMFSender,它可用于向远程对等端发送 DTMF 码(用于模拟用户按下电话拨号盘上的按钮)。

实例属性

RTCRtpSender.dtmf 只读

一个 RTCDTMFSender,可用于在 RTCRtpSender 对象表示的 RTP 会话上使用 telephone-event 有效负载发送 DTMF 信号。如果为 null,则表示该轨道和/或连接不支持 DTMF。只有音频轨道支持 DTMF。

RTCRtpSender.track 只读

RTCRtpSender 处理的 MediaStreamTrack。如果 tracknull,则 RTCRtpSender 不会传输任何内容。

RTCRtpSender.transport 只读

发送方用于交换用于管理媒体传输和控制数据的 RTP 和 RTCP 数据包的 RTCDtlsTransport。此值在传输建立之前为 null。在使用捆绑(bundling)时,可能会有多个收发器(transceiver)共享同一个传输对象。

RTCRtpSender.transform

一个 RTCRtpScriptTransform用于将工作线程中运行的转换流(TransformStream)插入发送管道,从而允许在编码器输出之后、发送之前,将转换应用于编码的视频和音频帧。

已废弃的属性

rtcpTransport 已弃用

此属性已被移除;RTP 和 RTCP 传输已合并为一个单独的传输。请改用 transport 属性。

静态方法

RTCRtpSender.getCapabilities()

返回一个描述系统发送指定类型媒体数据的能力的对象。

实例方法

RTCRtpSender.getParameters()

返回一个描述 track 的当前媒体编码和传输配置的对象。

RTCRtpSender.getStats()

返回一个 Promise,该 Promise 将会以一个 RTCStatsReport 来解析,该报告提供了通过此 RTCRtpSender 发送的所有出站流的统计数据。

RTCRtpSender.setParameters()

应用参数更改,这些参数配置了 track 如何被编码并传输到远程对等端。

RTCRtpSender.setStreams()

设置与此发送方正在传输的 track 相关联的

RTCRtpSender.replaceTrack()

尝试用另一个轨道替换 RTCRtpSender 当前正在发送的轨道,而不执行重新协商。此方法可用于,例如,在设备的后置和前置摄像头之间切换。

规范

规范
WebRTC:浏览器中的实时通信
# rtcrtpsender-interface

浏览器兼容性

另见