RTCPeerConnection: getSenders() Methode
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
* Some parts of this feature may have varying levels of support.
Die getSenders() Methode der RTCPeerConnection Schnittstelle gibt ein Array von RTCRtpSender Objekten zurück, von denen jedes den RTP-Sender repräsentiert, der für die Übertragung der Daten eines Tracks verantwortlich ist.
Ein Sender-Objekt bietet Methoden und Eigenschaften zur Überprüfung und Steuerung der Kodierung und Übertragung der Track-Daten.
Syntax
getSenders()
Parameter
Keine.
Rückgabewert
Ein Array von RTCRtpSender Objekten, eines für jeden Track in der Verbindung.
Das Array ist leer, wenn keine RTP-Sender in der Verbindung vorhanden sind.
Die Reihenfolge der zurückgegebenen RTCRtpSender Instanzen ist durch die Spezifikation nicht definiert und kann sich von einem Aufruf von getSenders() zum nächsten ändern.
Das Array enthält keine Sender, die mit Transceivern verknüpft sind, die gestoppt wurden (nach Angebot/Antwort).
Beispiel
In diesem Beispiel wird eine setMuting() Funktion gezeigt.
Diese Funktion nimmt eine RTCPeerConnection, pc, und einen Booleschen Wert, muting, als Eingabe. Die Funktion erhält die Liste der Sender der Peer-Verbindung und iteriert über jeden Sender, wobei sie den entsprechenden Medien-Track auf enabled auf das Inverse des angegebenen muting setzt.
function setMuting(pc, muting) {
let senderList = pc.getSenders();
senderList.forEach((sender) => {
sender.track.enabled = !muting;
});
}
Spezifikationen
| Specification |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-peerconnection-getsenders |