mozilla

Telephony

この記事はまだ日本語に翻訳されていません。MDN の翻訳はボランティアによって行われています。是非 MDN に登録し、私たちの力になって下さい。

Non-standard
This feature is not on a current W3C standards track, but it is supported on the Firefox OS platform. Although implementations may change in the future and it is not supported widely across browsers, it is suitable for use in code dedicated to Firefox OS apps.

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 the Telephony.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 or false 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 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.
Telephony.onremoteheld
A handler for the remoteheld event; this CallEvent 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; this CallEvent 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; this CallEvent is sent when the telephony object is initialized. This was implemented in Firefox OS 2.1, but obsoleted by the promise-based Telephony.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.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 Not supported Not supported Not supported Not supported Not supported
Feature Android Firefox Mobile (Gecko) Firefox OS (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support Not supported 12.0 (12.0) 1.0.1 Not supported Not supported Not supported

See also

ドキュメントのタグと貢献者

最終更新者: chrisdavidmills,