RTCDTMFSender
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
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn derRTCDTMFSender
in der Lage ist, DTMF-Töne zu senden, oderfalse
, wenn nicht. RTCDTMFSender.toneBuffer
Schreibgeschützt-
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 voninsertDTMF()
ersetzt alle bereits anstehenden Töne imtoneBuffer
. 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 derRTCDTMFSender
-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