This API is available on Firefox OS for internal applications only.
The Telephony
interface of the Web Telephony API provides support for dialing, answering, and managing phone calls on a device with telephony support.
Properties
Telephony.active
Read only- 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 theTelephony.startTone()
method. Telephony.calls
Read only- An array of
TelephonyCall
objects, one for each call that is currently connected. Telephony.conferenceGroup
Read only- A
TelephonyCallGroup
object, allowing programmatic control over a multi-person call/conference call. Telephony.muted
- Set to
true
to mute the microphone orfalse
to enable the microphone. Telephony.ready
Read only- Provides an asynchronous notification that the
Telephony
object has been initialized successfully. Telephony.speakerEnabled
- Set to
true
to enable the speakerphone functionality orfalse
to disable it.
Event Handlers
Telephony.oncallschanged
- A handler for the
callschanged
event; thisCallEvent
event is sent whenever thecalls
list changes. Telephony.onincoming
- A handler for the
incoming
event; thisCallEvent
is sent whenever a new call is incoming. Telephony.onremoteheld
- A handler for the
remoteheld
event; thisCallEvent
is sent whenever a remote party (e.g. the person you called) puts the call on hold. Telephony.onremoteresumed
- A handler for the
remoteheld
event; thisCallEvent
is sent when a remote party (e.g. the person you called) resumes a call previously put on hold.
Obsolete event handlers
Telephony.onready
- A handler for the
ready
event; thisCallEvent
is sent when the telephony object is initialized. This was implemented in Firefox OS 2.1, but obsoleted by the promise-basedTelephony.ready
property in Firefox OS 2.2.
Methods
Telephony.dial()
- Dials the specified phone number or MMI code.
Telephony.dialEmergency()
- Dials the specified emergency phone number.
Telephony.ownAudioChannel()
- Designates the calling app as the owner of the telephony calls from the AudioChannel policy.
Telephony.sendTones()
- Generates and sends specific DTMF tones.
Telephony.startTone()
- Begins generating the specified DTMF tone.
Telephony.stopTone()
- Stops generating the currently sounding DTMF tone.
Examples
// Telephony object var tel = navigator.mozTelephony; // Place a call tel.dial("123456789").then(function(call) { call.number; }); // Receive a call tel.onincoming = function (e) { var incomingCall = e.call; // Get the id/number of the incoming call console.log(incomingCall.id); // Answer the call incomingCall.answer(); };
Specifications
Specification | Status | Comment |
---|---|---|
Web Telephony | Draft | Draft |
Browser compatibility
For obvious reasons, support is primarily expected on mobile browsers.
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | No support | No support | No support | No support | No support |
ownAudioChannel() |
No support | No support | No support | No support | No support |
Feature | Android | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | No support | 12.0 (12.0) | 1.0.1 | No support | No support | No support |
ownAudioChannel() |
No support | ? | 2.5 | No support | No support | No support |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
chrisdavidmills,
teoli,
fscholz,
kollishivagangadhar,
kscarfone,
Jeremie,
Sheppy
Last updated by:
chrisdavidmills,