RTCRtpTransceiver: currentDirection-Eigenschaft

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.

* Some parts of this feature may have varying levels of support.

Die schreibgeschützte RTCRtpTransceiver-Eigenschaft currentDirection ist ein String, der die aktuell ausgehandelte Richtung des Transceivers angibt.

Die Richtung gibt an, ob der Transceiver anbietet, RTP-Daten zu senden und/oder zu empfangen oder ob er inaktiv oder gestoppt ist und keine Daten senden oder empfangen wird.

Die bevorzugte Richtung des Transceivers kann über die direction-Eigenschaft festgelegt und gelesen werden. Eine Änderung der direction löst eine Neuverhandlung aus, die letztendlich auch zu einer Änderung der currentDirection führen kann.

Wert

Der Wert ist zunächst null, vor der Aushandlung mittels eines Angebots/Antworts.

Nach der Aushandlung ist der Wert ein String mit einem der folgenden Werte:

"sendrecv"

Der Transceiver bietet an, RTP-Daten zu senden und zu empfangen:

  • RTCRtpSender: Bietet an, RTP-Daten zu senden, und wird dies tun, wenn der entfernte Teilnehmer die Verbindung akzeptiert und mindestens eine der Encodings des Senders aktiv ist.
  • RTCRtpReceiver: Bietet an, RTP-Daten zu empfangen und tut dies, wenn der entfernte Teilnehmer dies akzeptiert.
"sendonly"

Der Transceiver bietet an, RTP-Daten zu senden, aber nicht zu empfangen:

  • RTCRtpSender: Bietet an, RTP-Daten zu senden, und wird dies tun, wenn der entfernte Teilnehmer die Verbindung akzeptiert und mindestens eine der Encodings des Senders aktiv ist.
  • RTCRtpReceiver: Bietet nicht an, RTP-Daten zu empfangen und wird dies nicht tun.
"recvonly"

Der Transceiver bietet an, RTP-Daten zu empfangen, aber nicht zu senden:

  • RTCRtpSender: Bietet nicht an, RTP-Daten zu senden, und wird dies nicht tun.
  • RTCRtpReceiver: Bietet an, RTP-Daten zu empfangen, und wird dies tun, wenn der entfernte Teilnehmer dies anbietet.
"inactive"

Der Transceiver ist inaktiv:

  • RTCRtpSender: Bietet nicht an, RTP-Daten zu senden, und wird dies nicht tun.
  • RTCRtpReceiver: Bietet nicht an, RTP-Daten zu empfangen und wird dies nicht tun.
"stopped"

Dies ist der Endzustand des Transceivers. Der Transceiver ist gestoppt und wird keine RTP-Daten senden oder empfangen oder dies anbieten.

  • RTCRtpSender: Bietet nicht an, RTP-Daten zu senden, und wird dies nicht tun.
  • RTCRtpReceiver: Bietet nicht an, RTP-Daten zu empfangen und wird dies nicht tun.

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcrtptransceiver-currentdirection

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
currentDirection
"stopped" value

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch