RTCIceCandidateStats: свойство priority

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

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

Свойство RTCIceCandidateStats словаря priority — это положительное целое число, указывающее на приоритет (или желательность) описанного кандидата.

Во время переговоров ICE при настройке подключения WebRTC значения приоритета, передаваемые удаленному узлу агентом пользователя, используются для определения, какие кандидаты считаются «более желательными». Чем выше значение, тем более желателен кандидат.

Синтаксис

priority = rtcIceCandidateStats.priority

Значение

Положительное целое число, указывающее приоритет RTCIceCandidate, описанный объектом RTCIceCandidateStats. Значение может находиться в диапазоне от 1 до 2 147 483 647.

Определение приоритета

Спецификация ICE описывает, как агенты пользователя и другое программное обеспечение, использующее WebRTC, должны вычислять приоритет. Приоритет кандидата вычисляется с использованием следующих переменных:

Желательность типа кандидата (локальный, серверно-рефлексивный, по-рефлексивный или ретранслированный)
Желательность конкретного IP-адреса кандидата (для агентов с несколькими IP-адресами)
Идентификатор компонента кандидата (1 для RTP, 2 для RTCP)

Приоритет кандидата вычисляется по формуле (p_type — приоритет типа кандидата, p_local — приоритет IP-адреса):

\mathit{priority} = 2^{24} \times p_{type} + 2^{8} \times p_{local} + \left(\right. 256 - \mathit{componentID} \left.\right)

Это эквивалентно отображению приоритетов типа кандидата, локального IP-адреса и идентификатора компонента в различные диапазоны битов в 32-битном значении priority.

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

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

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`priority`	80	80	72	67	12.1	80	79	57	12.2	13.0	80

См. также

RFC 5245, раздел 4.1.2.1: Раздел рекомендуемой формулы в спецификации ICE

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