RTCIceTransport: getSelectedCandidatePair() Methode

Die getSelectedCandidatePair()-Methode der RTCIceTransport-Schnittstelle gibt ein RTCIceCandidatePair-Objekt zurück, das das aktuell beste ICE-Kandidatenpaar beschreibt, welches die Konfiguration der Endpunkte des Transports darstellt.

Syntax

js
getSelectedCandidatePair()

Parameter

Keine.

Rückgabewert

Ein RTCIceCandidatePair-Objekt, das die Konfigurationen der aktuell ausgewählten Endpunkte des Kandidatenpaares beschreibt. local beschreibt die Konfiguration des lokalen Endes der Verbindung, während remote die Konfiguration des entfernten Peers beschreibt.

Der Rückgabewert ist null, wenn noch kein Kandidatenpaar ausgewählt wurde.

Verwendungshinweise

Während der ICE-Agent die Verhandlung einer RTCPeerConnection durchführt, sammelt und analysiert er Kandidatenkonfigurationen von beiden Peers. Sobald ein akzeptables übereinstimmendes Kandidatenpaar gefunden wird, das die Anforderungen für die Verbindung erfüllt, wird ein selectedcandidatepairchange Ereignis beim RTCIceTransport ausgelöst. Von diesem Zeitpunkt an ist das am besten passende Kandidatenpaar immer verfügbar, indem getSelectedCandidatePair() aufgerufen wird.

Wenn die ICE-Verhandlung fortgesetzt wird und ein Kandidatenpaar entdeckt wird, das besser ist als das derzeit ausgewählte, wird das neue Paar ausgewählt, das vorherige Paar wird ersetzt, und das selectedcandidatepairchange Ereignis wird erneut ausgelöst.

Hinweis: Es ist möglich, dass eine der Konfigurationen im ausgewählten Kandidatenpaar unverändert bleibt, wenn eine neue Paarung gewählt wird.

Beispiele

Siehe RTCIceTransport.onselectedcandidatepairchange für Beispielcode.

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcicetransport-getselectedcandidatepair

Browser-Kompatibilität

BCD tables only load in the browser