RTCIceCandidate: свойство type

Чтение только type интерфейса RTCIceCandidate указывает тип кандидата, который представляет объект.

Значение поля type устанавливается из объекта candidateInfo опций, переданного конструктору RTCIceCandidate(). Вы не можете указать значение type напрямую в объекте опций, но его значение автоматически извлекается из a-строки объекта candidate (поле cand-type), если оно отформатировано должным образом.

Строка со значением, определенным ниже. Эти типы кандидатов перечислены в порядке приоритета; чем выше они в списке, тем эффективнее они.

host

Кандидат является кандидатом-хостом, чей IP-адрес, как указано в свойстве RTCIceCandidate.address, фактически является истинным адресом удаленного узла.

srflx

Кандидат является рефлексивным кандидатом сервера; ip и порт — это привязка, выделенная NAT для агента, когда он отправил пакет через NAT на сервер. Их может узнать сервер STUN и сервер TURN, чтобы анонимно представить кандидата.

prflx

Кандидат — это рефлексивный кандидат узла; ip и порт — это привязка, выделенная NAT, когда он отправил запрос STUN, чтобы анонимно представить кандидата.

relay

Кандидат является ретрансляционным кандидатом, полученным от сервера TURN. IP-адрес ретрансляционного кандидата — это адрес, который сервер TURN использует для перенаправления медиа между двумя узлами.

Если type равно null, эта информация отсутствовала в a-строке candidate, что приведет к тому, что RTCPeerConnection.addIceCandidate() выбросит исключение OperationError.

В этом примере type кандидата используется для представления измененного пользовательского интерфейса для кандидатов-хостов (тех, где ip ссылается непосредственно на удаленный узел, а не на посредника).

if (candidate.type === "host") {
  showHostControls();
} else {
  hideHostControls();
}

• API WebRTC
• Введение в протоколы WebRTC
• Подключение WebRTC
• RTCIceCandidate.tcpType