Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

js
addEventListener("tonechange", (event) => { })

ontonechange = (event) => { }

Ereignistyp

Ein RTCDTMFToneChangeEvent. Erbt von Event.

Event RTCDTMFToneChangeEvent

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:

js
dtmfSender.addEventListener("tonechange", (ev) => {
  let tone = ev.tone;
  if (tone === "") {
    tone = "&lt;none&gt;";
  }

  document.getElementById("playingTone").innerText = tone;
});

Sie können auch einfach die ontonechange-Ereignishandlereigenschaft direkt setzen:

js
dtmfSender.ontonechange = (ev) => {
  let tone = ev.tone;
  if (tone === "") {
    tone = "&lt;none&gt;";
  }

  document.getElementById("playingTone").innerText = tone;
};

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# event-RTCDTMFSender-tonechange

Browser-Kompatibilität