RTCPeerConnection: connectionState-Eigenschaft

Baseline 2023

Newly available

Since ⁨May 2023⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die schreibgeschützte connectionState-Eigenschaft der RTCPeerConnection-Schnittstelle gibt den aktuellen Zustand der Peer-Verbindung durch die Rückgabe eines der folgenden String-Werte an: new, connecting, connected, disconnected, failed oder closed.

Dieser Zustand repräsentiert im Wesentlichen den zusammengefassten Zustand aller ICE-Transporte (die vom Typ RTCIceTransport oder RTCDtlsTransport sind), die von der Verbindung verwendet werden.

Ändert sich der Wert dieser Eigenschaft, wird ein connectionstatechange-Ereignis an die RTCPeerConnection-Instanz gesendet.

Wert

Ein String, der den aktuellen Zustand der Verbindung darstellt. Dieser kann einen der folgenden Werte annehmen:

new: Mindestens einer der ICE Transports der Verbindung (RTCIceTransport oder RTCDtlsTransport Objekte) befindet sich im Zustand new, und keiner von ihnen ist in einem der folgenden Zustände: connecting, checking, failed, disconnected, oder alle Transporte der Verbindung sind im Zustand closed.
connecting: Einer oder mehrere der ICE Transports sind aktuell dabei, eine Verbindung herzustellen; das heißt, ihr iceConnectionState ist entweder checking oder connected, und keine Transporte befinden sich im Zustand failed.
connected: Jeder ICE Transport, der von der Verbindung genutzt wird, ist entweder in Gebrauch (Zustand connected oder completed) oder ist geschlossen (Zustand closed); zusätzlich ist mindestens ein Transport entweder connected oder completed.
disconnected: Mindestens einer der ICE Transports der Verbindung befindet sich im Zustand disconnected und keiner der anderen Transporte ist in den Zuständen: failed, connecting oder checking.
failed: Einer oder mehrere der ICE Transports der Verbindung befinden sich im Zustand failed.
closed: Die RTCPeerConnection ist geschlossen.

Beispiel

const peerConnection = new RTCPeerConnection(configuration);

// …

const connectionState = peerConnection.connectionState;

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers # dom-peerconnection-connection-state

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden