RTCIceCandidate: Eigenschaft der Foundation

Die schreibgeschützte Eigenschaft foundation der RTCIceCandidate Schnittstelle ist ein String, der den Kandidaten eindeutig über mehrere Transporte hinweg identifiziert.

Die foundation kann daher verwendet werden, um Kandidaten zu korrelieren, die auf mehreren RTCIceTransport Objekten vorhanden sind.

Wert

Ein String, der den Kandidaten über alle RTCIceTransports, auf denen er verfügbar ist, eindeutig identifiziert.

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.

Verwendungshinweise

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

Dieses Code-Snippet 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

BCD tables only load in the browser