RTCIceCandidateStats

Базовая Широко доступна *

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

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

Словарь RTCIceCandidateStats API WebRTC используется для отчёта о статистике, связанной с RTCIceCandidate.

Статистику можно получить, итерируя RTCStatsReport, возвращаемый RTCPeerConnection.getStats(), пока не будет найден отчёт с type local-candidate.

Свойства экземпляра

address Необязательно: Строка, содержащая адрес кандидата. Это значение может быть IPv4-адресом, IPv6-адресом или полным доменным именем. Это свойство ранее называлось ip и принимало только IP-адреса.
candidateType: Строка, соответствующая одному из значений в RTCIceCandidate.type, указывающая, для какого типа кандидата объект предоставляет статистику.
deleted Необязательно: Логическое значение, указывающее, был ли кандидат высвобожден или удалён; значение по умолчанию — false. Для локальных кандидатов его значение — true если кандидат был удалён или высвобожден. Для кандидатов-хостов значение true означает, что все сетевые ресурсы (обычно сетевой сокет), связанные с кандидатом, уже высвобождены. Для кандидатов TURN выделение TURN больше не активно для удалённых кандидатов. Это свойство отсутствует для удалённых кандидатов.
port Необязательно: Номер сетевого порта, используемый кандидатом.
priority Необязательно: Приоритет кандидата, соответствующий RTCIceCandidate.priority.
protocol Необязательно: Строка, определяющая протокол (tcp или udp) для передачи данных по port.
relayProtocol Необязательно: Строка, определяющая протокол, используемый конечной точкой для связи с сервером TURN; допустимые значения — tcp, udp, и tls. Присутствует только для локальных кандидатов.
transportId: Строка, уникально идентифицирующая объект транспорта, который был проверен для получения RTCTransportStats, связанного с кандидатом, соответствующим этой статистике.
url Необязательно: Для локальных кандидатов свойство url — URL сервера ICE, из которого был получен кандидат. Этот URL соответствует URL, включённому в объект RTCPeerConnectionIceEvent, представляющий событие icecandidate, которое передало кандидата локальному участнику.

Общие свойства экземпляра

Следующие свойства являются общими для всех объектов статистики WebRTC.

id: Строка, уникально идентифицирующая объект, который отслеживается для создания этого набора статистики.
timestamp: Объект DOMHighResTimeStamp, указывающий время, в которое была взята выборка для этого объекта статистики.
type: Строка со значением "local-candidate", указывающая тип статистики, содержащейся в объекте.

Примеры

TBD

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

Спецификация
Идентификаторы API статистики WebRTC # dom-rtcstatstype-local-candidate

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

	Рабочий стол					Мобильный телефон
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`RTCIceCandidateStats`	80	80	27	67	12.1	80	27	57	12.2	13.0	80
`address`	91	91	6527	77	Нет	91	6527	64	Нет	16.0	91
`candidateType`	80	80	27	67	12.1	80	27	57	12.2	13.0	80
`foundation`	108	108	Нет	94	Нет	108	Нет	73	Нет	21.0	108
`id`	80	80	72	67	13.1	80	79	57	13.4	13.0	80
`port`	80	80	7227	67	12.1	80	7927	57	12.2	13.0	80
`priority`	80	80	72	67	12.1	80	79	57	12.2	13.0	80
`protocol`	80	80	6431	67	12.1	80	6431	57	12.2	13.0	80
`timestamp`	80	80	72	67	13.1	80	79	57	13.4	13.0	80
`transportId`	80	80	31	67	12.1	80	31	57	12.2	13.0	80
`type`	80	80	72	67	13.1	80	79	57	13.4	13.0	80
`usernameFragment`	108	108	Нет	94	Нет	108	Нет	73	Нет	21.0	108

© 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/RTCIceCandidateStats