RTCDTMFSender

Baseline Widely available *

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

* Some parts of this feature may have varying levels of support.

Das RTCDTMFSender-Interface bietet einen Mechanismus zum Übertragen von DTMF-Codes auf einer WebRTC-RTCPeerConnection. Sie erhalten Zugriff auf den RTCDTMFSender der Verbindung über die RTCRtpSender.dtmf-Eigenschaft auf dem Audiotrack, mit dem Sie DTMF senden möchten.

Der Hauptzweck der DTMF-Unterstützung in WebRTC besteht darin, dass WebRTC-basierte Kommunikationsclients mit einem öffentlichen Telefonnetz (PSTN) oder anderen älteren Telefondiensten, einschließlich bestehender Voice-over-IP (VoIP)-Dienste, verbunden werden können. Aus diesem Grund kann DTMF nicht zwischen zwei WebRTC-basierten Geräten verwendet werden, da WebRTC keinen Mechanismus zum Empfangen von DTMF-Codes bietet.

Instanzeigenschaften

RTCDTMFSender.canInsertDTMF Schreibgeschützt: Ein boolescher Wert, der true ist, wenn der RTCDTMFSender in der Lage ist, DTMF-Töne zu senden, oder false, wenn nicht.
RTCDTMFSender.toneBuffer Schreibgeschützt: Ein String, der die Liste der DTMF-Töne enthält, die sich momentan in der Warteschlange zur Übertragung befinden (Töne, die bereits abgespielt wurden, sind nicht mehr im String enthalten). Siehe toneBuffer für Details zum Format des Tone-Buffers.

Instanzmethoden

RTCDTMFSender.insertDTMF(): Wenn ein String, der eine Reihe von DTMF-Codes beschreibt, und optional die Dauer und die Zwischentonlücke zwischen den Tönen angegeben werden, beginnt insertDTMF(), die angegebenen Töne zu senden. Ein Aufruf von insertDTMF() ersetzt alle bereits ausstehenden Töne aus dem toneBuffer. Sie können das Senden der in der Warteschlange befindlichen Töne abbrechen, indem Sie eine leere Zeichenkette ("") als die zu spielende Toneset angeben.

Ereignisse

Hören Sie diese Ereignisse mithilfe von addEventListener() ab oder indem Sie einen Ereignis-Listener auf die oneventname-Eigenschaft dieses Interfaces setzen.

tonechange: Das tonechange-Ereignis wird an den Ereignishandler der RTCDTMFSender-Instanz gesendet, um anzuzeigen, dass ein Ton entweder gestartet oder gestoppt wurde.

Beispiel

Sehen Sie sich den Artikel Using DTMF with WebRTC für ein vollständiges Beispiel an.

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers # rtcdtmfsender