web api instance property
RTCRtpTransceiver: currentDirection property
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.
- : Transceiver offers to send and receive RTP data:
"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.
- : Transceiver offers to send but not receive RTP data:
"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.
- : Transceiver offers to receive but not set RTP data:
"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.
- : Transceiver is inactive:
"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.
- : 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.
Specifications
SpecificationsStandards references are available on the canonical MDN page.
Browser compatibility
Browser compatibilityCompatibility data is available on the canonical MDN page.