RTCPeerConnection: метод addTransceiver()

Базовая Широко поддерживается *

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.

* Некоторые части этой функции могут иметь разную степень поддержки.

Метод addTransceiver() интерфейса RTCPeerConnection создает новый RTCRtpTransceiver и добавляет его в набор трансиверов, связанных с RTCPeerConnection. Каждый трансивер представляет собой двунаправленный поток, с ассоциированным RTCRtpSender и RTCRtpReceiver.

Синтаксис

addTransceiver(trackOrKind)
addTransceiver(trackOrKind, init)

Параметры

trackOrKind

MediaStreamTrack для связывания с трансивером или строка, используемая как тип kind приемника track, и как следствие, самого RTCRtpReceiver.

init Необязательно

Объект для указания параметров при создании нового трансивера. Возможные значения:

direction Необязательно: Предпочитаемое направление нового трансивера. Это значение используется для инициализации свойства RTCRtpTransceiver.direction нового объекта RTCRtpTransceiver.
sendEncodings Необязательно: Массив кодеков, разрешенных при отправке RTP-медиа от RTCRtpSender. Это эквивалентно массиву parameter.encodings, переданному в RTCRtpSender.setParameters().
streams Необязательно: Список объектов MediaStream, добавляемых к RTCRtpReceiver трансивера; при возникновении события track на удаленном конечном RTCPeerConnection, будут использоваться именно эти потоки.

Возвращаемое значение

Объект RTCRtpTransceiver, который будет использоваться для обмена данными медиа.

Исключения

TypeError

Выбрасывается, если trackOrKind не является "audio" или "video".

Если используется аргумент sendEncodings, данная ошибка может быть выброшена, если член rid имеет неверный формат, некоторые, но не все, кодеки содержат член rid, или у разных кодеков одинаковое значение rid.

RangeError

Выбрасывается, если у любого из кодеков sendEncodings значение maxFramerate меньше 0.0, или значение scaleResolutionDownBy меньше 1.0.

InvalidStateError DOMException

Выбрасывается, если метод вызывается, когда связанное соединение закрыто.

InvalidAccessError DOMException

Выбрасывается, если используется аргумент sendEncodings, и содержит только для чтения параметр, отличный от rid.

Спецификации

Спецификация
WebRTC: Связь в режиме реального времени в браузерах # dom-rtcpeerconnection-addtransceiver

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`addTransceiver`	69	79	59	56	11	69	59	48	11	10.0	69
`init_direction_parameter`	69	79	59	56	11	69	59	48	11	10.0	69
`init_sendEncodings_parameter`	69	79	110	56	14.1	69	110	48	14.5	10.0	69
`init_streams_parameter`	69	79	59	56	12.1	69	59	48	12.2	10.0	69

См. также

API WebRTC
Введение в протокол RTP (Real-time Transport Protocol)
RTCPeerConnection.addTrack() также создает трансиверы
RTCRtpReceiver и RTCRtpSender

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/addTransceiver