Telephony

Summary

Provides support for dialing, answering, and managing phone calls on a device with telephony support.

Properties

Telephony.active

A TelephonyCall object indicating the call that is currently active. The active call is the one receiving input from the microphone and any tones generated using the Telephony.startTone() method.

Telephony.calls

An array of TelephonyCall objects, one for each call that is currently connected.

Telephony.muted

Set to true to mute the microphone or false to enable the microphone.

Telephony.speakerEnabled

Set to true to enable the speakerphone functionality or false to disable it.

Event Handlers

Telephony.oncallschanged

A handler for the callschanged event; this CallEvent event is sent whenever the calls list changes.

Telephony.onincoming

A handler for the incoming event; this CallEvent is sent whenever a new call is incoming.

Methods

Telephony.dial()

Dials the specified phone number, which is specified as a string.

Telephony.startTone()

Begins generating the specified DTMF tone.

Telephony.stopTone()

Stops generating the currently sounding DTMF tone.

Specifications

This is a non standard implementation, but it is discussed at W3C as part of the System Application Working Group.

Browser compatibility

For obvious reasons, support is primarily expected on mobile browsers.

See also

• Using the Telephony API
• TelephonyCall
• CallEvent
• window.navigator.mozTelephony