RTCIceCandidateStats: Eigenschaft priority

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

Die priority-Eigenschaft des RTCIceCandidateStats-Wörterbuchs ist ein positiver Ganzzahlenwert, der die Priorität (oder Erwünschtheit) des beschriebenen Kandidaten angibt.

Wert

Ein positiver Ganzzahlenwert, der die Priorität des durch das RTCIceCandidateStats-Objekt beschriebenen RTCIceCandidate angibt. Der Wert kann zwischen 1 und 2.147.483.647 liegen.

Beschreibung

Während der ICE-Aushandlung beim Einrichten einer WebRTC-Peer-Verbindung werden die Prioritätswerte, die dem entfernten Peer von einem User-Agent gemeldet werden, dazu verwendet, festzustellen, welche Kandidaten als "erwünschenswerter" angesehen werden. Je höher der Wert, desto erwünschter ist der Kandidat.

Priorität bestimmen

Die ICE-Spezifikation beschreibt, wie User-Agents und andere Software, die WebRTC verwendet, die Priorität berechnen sollten. Die Priorität eines Kandidaten wird unter Verwendung der folgenden Variablen als Eingaben berechnet:

  • Die Vorzugshierarchie des Kandidatentyps (lokal, serverreflexiv, peerreflexiv oder weitergeleitet)
  • Die Vorzugshierarchie der spezifischen IP-Adresse des Kandidaten (für multi-homed Agents)
  • Die Komponenten-ID des Kandidaten (1 für RTP, 2 für RTCP)

Die Priorität des Kandidaten wird mit der Formel berechnet (ptype ist die Priorität des Kandidatentyps und plocal ist die Priorität der IP-Adresse):

priority=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)

Dies entspricht der Zuordnung der Prioritäten des Kandidatentyps, der lokalen IP und der Komponenten-ID in verschiedene Bit-Bereiche innerhalb des 32-Bit-priority-Werts.

Spezifikationen

Specification
Identifiers for WebRTC's Statistics API
# dom-rtcicecandidatestats-priority

Browser-Kompatibilität

Siehe auch