RTCPeerConnection: signalingstatechange-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Ein signalingstatechange-Ereignis wird an eine RTCPeerConnection gesendet, um sie darüber zu informieren, dass sich ihr Signalisierungsstatus, wie durch die signalingState-Eigenschaft angegeben, geändert hat.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht übergeordnet.
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
Gegeben eine RTCPeerConnection, pc, und eine updateStatus()-Funktion, die Statusinformationen dem Benutzer präsentiert, richtet dieser Code einen Ereignishandler ein, um den Benutzer darüber zu informieren, wann der ICE-Aushandlungsprozess abgeschlossen ist.
pc.addEventListener("signalingstatechange", (ev) => {
switch (pc.signalingState) {
case "stable":
updateStatus("ICE negotiation complete");
break;
}
});
Mit onsignalingstatechange sieht es so aus:
pc.onsignalingstatechange = (ev) => {
switch (pc.signalingState) {
case "stable":
updateStatus("ICE negotiation complete");
break;
}
};
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # event-signalingstatechange |