RTCRtpTransceiver

Baseline Weitgehend verfügbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2018 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Die WebRTC-Schnittstelle RTCRtpTransceiver beschreibt eine permanente Paarung eines RTCRtpSender und eines RTCRtpReceiver zusammen mit einigen geteilten Zuständen.

Jeder SDP Medienabschnitt beschreibt einen bidirektionalen SRTP ("Secure Real Time Protocol") Stream (mit Ausnahme des Medienabschnitts für RTCDataChannel, falls vorhanden). Diese Paarung von Sende- und Empfangs-SRTP-Streams ist für einige Anwendungen bedeutend, 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 repräsentiert.

Ein Transceiver wird eindeutig durch seine mid Eigenschaft identifiziert, die identisch mit der Medien-ID (mid) seiner entsprechenden m-line ist. Ein RTCRtpTransceiver ist mit einer m-line assoziiert, wenn seine mid nicht null ist; andernfalls gilt es als disassoziiert.

Instanz-Eigenschaften

currentDirection Schreibgeschützt: Ein schreibgeschützter String, der die aktuell ausgehandelte Richtung des Transceivers angibt, oder null, wenn der Transceiver nie an einem Austausch von Angeboten und Antworten beteiligt war. 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 mit diesem Transceiver assoziierten m-line. Diese Assoziierung wird, wenn möglich, immer dann hergestellt, wenn entweder eine lokale oder entfernte Beschreibung angewendet wird. Dieses Feld ist null, wenn weder eine lokale noch entfernte Beschreibung angewendet wurde, oder wenn seine assoziierte m-line entweder durch ein entferntes Angebot oder eine Antwort abgelehnt wird.
receiver Schreibgeschützt: Das RTCRtpReceiver Objekt, das für den Empfang und das Decodieren eingehender Medien zuständig ist.
sender Schreibgeschützt: Das RTCRtpSender Objekt, das für das Kodieren und Senden von Daten an den entfernten Gegenpart verantwortlich ist.
stopped: Gibt an, ob das Senden und Empfangen mit dem gepaarten RTCRtpSender und RTCRtpReceiver dauerhaft deaktiviert wurde, entweder aufgrund eines SDP Angebots/Antworts oder aufgrund eines Aufrufs von stop().

Instanz-Methoden

setCodecPreferences(): Konfiguriert die bevorzugte Liste von Codecs des Transceivers und überschreibt die Einstellungen des User-Agent.
stop(): Stoppt den RTCRtpTransceiver dauerhaft. Der zugehörige Sender hört auf, Daten zu senden, und der zugehörige Empfänger hört ebenfalls auf, eingehende Daten zu empfangen und zu decodieren.

Spezifikationen

Spezifikation
WebRTC: Real-Time Communication in Browsers # rtcrtptransceiver-interface

Browser-Kompatibilität

Siehe auch

WebRTC API
Einführung in das Echtzeit-Transportprotokoll (RTP)
RTCPeerConnection.addTrack() und RTCPeerConnection.addTransceiver() erstellen beide Transceiver
RTCRtpReceiver und RTCRtpSender

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden