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 Schreibgeschützt

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 der direction-Eigenschaft.

direction

Ein String, der verwendet wird, um die gewünschte Richtung des Transceivers festzulegen.

mid Schreibgeschützt

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 Schreibgeschützt

Das RTCRtpReceiver-Objekt, das für das Empfangen und Dekodieren eingehender Medien zuständig ist.

sender Schreibgeschützt

Das RTCRtpSender-Objekt, das für das Codieren und Senden von Daten an den entfernten Peer verantwortlich ist.

stopped

Gibt an, ob das Senden und Empfangen mittels des gepaarten RTCRtpSender und RTCRtpReceiver dauerhaft deaktiviert wurde, entweder aufgrund eines SDP-Angebots/Antwort oder durch einen Aufruf von stop().

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