RTCDTMFSender

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 RTCDTMFSender-Schnittstelle bietet einen Mechanismus zur Übertragung von DTMF-Codes auf einer WebRTC-RTCPeerConnection. Sie erhalten Zugriff auf den RTCDTMFSender der Verbindung über die RTCRtpSender.dtmf-Eigenschaft der Audiospur, mit der Sie DTMF senden möchten.

Der Hauptzweck der DTMF-Unterstützung von WebRTC besteht darin, WebRTC-basierte Kommunikations-Clients mit einem öffentlichen Telefonnetz (PSTN) oder anderen veralteten Telefondiensten, einschließlich bestehender Voice over IP (VoIP)-Dienste, zu verbinden. Aus diesem Grund kann DTMF nicht zwischen zwei WebRTC-basierten Geräten verwendet werden, da WebRTC keinen Mechanismus zum Empfangen von DTMF-Codes bereitstellt.

Instanz-Eigenschaften

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

Instanz-Methoden

RTCDTMFSender.insertDTMF(): Angesichts eines Strings, der eine Reihe von DTMF-Codes beschreibt, und optional der Dauer und der Zwischenraumzeit der Töne, beginnt insertDTMF() die angegebenen Töne zu senden. Ein Aufruf von insertDTMF() ersetzt alle bereits anstehenden Töne im toneBuffer. Sie können das Senden von geplanten Tönen abbrechen, indem Sie eine leere Zeichenkette ("") als die zu spielenden Töne angeben.

Events

Hören Sie diese Events mit addEventListener() oder durch Zuweisen eines Event-Listeners zur oneventname-Eigenschaft dieser Schnittstelle.

tonechange: Das tonechange-Event wird an den Event-Handler der RTCDTMFSender-Instanz gesendet, um anzuzeigen, dass ein Ton entweder angefangen hat zu spielen oder aufgehört hat.

Beispiel

Sehen Sie den Artikel Verwendung von DTMF mit WebRTC für ein vollständiges Beispiel.

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers # rtcdtmfsender

Browser-Kompatibilität

BCD tables only load in the browser