RTCRtpSender

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.

Das RTCRtpSender-Interface bietet die Möglichkeit, die Kodierung und den Versand eines bestimmten MediaStreamTrack zu einem entfernten Partner zu steuern und Details darüber zu erhalten.

Mit ihm können Sie die für den entsprechenden Track verwendete Kodierung konfigurieren, Informationen über die Medienfähigkeiten des Geräts abrufen usw. Sie können zudem auf einen RTCDTMFSender zugreifen, der verwendet werden kann, um DTMF-Codes (um das Drücken von Tasten auf einem Telefonwählfeld zu simulieren) an den entfernten Partner zu senden.

Instanz-Eigenschaften

RTCRtpSender.dtmf Schreibgeschützt: Ein RTCDTMFSender, der verwendet werden kann, um DTMF-Töne mit telephone-event Nutzlasten in der RTP-Sitzung, die durch das RTCRtpSender-Objekt repräsentiert wird, zu senden. Ist der Wert null, unterstützen der Track und/oder die Verbindung kein DTMF. Nur Audio-Tracks können DTMF unterstützen.
RTCRtpSender.track Schreibgeschützt: Der MediaStreamTrack, der vom RTCRtpSender verarbeitet wird. Ist track null, sendet der RTCRtpSender nichts.
RTCRtpSender.transport Schreibgeschützt: Der RTCDtlsTransport, über den der Sender die RTP- und RTCP-Pakete austauscht, die für die Verwaltung der Übertragung von Medien- und Steuerungsdaten verwendet werden. Dieser Wert ist null, bis der Transport hergestellt ist. Wenn Bundling verwendet wird, kann mehr als ein Transceiver das gleiche Transportobjekt teilen.
RTCRtpSender.transform: Ein RTCRtpScriptTransform wird verwendet, um einen Transform Stream (TransformStream), der in einem Worker-Thread läuft, in die Sender-Pipeline einzufügen, sodass Stream-Transformationen auf codierte Video- und Audioframes angewendet werden können, nachdem sie von einem Codec ausgegeben und bevor sie gesendet werden.

Veraltete Eigenschaften

rtcpTransport Veraltet: Diese Eigenschaft wurde entfernt; die RTP- und RTCP-Transporte wurden in einen einzigen Transport kombiniert. Verwenden Sie stattdessen die transport Eigenschaft.

Statische Methoden

RTCRtpSender.getCapabilities(): Gibt ein Objekt zurück, das die Fähigkeiten des Systems zum Senden einer bestimmten Art von Mediendaten beschreibt.

Instanz-Methoden

RTCRtpSender.getParameters(): Gibt ein Objekt zurück, das die aktuelle Konfiguration für die Kodierung und Übertragung von Medien auf dem track beschreibt.
RTCRtpSender.getStats(): Gibt ein Promise zurück, das mit einem RTCStatsReport erfüllt wird, das Statistikdaten für alle ausgehenden Streams bereitstellt, die mit diesem RTCRtpSender gesendet werden.
RTCRtpSender.setParameters(): Wendet Änderungen an Parametern an, die konfigurieren, wie der track kodiert und an den entfernten Partner übertragen wird.
RTCRtpSender.setStreams(): Setzt die Stream(s) die mit dem von diesem Sender übertragenen track verbunden sind.
RTCRtpSender.replaceTrack(): Versucht, den derzeit vom RTCRtpSender gesendeten Track durch einen anderen Track zu ersetzen, ohne eine Neuverhandlung durchzuführen. Diese Methode kann verwendet werden, um beispielsweise zwischen der vorderen und hinteren Kamera eines Geräts zu wechseln.

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers # rtcrtpsender-interface

Browser-Kompatibilität

BCD tables only load in the browser