RTCIceTransport

Интерфейс RTCIceTransport предоставляет доступ к информации о слое транспорта ICE, по которому передаются и принимаются данные. Это особенно полезно, если вам нужно получить информацию о состоянии подключения.

Интерфейс RTCIceTransport наследует свойства от своего родительского интерфейса EventTarget. Он также предлагает следующие свойства:

component Только для чтения

Используемый компонент ICE. Значение — одна из строк перечисления RTCIceTransport: "RTP" или "RTSP".

gatheringState Только для чтения

Строка, указывающая текущее состояние сбора ICE-агента: "new", "gathering", или "complete".

role Только для чтения

Возвращает строку со значением "controlling" или "controlled", указывающую, является ли ICE-агент тем, кто принимает окончательное решение о том, использовать ли пару кандидатов или нет.

state Только для чтения

Строка, указывающая текущее состояние ICE-агента. Значение state может быть использовано для определения того, установил ли ICE-агент начальное соединение с помощью жизнеспособной пары кандидатов ("connected"), завершил ли он окончательный выбор пар кандидатов ("completed") или находится в состоянии ошибки ("failed"), среди других состояний.

Также включает методы из EventTarget, родительского интерфейса.

getLocalCandidates()

Возвращает массив объектов RTCIceCandidate, каждый из которых описывает одного из ICE-кандидатов, собранных до этого момента для локального устройства. Это те же кандидаты, которые уже были отправлены удаленному узлу, отправив событие icecandidate в RTCPeerConnection для передачи.

getLocalParameters()

Возвращает объект RTCIceParameters, описывающий ICE-параметры, установленные вызовом метода RTCPeerConnection.setLocalDescription(). Возвращает null, если параметры еще не получены.

getRemoteCandidates()

Возвращает массив объектов RTCIceCandidate, по одному для каждого ICE-кандидата удаленного устройства, полученного локальной стороной RTCPeerConnection и переданного ICE вызовом addIceCandidate().

getRemoteParameters()

Возвращает объект RTCIceParameters, содержащий ICE-параметры для удаленного устройства, установленные вызовом RTCPeerConnection.setRemoteDescription(). Если setRemoteDescription() еще не был вызван, возвращаемое значение — null.

getSelectedCandidatePair()

Возвращает объект RTCIceCandidatePair, идентифицирующий две выбранные кандидаты — по одной для каждого конца соединения — на данный момент. Возможно, позже будет найдена и выбрана лучшая пара; если вам нужно отслеживать это, наблюдайте за событием selectedcandidatepairchange. Если еще не было выбрано пары кандидатов, возвращаемое значение — null.

Прислушивайтесь к этим событиям с помощью addEventListener() или назначив обработчик событий для свойства oneventname этого интерфейса.

gatheringstatechange

Отправляется объекту RTCIceTransport для указания того, что значение свойства gatheringState изменилось, что указывает на изменение процесса согласования ICE-кандидатов для этого транспорта. Также доступен через обработчик события ongatheringstatechange.

selectedcandidatepairchange

Отправляется объекту RTCIceTransport при выборе новой, лучшей пары кандидатов для описания подключения между двумя узлами. Это происходит во время согласования или повторного согласования, включая после перезапуска ICE, который использует существующие объекты RTCIceTransport. Текущая пара кандидатов может быть получена с помощью getSelectedCandidatePair(). Также доступен через обработчик события onselectedcandidatepairchange.

statechange

Отправляется экземпляру RTCIceTransport при изменении значения свойства state, что указывает на изменение состояния процесса сбора ICE. Также доступен через обработчик события onstatechange.

tbd