RTCIceCandidateStats: priority-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2020.
Die priority-Eigenschaft des RTCIceCandidateStats-Dictionaries 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 Aufbau einer WebRTC-Peer-Verbindung werden die Prioritätswerte, die dem entfernten Peer von einem User-Agent gemeldet werden, verwendet, um zu bestimmen, welche Kandidaten als "erwünschter" betrachtet werden. Je höher der Wert, desto erwünschter ist der Kandidat.
Bestimmung der Priorität
Die ICE-Spezifikation beschreibt, wie User Agents und andere Software, die WebRTC verwenden, die Priorität berechnen sollten. Die Priorität eines Kandidaten wird anhand der folgenden Variablen als Eingaben berechnet:
- Die Präferenz des Kandidatentyps (lokal, serverreflexiv, peerreflexiv oder weitergeleitet)
- Die Präferenz der speziellen IP-Adresse des Kandidaten (für mehrheimische Agents)
- Die Komponenten-ID des Kandidaten (1 für RTP, 2 für RTCP)
Die Priorität des Kandidaten wird anhand der folgenden Formel berechnet (ptype ist die Priorität des Kandidatentyps und plocal ist die Priorität der IP-Adresse):
Dies entspricht der Zuordnung der Prioritäten des Kandidatentyps, der lokalen IP und der Komponenten-ID in verschiedene Bitbereiche innerhalb des 32-Bit-priority-Werts.
Spezifikationen
| Specification |
|---|
| Identifiers for WebRTC's Statistics API> # dom-rtcicecandidatestats-priority> |
Browser-Kompatibilität
Siehe auch
- RFC 5245, Abschnitt 4.1.2.1: Abschnitt "Recommended Formula" in der ICE-Spezifikation