RTCIceTransport: state-Eigenschaft

Ein String, dessen Wert einer der folgenden ist:

"new"

Der RTCIceTransport sammelt derzeit lokale Kandidaten oder wartet darauf, dass das Remote-Gerät beginnt, die Remote-Kandidaten zu übertragen, oder beides. In diesem Zustand hat das Prüfen von Kandidaten auf solche, die möglicherweise akzeptabel sind, noch nicht begonnen.

"checking"

Es wurde mindestens ein Remote-Kandidat empfangen und der RTCIceTransport hat begonnen, Paarungen von Remote- und lokalen Kandidaten zu untersuchen, um zu versuchen, geeignete Paare zu identifizieren, die zur Herstellung einer Verbindung verwendet werden könnten. Beachten Sie, dass das Sammeln von lokalen Kandidaten noch im Gange sein kann und das Remote-Gerät möglicherweise auch noch eigene Kandidaten sammelt.

"connected"

Ein geeignetes Kandidatenpaar wurde gefunden und ausgewählt, und der RTCIceTransport hat die beiden Peers mit diesem Paar verbunden. Es gibt jedoch noch Kandidatenpaarungen zu berücksichtigen, und es kann weiterhin auf einem oder beiden Geräten gesammelt werden.

Der Transport kann vom Zustand "connected" in den Zustand "checking" zurückfallen, wenn ein Peer beschließt, die Zustimmung zur Verwendung des ausgewählten Kandidatenpaares zu widerrufen, und kann in "disconnected" zurückfallen, wenn keine Kandidaten mehr zu überprüfen sind, aber einer oder beide Clients noch Kandidaten sammeln.

"completed"

Der Transport hat das Sammeln lokaler Kandidaten abgeschlossen und hat eine Benachrichtigung vom Remote-Peer erhalten, dass keine weiteren Kandidaten gesendet werden. Außerdem wurden alle Kandidatenpaare betrachtet und ein Paar zur Verwendung ausgewählt. Wenn Zustimmungsüberprüfungen bei allen erfolgreichen Kandidatenpaaren fehlschlagen, ändert sich der Transportzustand in "failed".

"disconnected"

Der ICE-Agent hat festgestellt, dass die Konnektivität für diesen RTCIceTransport verloren gegangen ist. Dies ist kein Fehlerzustand (das ist "failed"). Ein Wert von "disconnected" bedeutet, dass ein flüchtiges Problem aufgetreten ist, das die Verbindung unterbrochen hat, sich jedoch automatisch lösen sollte, ohne dass Ihr Code irgendwelche Maßnahmen ergreifen muss. Siehe Der getrennte Zustand für weitere Details.

"failed"

Der RTCIceTransport hat den Sammelprozess abgeschlossen, die Benachrichtigung "keine weiteren Kandidaten" vom Remote-Peer erhalten und das Prüfen von Kandidatenpaaren abgeschlossen, ohne erfolgreich ein Paar zu finden, das sowohl gültig ist als auch für das Zustimmung erteilt werden kann. Dies ist ein endgültiger Zustand, der anzeigt, dass die Verbindung nicht erreicht oder aufrechterhalten werden kann.

"closed"

Der Transport hat heruntergefahren und reagiert nicht mehr auf STUN-Anfragen.

Wenn ein ICE-Neustart erfolgt, wird der Prozess des Kandidatensammelns und der Konnektivitätsprüfung von vorne begonnen; dies wird einen Übergang vom Zustand "connected" verursachen, wenn der Neustart erfolgte, während der Zustand "completed" war. Wenn der Neustart während eines flüchtigen Zustands "disconnected" erfolgte, wechselt der Zustand zu "checking".

"disconnected" ist ein flüchtiger Zustand, der auftritt, wenn die Verbindung zwischen den beiden Peers auf eine Weise scheitert, die die WebRTC-Infrastruktur automatisch korrigieren kann, sobald die Verbindung wieder verfügbar ist. Es ist kein Fehlerzustand. Stattdessen kann man "disconnected" als ähnlich "checking" betrachten, jedoch mit der zusätzlichen Information, dass die Verbindung funktionierte, aber im Moment nicht funktioniert.

Jeder Benutzeragent und jede Plattform kann eigene Szenarien haben, die den "disconnected"-Zustand auslösen können. Mögliche Ursachen sind:

• Die Netzwerkschnittstelle, die von der Verbindung verwendet wird, ist offline gegangen.
• STUN-Anfragen, die an das Remote-Gerät gesendet werden, bleiben wiederholt unbeantwortet.

Der "disconnected"-Zustand kann auch auftreten, wenn der Transport das Prüfen aller vorhandenen Kandidatenpaare abgeschlossen hat und kein funktionierendes Paar gefunden wurde - oder ein gültiges Paar gefunden wurde, aber aufgrund verweigerter Zustimmung, das Paar zu verwenden, abgelehnt wurde. In diesem Szenario fährt der Transport fort, Kandidaten zu sammeln und/oder auf Kandidaten zu warten, die vom Remote-Peer gesendet werden.