RTCDTMFSender: tonechange-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2020 browserübergreifend verfügbar.
Das tonechange-Ereignis wird an einen RTCDTMFSender von der WebRTC API gesendet, um anzuzeigen, wann DTMF-Töne, die zuvor für das Senden in die Warteschlange gestellt wurden (durch Aufrufen von RTCDTMFSender.insertDTMF()), beginnen und enden.
Um festzustellen, welcher Ton zu spielen begonnen hat oder ob ein Ton aufgehört hat zu spielen, überprüfen Sie den Wert der tone-Eigenschaft des Ereignisses.
Dieses Ereignis ist nicht abbruchbar und tritt nicht in der Ereignisblase auf.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("tonechange", (event) => { })
ontonechange = (event) => { }
Ereignistyp
Ein RTCDTMFToneChangeEvent. Erbt von Event.
Beispiele
Dieses Beispiel erstellt einen Handler für das tonechange-Ereignis, der ein Element aktualisiert, um den derzeit gespielten Ton in seinem Inhalt anzuzeigen, oder, wenn alle Töne gespielt wurden, die Zeichenkette "<none>".
Dies kann mit addEventListener() durchgeführt werden:
dtmfSender.addEventListener("tonechange", (ev) => {
let tone = ev.tone;
if (tone === "") {
tone = "<none>";
}
document.getElementById("playingTone").innerText = tone;
});
Sie können auch einfach die ontonechange-Ereignishandler-Eigenschaft direkt setzen:
dtmfSender.ontonechange = (ev) => {
let tone = ev.tone;
if (tone === "") {
tone = "<none>";
}
document.getElementById("playingTone").innerText = tone;
};
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # event-RTCDTMFSender-tonechange |