W3cubDocs

/Web APIs

RTCDTMFSender

The RTCDTMFSender interface provides a mechanism for transmitting DTMF codes on a WebRTC RTCPeerConnection. You gain access to the connection's RTCDTMFSender through the RTCRtpSender.dtmf property on the audio track you wish to send DTMF with.

The primary purpose for WebRTC's DTMF support is to allow WebRTC-based communication clients to be connected to a public-switched telephone network (PSTN) or other legacy telephone service, including extant voice over IP (VoIP) services. For that reason, DTMF can't be used between two WebRTC-based devices, because there is no mechanism provided by WebRTC for receiving DTMF codes.

EventTarget RTCDTMFSender

Instance properties

RTCDTMFSender.toneBuffer Read only

A string which contains the list of DTMF tones currently in the queue to be transmitted (tones which have already been played are no longer included in the string). See toneBuffer for details on the format of the tone buffer.

Instance methods

RTCDTMFSender.insertDTMF()

Given a string describing a set of DTMF codes and, optionally, the duration of and inter-tone gap between the tones, insertDTMF() starts sending the specified tones. Calling insertDTMF() replaces any already-pending tones from the toneBuffer. You can abort sending queued tones by specifying an empty string ("") as the set of tones to play.

Events

Listen to these events using addEventListener() or by assigning an event listener to the oneventname property of this interface.

tonechange

The tonechange event is sent to the RTCDTMFSender instance's event handler to indicate that a tone has either started or stopped playing.

Example

See the article Using DTMF with WebRTC for a full example.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
RTCDTMFSender 27 79 52 No 15 13.1 4.4 27 52 15 13.4 1.5
canInsertDTMF 27 79 No No 15 13.1 4.4 27 No 15 13.4 1.5
insertDTMF 27 79 52 No 15 13.1 4.4 27 52 15 13.4 1.5
toneBuffer 27 79 52 No 15 13.1 4.4 27 52 15 13.4 1.5
tonechange_event 27 79 52 No 15 13.1 4.4 27 52 15 13.4 1.5

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCDTMFSender