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 Zuordnung zwischen einem RTCRtpSender und einem RTCRtpReceiver sowie ihren gemeinsamen Zustand.

Jeder SDP-Medienabschnitt beschreibt einen bidirektionalen SRTP-Stream („Secure Real Time Protocol“), mit Ausnahme des Medienabschnitts für RTCDataChannel, sofern vorhanden. Diese Zuordnung von gesendeten und empfangenen SRTP-Streams ist für manche Anwendungen wichtig. RTCRtpTransceiver stellt daher diese Zuordnung sowie weitere wichtige Zustandsinformationen aus dem Medienabschnitt dar. Jeder nicht deaktivierte SRTP-Medienabschnitt wird durch genau einen Transceiver repräsentiert.

Ein Transceiver wird eindeutig durch seine Eigenschaft mid identifiziert. Ihr Wert entspricht der Medien-ID (mid) der zugehörigen m-line. Ein RTCRtpTransceiver ist einer m-line zugeordnet, wenn sein mid-Wert nicht null ist; andernfalls gilt er als nicht zugeordnet.

Instanzeigenschaften

currentDirection Schreibgeschützt: Ein schreibgeschützter String, der die aktuell ausgehandelte Richtung des Transceivers angibt, oder null, wenn der Transceiver noch nie an einem Austausch von Angeboten und Antworten beteiligt war. Um die Richtung des Transceivers zu ändern, setzen Sie den Wert der Eigenschaft direction.
direction: Ein String, mit dem die gewünschte Richtung des Transceivers festgelegt wird.
mid Schreibgeschützt: Die Medien-ID der m-line, die diesem Transceiver zugeordnet ist. Diese Zuordnung wird nach Möglichkeit hergestellt, sobald eine lokale oder entfernte Beschreibung angewendet wird. Dieses Feld ist null, bevor eine Beschreibung mit der entsprechenden m-line angewendet wird oder wenn ein Rollback die Zuordnung rückgängig macht.
receiver Schreibgeschützt: Das RTCRtpReceiver-Objekt, das eingehende Medien empfängt und dekodiert.
sender Schreibgeschützt: Das RTCRtpSender-Objekt, das Daten kodiert und an den entfernten Peer sendet.
stopped Schreibgeschützt: Gibt an, ob das Senden und Empfangen über den zugeordneten RTCRtpSender und RTCRtpReceiver dauerhaft deaktiviert wurde – entweder infolge des SDP-Angebots- und Antwortaustauschs oder durch einen Aufruf von stop().

Instanzmethoden

setCodecPreferences(): Konfiguriert die bevorzugte Codec-Liste des Transceivers und überschreibt dabei die Einstellungen des User Agents.
stop(): Stoppt den RTCRtpTransceiver dauerhaft. Der zugehörige Sender sendet keine Daten mehr, und der zugehörige Empfänger empfängt und dekodiert keine eingehenden Daten mehr.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch

WebRTC API
Einführung in das Real-time Transport Protocol (RTP)
Sowohl RTCPeerConnection.addTrack() als auch RTCPeerConnection.addTransceiver() 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