RTCDTMFSender: tonechange-Event
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2020.
Das tonechange
-Event wird von der WebRTC API an einen RTCDTMFSender
gesendet, um anzuzeigen, wann DTMF-Töne, die zuvor zur Übertragung in die Warteschlange gestellt wurden (durch Aufrufen von RTCDTMFSender.insertDTMF()
), beginnen und enden.
Um festzustellen, welcher Ton abgespielt wurde oder ob ein Ton gestoppt wurde, überprüfen Sie den Wert der tone
-Eigenschaft des Events.
Dieses Ereignis kann nicht abgebrochen werden und blubbert nicht.
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
.
Ereigniseigenschaften
Zusätzlich zu den Eigenschaften von Event
bietet dieses Interface folgende:
RTCDTMFToneChangeEvent.tone
Schreibgeschützt-
Ein String, der den Ton angibt, der begonnen hat zu spielen, oder ein leerer String (
""
), wenn der vorherige Ton aufgehört hat zu spielen.
Beispiele
Dieses Beispiel richtet einen Handler für das tonechange
-Event ein, der ein Element aktualisiert, um den aktuell abgespielten Ton in seinem Inhalt anzuzeigen, oder, wenn alle Töne abgespielt wurden, den String "<none>".
Dies kann mit addEventListener()
erfolgen:
dtmfSender.addEventListener("tonechange", (ev) => {
let tone = ev.tone;
if (tone === "") {
tone = "<none>";
}
document.getElementById("playingTone").innerText = tone;
});
Sie können auch einfach die ontonechange
-Ereignishandlereigenschaft direkt setzen:
dtmfSender.ontonechange = (ev) => {
let tone = ev.tone;
if (tone === "") {
tone = "<none>";
}
document.getElementById("playingTone").innerText = tone;
};
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers> # event-RTCDTMFSender-tonechange> |
Browser-Kompatibilität
Loading…