RTCPeerConnection: getSenders() 方法
getSenders()
方法是 RTCPeerConnection
接口的方法,它返回一个 RTCRtpSender
对象数组,每个对象代表负责传输一个轨道数据的 RTP 发送器。发送器对象提供用于检查和控制轨道的编码和传输的方法和属性。数据。
语法
js
getSenders()
返回值
一个 RTCRtpSender
对象数组,每个连接轨道对应一个。如果连接上没有 RTP 发送器,则该数组为空。
返回的 RTCRtpSender
实例的顺序不受规范定义,并且可能会在 getSenders()
的一次调用到下一次调用之间发生变化。
该数组不包括与已 停止 的转发器(在 offer/answer 之后)关联的发送器。
示例
在本示例中,显示了一个 setMuting()
函数。该函数以 RTCPeerConnection
、pc
和一个布尔值 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 的浏览器中加载。