RTCIceTransport: getSelectedCandidatePair()-Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Die getSelectedCandidatePair()-Methode der RTCIceTransport-Schnittstelle gibt eine RTCIceCandidatePair-Instanz zurück, die das aktuell beste Paar von ICE-Kandidaten enthält, welche die Konfiguration der Endpunkte des Transports beschreiben.
Syntax
getSelectedCandidatePair()
Parameter
Keine.
Rückgabewert
Eine RTCIceCandidatePair-Instanz, die die Konfigurationen des aktuell ausgewählten Kandidatenpaares der local und remote Endpunkte beschreibt.
Der Rückgabewert ist null, wenn noch kein Kandidatenpaar ausgewählt wurde.
Beschreibung
Während der ICE-Agent die Aushandlung einer RTCPeerConnection durchführt, sammelt und analysiert er Kandidatenkonfigurationen von jedem der beiden Peers.
Sobald er ein akzeptables übereinstimmendes Paar von Kandidaten findet, das die Anforderungen für die Verbindung erfüllt, wird ein selectedcandidatepairchange-Ereignis an der RTCIceTransport ausgelöst.
Von diesem Zeitpunkt an kann das beste übereinstimmende Kandidatenpaar immer durch Aufrufen von getSelectedCandidatePair() abgerufen werden.
Während die ICE-Aushandlung weitergeht, wird jedes Mal, wenn ein Kandidatenpaar entdeckt wird, das besser ist als das aktuell ausgewählte Paar, das neue Paar ausgewählt, ersetzt das vorherige Paar 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 ein neueres Paar gewählt wird.
Beispiele
Siehe RTCIceTransport.onselectedcandidatepairchange für Beispielcode.
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcicetransport-getselectedcandidatepair |