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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
RTCRtpSender
createEncodedStreams
dtmf
getCapabilities() static method
getParameters()
codecs property in returned object
degradationPreference property in returned object
Deprecated
encodings property in returned object
headerExtensions property in returned object
rtcp property in returned object
transactionId property in returned object
getStats()
replaceTrack()
rtcpTransport
Deprecated
setParameters()
parameters.codecs parameter
parameters.degradationPreference parameter
Deprecated
parameters.encodings parameter
parameters.encodings.active parameter
parameters.encodings.dtx parameter
DeprecatedNon-standard
parameters.encodings.maxBitrate parameter
parameters.encodings.maxFramerate parameter
parameters.encodings.priority parameter
parameters.encodings.rid parameter
parameters.encodings.scaleResolutionDownBy parameter
parameters.headerExtensions parameter
parameters.rtcp parameter
parameters.transactionId parameter
setStreams
track
transform
transport

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
Has more compatibility info.

Siehe auch