RTCIceCandidate: foundation-Eigenschaft

Baseline 2024
Newly available

Since May 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die foundation-Eigenschaft der Schnittstelle RTCIceCandidate ist eine schreibgeschützte Zeichenfolge, die es ermöglicht, Kandidaten von einem gemeinsamen Netzwerkpfad auf mehreren RTCIceTransport-Objekten zu korrelieren.

Kandidaten teilen dieselbe foundation, wenn sie:

  • denselben Typ haben: "host", "relayed", "server reflexive" oder "peer reflexive".
  • "Basen" haben, die dieselbe IP-Adresse und denselben Transport teilen, aber nicht unbedingt denselben Port. Beachten Sie, dass die IP-Adresse die der Netzwerkschnittstelle ist, von der der ICE-Agent den Kandidaten gesendet hat.
  • von einem STUN- oder TURN-Server stammen, der dieselbe IP-Adresse hat.

Dies wird verwendet, um die ICE-Leistung zu optimieren, während die Priorisierung und Korrelation von Kandidaten, die auf mehreren RTCIceTransport-Objekten erscheinen, priorisiert werden.

Wert

Eine Zeichenfolge, die den Kandidaten eindeutig über alle RTCIceTransports identifiziert, auf denen er verfügbar ist.

Hinweis: Wenn port null ist — und port vom User-Agent unterstützt wird — wird das Übergeben des Kandidaten an addIceCandidate() fehlschlagen und eine OperationError-Ausnahme auslösen.

Nutzungshinweise

Betrachten Sie diese SDP-Attributzeile (a-line), die einen ICE-Kandidaten beschreibt:

a=candidate:4234997325 1 udp 2043278322 192.0.2.172 44323 typ host

Das Feld "4234997325" ist die foundation.

Beispiele

Dieser Codeausschnitt verwendet die foundation von zwei Kandidaten, um festzustellen, ob sie tatsächlich derselbe Kandidat sind.

js
if (candidate1.foundation === candidate2.foundation) {
  /* the two candidates are the same, even if they're on
     different transports */
}

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcicecandidate-foundation

Browser-Kompatibilität