RTCRtpTransceiver
WebRTC 接口 **RTCRtpTransceiver
** 描述了 RTCRtpSender
和 RTCRtpReceiver
的永久配对,以及一些共享状态。
每个 SDP 媒体部分描述一个双向 SRTP(“安全实时协议”)流(除了 RTCDataChannel
的媒体部分,如果有的话)。发送和接收 SRTP 流的这种配对对于某些应用程序很重要,因此 RTCRtpTransceiver
用于表示这种配对,以及媒体部分中的其他重要状态。每个未禁用的 SRTP 媒体部分始终由一个 transceiver 表示。
transceiver 使用其 mid
属性进行唯一标识,该属性与对应 m 行的媒体 ID(mid
)相同。如果 RTCRtpTransceiver
的 mid
不为 null,则它与 m 行 **关联**;否则,它被视为解除关联。
实例属性
currentDirection
只读-
一个只读字符串,指示 transceiver 当前协商的方向性,如果 transceiver 从未参与过要约和应答的交换,则为
null
。要更改 transceiver 的方向性,请设置direction
属性的值。 direction
-
用于设置 transceiver 的目标方向的字符串。
mid
只读-
与该 transceiver 关联的 m 行的媒体 ID。这种关联在可能的情况下建立,无论何时应用本地或远程描述。如果未应用本地或远程描述,或者如果其关联的 m 行被远程要约或任何应答拒绝,则此字段为
null
。 receiver
只读-
处理接收和解码传入媒体的
RTCRtpReceiver
对象。 sender
只读-
负责编码和将数据发送到远程对端的
RTCRtpSender
对象。 stopped
已弃用-
指示是否使用配对的
RTCRtpSender
和RTCRtpReceiver
永久地禁用发送和接收,这可能是由于 SDP 要约/应答,也可能是由于调用stop()
引起的。
实例方法
setCodecPreferences()
-
配置 transceiver 的首选编解码器列表,覆盖 用户代理 设置。
stop()
-
永久停止
RTCRtpTransceiver
。关联的发送器停止发送数据,关联的接收器也停止接收和解码传入数据。
规范
规范 |
---|
WebRTC:浏览器中的实时通信 # rtcrtptransceiver-interface |
浏览器兼容性
BCD 表只在启用 JavaScript 的浏览器中加载。