RTCDTMFSender.insertDTMF

The insertDTMF() method on the RTCDTMFSender interface starts sending DTMF tones to the remote peer over the RTCPeerConnection. Sending of the tones is performed asynchronously, with tonechange events sent to the RTCDTMFSender every time a tone starts or ends.

Syntax

RTCDTMFSender.insertDTMF(tones[, duration[, interToneGap]]);

Parameters

tones

A DOMString containing the DTMF codes to be transmitted to the recipient.

duration Optional

The amount of time, in milliseconds, that each DTMF tone should last. This value must be between 40 ms and 6000 ms (6 seconds), inclusive. The default is 100 ms.

interToneGap Optional

The length of time, in milliseconds, to wait between tones. The browser will enforce a minimum value of 30 ms (that is, if you specify a lower value, 30 ms will be used instead); the default is 70 ms.

Return value

undefined

Exceptions

InvalidStateError

The DTMF tones couldn't be sent because the track has been stopped, or is in a read-only or inactive state.

InvalidCharacterError

One or more of the characters in tones is not valid DTMF.

Example

tbd

Specifications

Specification	Status	Comment
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCDTMFSender.insertDTMF()' in that specification.	Working Draft

Browser compatibility

See also

• WebRTC API
• Using DTMF with WebRTC
• RTCPeerConnection
• RTCDTMFSender
• RTCRtpSender