RTCRtpTransceiver.direction

Das RTCRtpTransceiver direction Attribut gibt als String die bevorzugte Transceiver-Richtung an. Es muss sich hierbei um einen Wert des RTCRtpTransceiverDirection (en-US) Enum handeln.

Die tats√§chliche, aktuelle Richtung des Transceivers kann √ľber das currentDirection (en-US) Attribut abgelesen werden.

Syntax

var direction = RTCRtpTransceiver.direction

Value

Ein DOMString, dessen Wert einem Wert des RTCRtpTransceiverDirection Enum / Aufz√§hlungstypen entspricht und die bevorzugte Transceiver-Richtung angibt.

The RTCRtpTransceiverDirection type is an enumeration of string values. Each describes how the transceiver's associated RTCRtpSender and RTCRtpReceiver behave as shown in the table below.

Value RTCRtpSender behavior RTCRtpReceiver behavior
"sendrecv" Offers to send RTP data, and will do so if the other peer accepts the connection and at least one of the sender's encodings is active1. Offers to receive RTP data, and does so if the other peer accepts.
"sendonly" Offers to send RTP data, and will do so if the other peer accepts the connection and at least one of the sender's encodings is active1. Does not offer to receive RTP data and will not do so.
"recvonly" Does not offer to send RTP data, and will not do so. Offers to receive RTP data, and will do so if the other peer offers.
"inactive" Does not offer to send RTP data, and will not do so. Does not offer to receive RTP data and will not do so.

[1] To determine if a sender has at least one active encoding, the user agent gets its parameters using RTCRtpSender.getParameters(), then looks at the parameters' encodings property; if any of the listed encodings has its active property set to true, the sender has an active encoding.

Exceptions

Wird der direction Wert eines Transceivers gesetzt, k√∂nnen folgende Fehler auftreten:

InvalidStateError
Der Receiver des Transceivers RTCPeerConnection wurde bereits geschlossen und befindet sich nun im closed Zustand oder der RTCRtpReceiver (en-US) wurde gestoppt und befinet sich im stopped Zustand.

Hinweise zur Nutzung

√Ąndern der √úbertragungsrichtung

Wird der Wert des direction Attributes ge√§ndert, wird eine InvalidStateError Ausnahme geworfen, insofern die RTCPeerConnection bereits geschlossen wurde oder aber der jeweils betroffene Receiver oder Sender bereits gestoppt wurde.

Wenn der neu gesetzte Wert f√ľr direction sich vom aktuellen Wert unterscheidet, muss die √úbertragung mit dem Peer neu verhandelt werden, es wird also ein negotiationneeded Event auf der RTCPeerConnection ausgel√∂st.

Transceiver-Richtung in SDP

Der direction Wert wird von RTCPeerConnection.createOffer() (en-US) bzw. RTCPeerConnection.createAnswer() (en-US) genutzt, um die entsprechenden SDP-Nachrichten zu generieren. SDP stellt die Richtung √ľber eine Attribut-Zeile (a-line) dar. Wenn die Richtung des Transceivers als "sendrecv" definiert wurde, so enth√§lt die hierzu erzeugte SDP-Nachricht folgende Attribut-Zeile:

a=sendrecv

Specifications

Specification Status Comment
WebRTC 1.0: Real-time Communication Between Browsers
Die Definition von 'RTCRtpTransceiver.direction' in dieser Spezifikation.
Anwärter Empfehlung

Browser compatibility

BCD tables only load in the browser

See also