RTCIceCandidateStats dictionary's priority property is a positive integer value indicating the priority (or desirability) of the described candidate. During ICE negotiation while setting up a WebRTC peer connection, the priority values reported to the remote peer by a 用户代理 are used to determine which candidates are considered "more desirable". The higher the value, the more desirable the candidate is.

句法

priority = rtcIceCandidateStats.priority;
					

A positive integer indicating the priority of the RTCIceCandidate described by the RTCIceCandidateStats object. The value may be anywhere from 1 to 2,147,483,647.

Determining priority

The ICE specification describes how user agents and other software using WebRTC should calculate the priority. The priority of a candidate is calculated using the following variables as inputs:

  • The preferability of the candidate type (local, server reflexive, peer reflexive, or relayed)
  • The preferability of the candidate's specific IP address (for multihomed agents)
  • The candidate's component ID (1 for RTP, 2 for RTCP)

The candidate's priority is computed using the formula ( p type is the priority of the candidate's type and p local is the priority of the IP address):

priority = 2 24 × p type + 2 8 × p local + ( 256 - componentID ) priority\quad =\quad { 2 }^{ 24 }\times { p }_{ type }\quad +\quad { 2 }^{ 8 }\times { p }_{ local }\quad +\quad (256\quad -\quad componentID)

This is equivalent to mapping the priorities of teh candidate type, the local IP, and the component ID into various bit ranges within the 32-bit priority 值。

规范

规范 状态 注释
Identifiers for WebRTC's Statistics API
The definition of 'RTCIceCandidateStats.port' in that specification.
候选推荐 最初的规范。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
port Chrome No Edge No Firefox 27 Alternate Name
27 Alternate Name
Alternate Name Uses the non-standard name: portNumber
IE No Opera ? Safari ? WebView Android No Chrome Android No Firefox Android 27 Alternate Name
27 Alternate Name
Alternate Name Uses the non-standard name: portNumber
Opera Android ? Safari iOS ? Samsung Internet Android No

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

使用非标名称。

另请参阅

元数据

  • 最后修改: