RTCPeerConnection: getSenders() 方法

getSenders() 方法是 RTCPeerConnection 接口的方法,它返回一个 RTCRtpSender 对象数组,每个对象代表负责传输一个轨道数据的 RTP 发送器。发送器对象提供用于检查和控制轨道的编码和传输的方法和属性。数据。

语法

js
getSenders()

返回值

一个 RTCRtpSender 对象数组,每个连接轨道对应一个。如果连接上没有 RTP 发送器,则该数组为空。

返回的 RTCRtpSender 实例的顺序不受规范定义,并且可能会在 getSenders() 的一次调用到下一次调用之间发生变化。

该数组不包括与已 停止 的转发器(在 offer/answer 之后)关联的发送器。

示例

在本示例中,显示了一个 setMuting() 函数。该函数以 RTCPeerConnectionpc 和一个布尔值 muting 作为输入。该函数获取对等连接的发送器列表,并遍历每个发送器,将相应的媒体轨道 enabled 设置为指定 muting 的反值。

js
function setMuting(pc, muting) {
  let senderList = pc.getSenders();

  senderList.forEach((sender) => {
    sender.track.enabled = !muting;
  });
}

规范

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

浏览器兼容性

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

另请参见