This API is available on Firefox OS for web content or higher privileged applications.
概要
アプリケーションはこのメソッドを使って、システムからのメッセージを処理してそれに反応する関数を登録できます。
どのアプリケーションをどのメッセージに対して登録することもできますが、対応する許可設定があるアプリケーションにのみ送信されるメッセージもあります。例えば sms-received メッセージは sms の許可設定があるアプリケーションにのみ送信されます。
システムメッセージは DOM イベントとは反対に、アプリケーションにそのハンドラーがない場合にはキューに残り続けます。アプリケーションにキューに入ったメッセージがあるかは、引数として適切なタイプを渡して navigator.mozHasPendingMessage() を呼ぶことでチェックできます。メッセージハンドラーが設定されると、キューにある全メッセージが非同期にアプリケーションに渡されます。
構文
navigator.mozSetMessageHandler(type, handler);
引数
type- type は、登録するハンドラーがどの種類のメッセージ用かを表す文字列です。
handler- システムがメッセージを送信するとハンドラーが呼ばれます。ハンドラーが受け取る引数はメッセージタイプによって決まります。
メッセージタイプ
現在、Firefox OS では以下のメッセージを登録できます。
| メッセージ名 | ハンドラーのシグニチャー | 許可設定 |
|---|---|---|
activity |
f( |
|
alarm |
f( object unknown ) |
alarms |
bluetooth-cancel |
f( object unknown ) |
bluetooth |
bluetooth-dialer-command |
f( object unknown ) |
bluetooth |
bluetooth-hfp-status-changed |
f( object unknown ) |
bluetooth |
bluetooth-opp-transfer-start |
f( object unknown ) |
bluetooth |
bluetooth-opp-transfer-complete |
f( object unknown ) |
bluetooth |
bluetooth-opp-receiving-file-confirmation |
f( object unknown ) |
bluetooth |
bluetooth-opp-update-progress |
f( object unknown ) |
bluetooth |
bluetooth-pairedstatuschanged |
f( object unknown ) |
bluetooth |
bluetooth-requestconfirmation |
f( object unknown ) |
bluetooth |
bluetooth-requestpincode |
f( object unknown ) |
bluetooth |
bluetooth-requestpasskey |
f( object unknown ) |
bluetooth |
headset-button |
f( object unknown ) |
|
icc-stkcommand |
f( object command ) |
settings |
notification |
f( object unknown ) |
|
push |
f( object registration ) |
push |
push-register |
f ( ) |
push |
sms-received |
f( |
sms |
sms-sent |
f( |
sms |
telephony-call-ended |
f( object call ) |
telephony |
telephony-new-call |
f( ) |
telephony |
ussd-received |
f( object ussd ) |
mobileconnection |
wappush-received |
f( object wappush ) |
wappush |
仕様
| 仕様 | 状態 | 注 |
|---|---|---|
| Unknown | 草案 | システムメッセージングのインターフェイスを定義。 |
ブラウザー互換性
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート |
| Feature | Android | Firefox OS | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | 未サポート | 1.0 | 未サポート | 未サポート | 未サポート | 未サポート |