RTCRtpTransceiver
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.
Das WebRTC-Interface RTCRtpTransceiver
beschreibt eine dauerhafte Paarung eines RTCRtpSender
und eines RTCRtpReceiver
, zusammen mit einigen geteilten Zuständen.
Jeder SDP-Medienabschnitt beschreibt einen bidirektionalen SRTP- ("Secure Real Time Protocol") Stream (außer den Medienabschnitt für RTCDataChannel
, falls vorhanden). Diese Paarung von Sende- und Empfangs-SRTP-Streams ist für einige Anwendungen von Bedeutung, daher wird RTCRtpTransceiver
verwendet, um diese Paarung sowie andere wichtige Zustände aus dem Medienabschnitt darzustellen. Jeder nicht deaktivierte SRTP-Medienabschnitt wird immer durch genau einen Transceiver dargestellt.
Ein Transceiver wird eindeutig mithilfe seiner mid
-Eigenschaft identifiziert, die identisch mit der Medien-ID (mid
) seiner entsprechenden m-line ist. Ein RTCRtpTransceiver
ist assoziiert mit einer m-line, wenn seine mid
nicht null ist; andernfalls wird er als disassoziiert betrachtet.
Instanz-Eigenschaften
currentDirection
Nur lesbar-
Ein schreibgeschützter String, der die aktuell verhandelte Richtung des Transceivers angibt, oder
null
, falls der Transceiver noch nie an einem Austausch von Angeboten und Antworten teilgenommen hat. Um die Richtung des Transceivers zu ändern, setzen Sie den Wert derdirection
-Eigenschaft. direction
-
Ein String, der verwendet wird, um die gewünschte Richtung des Transceivers festzulegen.
mid
Nur lesbar-
Die Medien-ID der m-line, die mit diesem Transceiver assoziiert ist. Diese Assoziation wird, wann immer möglich, hergestellt, sobald entweder eine lokale oder entfernte Beschreibung angewendet wird. Dieses Feld ist
null
, wenn weder eine lokale noch eine entfernte Beschreibung angewendet wurde oder wenn die assoziierte m-line entweder von einem entfernten Angebot oder einer Antwort abgelehnt wird. receiver
Nur lesbar-
Das
RTCRtpReceiver
-Objekt, das für das Empfangen und Dekodieren eingehender Medien zuständig ist. sender
Nur lesbar-
Das
RTCRtpSender
-Objekt, das für das Codieren und Senden von Daten an den entfernten Peer verantwortlich ist. stopped
Veraltet-
Gibt an, ob das Senden und Empfangen mittels des gepaarten
RTCRtpSender
undRTCRtpReceiver
dauerhaft deaktiviert wurde, entweder aufgrund eines SDP-Angebots/Antwort oder durch einen Aufruf vonstop()
.
Instanz-Methoden
setCodecPreferences()
-
Konfiguriert die bevorzugte Liste von Codecs des Transceivers und überschreibt damit die User-Agent-Einstellungen.
stop()
-
Stoppt den
RTCRtpTransceiver
dauerhaft. Der zugehörige Sender hört auf, Daten zu senden, und der zugehörige Empfänger hört ebenso auf, eingehende Daten zu empfangen und zu dekodieren.
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers # rtcrtptransceiver-interface |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- WebRTC API
- Einführung in das Real-time Transport Protocol (RTP)
RTCPeerConnection.addTrack()
undRTCPeerConnection.addTransceiver()
erstellen beide TransceiverRTCRtpReceiver
undRTCRtpSender