この API は 認定済みアプリのみ、 Firefox OS で有効になります。
Web Telephony は、Web コンテンツが JavaScript を使用して音声通話を扱うことを可能にする API です。
コンセプトと使用例
Web Telephony API は、Firefox OS のテレフォニー機能を制御する API 要件を満たすため、Mozilla により作成されました。この API は、サードパーティの開発者にこのようなクリティカルな端末機能の制御を許可するとセキュリティの懸念事項となるため、システム内部からのみ使用できます。
この API のエントリポイントは、Navigator.mozTelephony プロパティを通して提供されます。このプロパティは、Telephony オブジェクトを返し、マイクやスピーカー、ダイヤルトーン (DTMF) の生成、通話の発着信、その他の機能を制御するためのメソッドとプロパティを含む、端末のテレフォニーシステムへのアクセスを提供します。
端末が Telephony.dial() を使用してダイヤル発信するか Telephony.onincoming イベントハンドラを経由してどこかからの着信により通話が初期化されると、通話を表す TelephonyCall オブジェクトが生成されます。このオブジェクトのプロパティとメソッドを通して通話を操作でき、プログラム返答や通話終了、保留、異なる通話状態への応答などができます。
複数人でのグループ通話を制御するための TelephonyCallGroup インターフェイスも利用できます。
注記: Web Telephony API を使い始めるためのサンプルコードは、Web Telephony API の使用 を参照してください。
Manifest の許可設定
この API を Firefox OS アプリで使用するには、manifest.webapp ファイルに以下を記述する必要があります:
"type": "certified",
"permissions": {
"telephony": {
"description": "Required to control telephony functions"
}
},
Web テレフォニーインターフェイス
Navigator.mozTelephony- Web Telephony API のためのエントリポイント。
Telephonyオブジェクトにアクセスできます。 Telephony- 端末のテレフォニー機能の制御を提供します。
TelephonyCall- 電話の通話を表します。通話の着信や発信などの機能を制御できます。
MMICall- MMI コールを表します。通話の結果を受け取れるようにします。
TelephonyCallGroup- 複数人でのグループ通話を表します。発信者がグループ通話を追加や削除したり、通話全体をハングアップする機能などを提供します。
CallEvent- 電話の通話に関連するイベントを表します。
仕様
| Specification | Status | Comment |
|---|---|---|
| Web Telephony | ドラフト | Draft |
ブラウザ実装状況
明らかな理由により、サポートはモバイルブラウザが優先されます。
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート |
| 機能 | Android | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| 基本サポート | 未サポート | 12.0 (12.0) | 1.0.1 | 未サポート | 未サポート | 未サポート |