RTCIceCandidatePairStats: state-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
Die state-Eigenschaft des RTCIceCandidatePairStats-Wörterbuchs zeigt den Status der Checkliste an, deren Mitglied das Kandidatenpaar ist.
Wert
Ein String, dessen Wert einer der folgenden ist:
failed-
Eine Überprüfung für dieses Paar wurde durchgeführt, ist jedoch fehlgeschlagen. Ein Fehler kann auftreten, entweder weil keine Antwort empfangen wurde oder weil die Antwort darauf hinwies, dass ein nicht behebbarer Fehler aufgetreten ist.
frozen-
Für dieses Kandidatenpaar wurde noch keine Überprüfung durchgeführt, und die Durchführung der Überprüfung wird blockiert, bis eine andere Überprüfung erfolgreich ist. Sobald diese Überprüfung erfolgreich war, wird dieses Paar aufgetaut und wechselt in den
waiting-Status. in-progress-
Eine Überprüfung für dieses Paar wurde gestartet, aber die Transaktion der Überprüfung ist noch im Gange.
succeeded-
Eine Überprüfung für dieses Paar wurde erfolgreich abgeschlossen.
waiting-
Dieses Paar wurde noch nicht überprüft, aber die Überprüfung kann durchgeführt werden, sobald dieses Paar das höchstpriorisierte verbleibende Paar im
waiting-Status ist.
Beschreibung
ICE-Checklisten
Während der ICE-Verhandlung erstellt die ICE-Schicht eine Checkliste, die eine Liste von möglichen Paarungen von ICE-Kandidaten ist. Jedes Paar hat einen Status, der durch einen Zeichenfolgenliteral dargestellt wird.
Wenn ein Kandidatenpaar zur Checkliste hinzugefügt wird, beginnt es im frozen-Zustand.
Sobald keine Überprüfungen im Gange sind, die das Paar daran hindern, analysiert zu werden, wird es aufgetaut und wechselt in den waiting-Status.
Dies kann sofort geschehen, wenn das Paar zur Checkliste hinzugefügt wird.
Jedes Mal, wenn ein Kandidatenpaar überprüft wird, wechselt das nächsthöchst priorisierte verbleibende Kandidatenpaar auf der Checkliste vom waiting-Status in den in-progress-Status und seine Überprüfung beginnt.
Wenn die Überprüfung aus irgendeinem Grund fehlschlägt, wechselt das Paar in seinen Endzustand failed.
Wenn die Überprüfung erfolgreich ist, endet das Paar im succeeded-Status.
Der ICE-Checklistenstatus für ein bestimmtes Paar von ICE-Kandidaten kann in der entsprechenden state-Eigenschaft gefunden werden.
Spezifikationen
| Specification |
|---|
| Identifiers for WebRTC's Statistics API # dom-rtcicecandidatepairstats-state |
Browser-Kompatibilität
BCD tables only load in the browser