RTCRtpTransceiver: currentDirection property - Web APIs | MDN
Skip to main content Skip to search RTCRtpTransceiver: currentDirection property 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. See full compatibility Learn more The read-only RTCRtpTransceiver property currentDirection is a string which indicates the current negotiated directionality of the transceiver.
The directionality indicates whether the transceiver will offer to send and/or receive RTP data, or whether it is inactive or stopped and won't send or receive data. The transceiver's preferred directionality can be set and read using the direction property. Changing the direction triggers a renegotiation, which may eventually result in the currentDirection also changing. Value The value is initially null , prior to negotiation using an offer/answer.
After negotiation the value is a string with one of the following values: "sendrecv" Transceiver offers to send and receive RTP data: RTCRtpSender : Offers to send RTP data, and will do so if the remote peer accepts the connection and at least one of the sender's encodings is active. RTCRtpReceiver : Offers to receive RTP data, and does so if the remote peer accepts. "sendonly" Transceiver offers to send but not receive RTP data: RTCRtpSender : Offers to send RTP data, and will do so if the remote peer accepts the connection and at least one of the sender's encodings is active.
RTCRtpReceiver : Does not offer to receive RTP data and will not do so. "recvonly" Transceiver offers to receive but not set RTP data: RTCRtpSender : Does not offer to send RTP data, and will not do so. RTCRtpReceiver : Offers to receive RTP data, and will do so if the remote peer offers. "inactive" Transceiver is inactive: RTCRtpSender : Does not offer to send RTP data, and will not do so. RTCRtpReceiver : Does not offer to receive RTP data and will not do so.
"stopped" This is the terminal state of the transceiver. The transceiver is stopped and will not send or receive RTP data or offer to do so. RTCRtpSender : Does not offer to send RTP data, and will not do so. RTCRtpReceiver : Does not offer to receive RTP data and will not do so. Specifications Specification WebRTC: Real-Time Communication in Browsers # dom-rtcrtptransceiver-currentdirection Browser compatibility See also RTCRtpTransceiver.direction Help improve MDN Learn how to contribute This page was last modified on Sep 17, 2023 by MDN contributors .
View this page on GitHub • Report a problem with this content