Das WebRTC-InterfaceRTCRtpTransceiver beschreibt eine dauerhafte Paarung einesRTCRtpSender und einesRTCRtpReceiver, zusammen mit einigen geteilten Zuständen.

JederSDP-Medienabschnitt beschreibt einen bidirektionalen SRTP- ("Secure Real Time Protocol") Stream (außer den Medienabschnitt fürRTCDataChannel, falls vorhanden). Diese Paarung von Sende- und Empfangs-SRTP-Streams ist für einige Anwendungen von Bedeutung, daher wirdRTCRtpTransceiver 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 seinermid-Eigenschaft identifiziert, die identisch mit der Medien-ID (mid) seiner entsprechenden m-line ist. EinRTCRtpTransceiver istassoziiert mit einer m-line, wenn seinemid nicht null ist; andernfalls wird er als disassoziiert betrachtet.

Instanz-Eigenschaften

currentDirectionSchreibgeschützt

Ein schreibgeschützter String, der die aktuell verhandelte Richtung des Transceivers angibt, odernull, 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.

midSchreibgeschü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 istnull, 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.

receiverSchreibgeschützt

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

senderSchreibgeschützt

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

stoppedVeraltet

Gibt an, ob das Senden und Empfangen mittels des gepaartenRTCRtpSender 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 dieUser-Agent-Einstellungen.

stop()

Stoppt denRTCRtpTransceiver 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

Browser-Kompatibilität

Siehe auch

• WebRTC API
• Einführung in das Real-time Transport Protocol (RTP)
• RTCPeerConnection.addTrack() undRTCPeerConnection.addTransceiver() erstellen beide Transceiver
• RTCRtpReceiver undRTCRtpSender