RTCIceCandidateStats: priority 屬性

Baseline 已廣泛支援

此特性已經十分成熟,可在許多裝置和瀏覽器版本上使用。自 2020 年 7 月以來,它已在各大瀏覽器中可用。

RTCIceCandidateStats 字典的 priority 屬性是一個正整數值,表示所描述候選者的優先順序(或受歡迎程度)。

一個正整數,表示 RTCIceCandidateStats 物件所描述的 RTCIceCandidate 的優先順序。該值範圍可以是從 1 到 2,147,483,647。

描述

在設定 WebRTC 對等連線時的 ICE 協商過程中,使用者代理報告給遠端對等方的優先順序值用於確定哪些候選者被認為是“更受歡迎的”。值越高,候選者就越受歡迎。

確定優先順序

ICE 規範描述了使用者代理和其他使用 WebRTC 的軟體如何計算優先順序。候選者的優先順序是使用以下變數作為輸入計算的:

  • 候選者型別的偏好度(本地、伺服器反射、對等反射或中繼)
  • 候選者特定 IP 地址的偏好度(對於多宿主代理)
  • 候選者的元件 ID(1 代表 RTP,2 代表 RTCP)

候選者的優先順序是使用以下公式計算的(ptype 是候選者型別的優先順序,plocal 是 IP 地址的優先順序)

優先順序=224×ptype+28×plocal+(256-componentID)\mathit{priority} = 2^{24} \times p_{type} + 2^{8} \times p_{local} + \left(\right. 256 - \mathit{componentID} \left.\right)

這等同於將候選者型別、本地 IP 和元件 ID 的優先順序對映到 32 位 priority 值中的不同位範圍。

規範

規範
WebRTC 統計 API 的識別符號
# dom-rtcicecandidatestats-priority

瀏覽器相容性

另見