RTCDTMFToneChangeEvent

Baseline Widely available

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

Die RTCDTMFToneChangeEvent-Schnittstelle repräsentiert Ereignisse, die gesendet werden, um anzuzeigen, dass DTMF-Töne angefangen oder aufgehört haben zu spielen. Diese Schnittstelle wird vom tonechange-Ereignis verwendet.

Event RTCDTMFToneChangeEvent

Instanz-Eigenschaften

Zusätzlich zu den Eigenschaften von Event bietet diese Schnittstelle Folgendes:

RTCDTMFToneChangeEvent.tone Nur lesbar

Ein String, der den Ton angibt, der zu spielen begonnen hat, oder ein leerer String (""), wenn der vorherige Ton aufgehört hat zu spielen.

Konstruktoren

RTCDTMFToneChangeEvent()

Gibt ein neues RTCDTMFToneChangeEvent zurück. Es nimmt zwei Parameter an, der erste ist ein String, der den Typ des Ereignisses darstellt (immer "tonechange"); der zweite ist ein Wörterbuch, das den Anfangszustand der Eigenschaften des Ereignisses enthält.

Instanz-Methoden

Unterstützt die in Event definierten Methoden. Es gibt keine zusätzlichen Methoden.

Beispiele

Dieser Code-Ausschnitt ist lose entnommen aus dem vollständigen, funktionierenden Beispiel, das Sie im Abschnitt über Wenn ein Ton zu spielen aufhört finden. Es fügt jeden Ton einer Anzeigebox hinzu, während er gespielt wird, und sobald alle Töne gesendet wurden, wird ein zuvor deaktivierter "Senden"-Button wieder aktiviert, sodass die nächste DTMF-Zeichenkette eingegeben werden kann.

js
dtmfSender.addEventListener(
  "change",
  (event) => {
    if (event.tone !== "") {
      dialStringBox.innerText += event.tone;
    } else {
      sendDTMFButton.disabled = false;
    }
  },
  false,
);

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcdtmftonechangeevent

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch