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.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Die WebRTC-Schnittstelle RTCRtpTransceiver beschreibt eine dauerhafte Paarung eines RTCRtpSender und eines RTCRtpReceiver, zusammen mit einem gemeinsamen Status.

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 von Bedeutung, daher wird RTCRtpTransceiver verwendet, um diese Paarung zusammen mit anderen wichtigen Statusinformationen aus dem Medienabschnitt darzustellen. Jeder nicht deaktivierte SRTP-Medienabschnitt wird immer durch genau einen Transceiver repräsentiert.

Ein Transceiver wird eindeutig über seine mid-Eigenschaft identifiziert, die mit der Medien-ID (mid) seiner entsprechenden m-line identisch 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 derzeit ausgehandelte Richtungsabhängigkeit des Transceivers angibt oder null, wenn der Transceiver noch nie an einem Austausch von Angeboten und Antworten teilgenommen hat. Um die Richtungsabhängigkeit 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 Assoziation wird, wann immer möglich, hergestellt, sobald entweder eine lokale oder eine entfernte Beschreibung angewendet wird. Dieses Feld ist null, bevor eine Beschreibung mit der entsprechenden m-line angewendet wird, oder wenn ein Rollback diese Assoziation rückgängig macht.
receiver Schreibgeschützt: Das RTCRtpReceiver-Objekt, das für den Empfang und die Dekodierung eingehender Medien zuständig ist.
sender Schreibgeschützt: Das RTCRtpSender-Objekt, das für das Kodieren und Senden von Daten zum entfernten Peer verantwortlich ist.
stopped: Gibt an, ob das Senden und Empfangen mit dem gepaarten RTCRtpSender und RTCRtpReceiver dauerhaft deaktiviert wurde, entweder aufgrund von SDP Angebot/Antwort oder aufgrund eines Aufrufs von stop().

Instanz-Methoden

setCodecPreferences(): Konfiguriert die bevorzugte Liste von Codecs des Transceivers und überschreibt dabei User-Agent-Einstellungen.
stop(): Stoppt den RTCRtpTransceiver dauerhaft. Der zugehörige Sender stoppt das Senden von Daten, und der zugehörige Empfänger stoppt ebenfalls den Empfang und die Dekodierung eingehender Daten.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch

WebRTC API
Einführung in das Realtime Transport Protocol (RTP)
RTCPeerConnection.addTrack() und RTCPeerConnection.addTransceiver() beide erstellen 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