RTCRtpTransceiver: свойство direction

Свойство RTCRtpTransceiver direction — это строка, которая указывает предпочтительное направление работы трансивера.

Направление указывает, будет ли трансивер предлагать отправку и/или получение данных RTP, или он неактивен или остановлен (завершён). При установке направления трансивера значение не применяется сразу. Текущее направление указано свойством currentDirection.

Строка с одним из следующих значений:

"sendrecv"

Трансивер предлагает отправлять и получать данные RTP:

• RTCRtpSender: Предлагает отправить данные RTP и сделает это, если удалённый узел примет соединение, и по крайней мере один из кодеков отправителя активен.
• RTCRtpReceiver: Предлагает получить данные RTP и делает это, если удалённый узел принимает.

"sendonly"

Трансивер предлагает отправлять, но не получать данные RTP:

• RTCRtpSender: Предлагает отправить данные RTP и сделает это, если удалённый узел примет соединение, и по крайней мере один из кодеков отправителя активен.
• RTCRtpReceiver: Не предлагает получить данные RTP и не будет этого делать.

"recvonly"

Трансивер предлагает получать, но не отправлять данные RTP:

• RTCRtpSender: Не предлагает отправить данные RTP и не будет этого делать.
• RTCRtpReceiver: Предлагает получить данные RTP и сделает это, если удалённый узел предлагает.

"inactive"

Трансивер неактивен:

• RTCRtpSender: Не предлагает отправить данные RTP и не будет этого делать.
• RTCRtpReceiver: Не предлагает получить данные RTP и не будет этого делать.

"stopped"

Это конечное состояние трансивера. Трансивер остановлен и не будет отправлять или получать данные RTP, а также предлагать это сделать. Установка этого значения, когда трансивер ещё не остановлен, вызывает TypeError.

• RTCRtpSender: Не предлагает отправить данные RTP и не будет этого делать.
• RTCRtpReceiver: Не предлагает получить данные RTP и не будет этого делать.

При установке значения direction, может произойти следующее исключение:

InvalidStateError DOMException

Получатель RTCPeerConnection закрыт или RTCRtpReceiver остановлен.

TypeError

Значение устанавливается в stopped, когда текущее значение — любое, кроме stopped.

Свойство direction может использоваться для установки или получения предпочтительного направления трансивера.

Обновление направления не происходит мгновенно. Если новое значение direction отличается от существующего значения, требуется переподключение, поэтому событие negotiationneeded отправляется в RTCPeerConnection. Значение direction (кроме stopped) затем используется RTCPeerConnection.createOffer() или RTCPeerConnection.createAnswer() для генерации сообщения SDP, созданного этими методами. Например, если direction указано как "sendrecv", соответствующая строка SDP a-line указывает направление:

a=sendrecv

Новое направление вступает в силу после завершения процесса переподключения и успешного применения нового описания сессии.

Текущее направление трансивера указано свойством currentDirection.

• RTCRtpTransceiver.currentDirection