非標準
この機能は現在 W3C の標準化のプロセスに乗っていませんが、Firefox OS プラットフォームではサポートされています。将来は動作が変わるかもしれませんし、他のブラウザーで広くサポートされているわけでもありませんが、Firefox OS アプリ専用のコードで使うには適しています。
この API は 認定済みアプリのみ、 Firefox OS で有効になります。
Web Bluetooth API のインターフェースである BluetoothManager は、デバイス上の全てのBluetoothアダプタへのアクセスを許可します。このアダプタはデバイスと他のBluetoothデバイスを接続するためのインターフェースです。
インターフェース概要
[CheckPermissions="bluetooth"]
interface BluetoothManager: EventTarget
{
readonly attribute BluetoothAdapter? defaultAdapter;
attribute EventHandler onattributechanged;
attribute EventHandler onadapteradded;
attribute EventHandler onadapterremoved;
sequence<BluetoothAdapter> getAdapters();
};
プロパティ
BluetoothManager.enabled読取専用- Bluetoohがオン(true) またはオフ(false)を示すbool値。
イベントハンドラ
BluetoothManager.onadapteraddedadapteraddedイベントが発火した際に実行されるハンドラ。これはデバイス上でBluetoothアダプタが有効になったとき発生します。BluetoothManager.onadapterremovedadapterremovedイベントが発火した際に実行されるハンドラ。これはデバイス上でBluetoothアダプタが無効にされたか取り外された場合に発生します。BluetoothManager.onattributechangedattributechangedイベントが発火した際に実行されるハンドラ。これはBluetoothManager.defaultAdapterプロパティが変化した際に発生します。
注: BluetoothManager インターフェースは EventTarget インターフェースを継承しているため、全てのイベントは addEventListener メソッドを使用して監視することが可能です。
廃止イベントハンドラ
BluetoothManager.onenabledenabledイベントが発火した際に実行されるハンドラ。 これはBluetoothが有効になった際に発生します。BluetoothManager.ondisableddisabledイベントが発火した際に実行されるハンドラ。 これはBluetoothが無効になった際に発生します。
メソッド
BluetoothManager.getAdapters()- 現在デバイスで使用されている
BluetoothAdapterのリストを返します。
廃止メソッド
BluetoothManager.getDefaultAdapter()- デバイスで使用されているデフォルトアダプタを取得します。これはオペレーションの成功または失敗を取得するための
DOMRequestを返します。成功した場合、リクエストの結果はBluetoothAdapterオブジェクトです。このメソッドはBluetoothManager.getAdapters()に置き換えられました。
仕様
| Specification | Status | Comment |
|---|---|---|
| Web Bluetooth BluetoothManager の定義 |
ドラフト | 草案。これは正式な仕様ではありません。W3C's System Applications Working Group で協議が必要です |
ブラウザの互換性
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート |
| Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|---|
Bluetooth 'v2' support: getAdapters(), onattributechange, onadapterremoved |
未サポート | 未サポート | 未サポート | 2.1 | 未サポート | 未サポート | 未サポート | 未サポート |
Bluetooth initial support: getDefaultAdapter(), onenabled, ondisabled, onadapteradded |
未サポート | 未サポート | 未サポート | 1.0.1 | 未サポート | 未サポート | 未サポート | 未サポート |
参考