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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
foundation

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support