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 von der WebRTC API an einen RTCDTMFSender gesendet. Es zeigt an, wann zuvor zum Senden eingereihte DTMF-Töne (durch Aufruf von RTCDTMFSender.insertDTMF()) beginnen und enden.
Prüfen Sie den Wert der tone-Eigenschaft des Ereignisses, um festzustellen, welcher Ton zu spielen begonnen hat oder ob ein Ton aufgehört hat zu spielen.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht nach oben weitergereicht.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("tonechange", (event) => { })
Alternativ können Sie der Event-Handler-Eigenschaft der Schnittstelle einen Wert zuweisen:
ontonechange = (event) => { }
Ereignistyp
Ein RTCDTMFToneChangeEvent. Erbt von Event.
Beispiele
In diesem Beispiel wird ein Handler für das tonechange-Ereignis eingerichtet. Er aktualisiert den Inhalt eines Elements, sodass es den aktuell gespielten Ton anzeigt oder, wenn alle Töne abgespielt wurden, die Zeichenfolge „<none>“.
Dies ist mit addEventListener() möglich:
dtmfSender.addEventListener("tonechange", (ev) => {
let tone = ev.tone;
if (tone === "") {
tone = "<none>";
}
document.getElementById("playingTone").innerText = tone;
});
Sie können die Event-Handler-Eigenschaft ontonechange auch direkt setzen. Beachten Sie jedoch, dass dadurch gegebenenfalls andere über ontonechange hinzugefügte Event-Listener ersetzt werden:
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 |