RTCPeerConnection: restartIce()-Methode

Die restartIce()-Methode des RTCPeerConnection-Interfaces ermöglicht es einer Webanwendung, dass die Erfassung der ICE-Kandidaten an beiden Enden der Verbindung erneut durchgeführt wird. Dies vereinfacht den Prozess, da dieselbe Methode sowohl vom Anrufer als auch vom Empfänger verwendet werden kann, um einen ICE-Neustart auszulösen.

Nachdem restartIce() zurückgegeben wird, ist das Angebot, das durch den nächsten Aufruf von createOffer() zurückgegeben wird, automatisch so konfiguriert, dass es den ICE-Neustart sowohl am lokalen Teilnehmer (sobald dieser gesetzt wurde) als auch am entfernten Teilnehmer auslöst, sobald das Angebot über Ihren Signalisierungsmechanismus gesendet und die Beschreibung auch vom entfernten Teilnehmer gesetzt wurde.

restartIce() löst das negotiationneeded-Ereignis auf dem RTCPeerConnection aus, um die Anwendung darüber zu informieren, dass sie eine Verhandlung über ihren Signalisierungskanal durchführen sollte.

Wenn die Verhandlung nicht abgeschlossen werden kann - entweder aufgrund eines Rollbacks oder weil eingehende Angebote gerade verhandelt werden - wird sich das RTCPeerConnection merken, dass Sie einen ICE-Neustart angefordert haben. Das nächste Mal, wenn sich der signalingState der Verbindung auf stable ändert, wird das Verbindung das negotiationneeded-Ereignis auslösen. Dieser Prozess setzt sich fort, bis ein ICE-Neustart erfolgreich durchgeführt wurde.

restartIce()

pc.addEventListener("iceconnectionstatechange", (event) => {
  if (pc.iceConnectionState === "failed") {
    /* possibly reconfigure the connection in some way here */
    /* then request ICE restart */
    pc.restartIce();
  }
});