Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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):

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 Bitbereiche innerhalb des 32-Bit-priority-Werts.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch