RTCPeerConnection: signalingstatechange-Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Ein signalingstatechange-Ereignis wird an eine RTCPeerConnection gesendet, um darauf hinzuweisen, dass sich ihr Signalisierungsstatus, wie durch die signalingState-Eigenschaft angezeigt, geändert hat.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergeleitet.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

addEventListener("signalingstatechange", (event) => { })

onsignalingstatechange = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

Angenommen, es gibt eine RTCPeerConnection, pc, und eine updateStatus()-Funktion, die Statusinformationen dem Nutzer präsentiert, zeigt dieser Code, wie ein Ereignishandler eingerichtet wird, um den Nutzer darüber zu informieren, wenn der ICE-Aushandlungsprozess abgeschlossen ist.

pc.addEventListener(
  "signalingstatechange",
  (ev) => {
    switch (pc.signalingState) {
      case "stable":
        updateStatus("ICE negotiation complete");
        break;
    }
  },
  false,
);

Mit onsignalingstatechange sieht es so aus:

pc.onsignalingstatechange = (ev) => {
  switch (pc.signalingState) {
    case "stable":
      updateStatus("ICE negotiation complete");
      break;
  }
};

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers # event-signalingstatechange