非標準
この機能は現在 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.onadapteradded
adapteradded
イベントが発火した際に実行されるハンドラ。これはデバイス上でBluetoothアダプタが有効になったとき発生します。BluetoothManager.onadapterremoved
adapterremoved
イベントが発火した際に実行されるハンドラ。これはデバイス上でBluetoothアダプタが無効にされたか取り外された場合に発生します。BluetoothManager.onattributechanged
attributechanged
イベントが発火した際に実行されるハンドラ。これはBluetoothManager.defaultAdapter
プロパティが変化した際に発生します。
注: BluetoothManager
インターフェースは EventTarget
インターフェースを継承しているため、全てのイベントは addEventListener
メソッドを使用して監視することが可能です。
廃止イベントハンドラ
BluetoothManager.onenabled
enabled
イベントが発火した際に実行されるハンドラ。 これはBluetoothが有効になった際に発生します。BluetoothManager.ondisabled
disabled
イベントが発火した際に実行されるハンドラ。 これはBluetoothが無効になった際に発生します。
メソッド
BluetoothManager.getAdapters()
- 現在デバイスで使用されている
BluetoothAdapter
のリストを返します。
廃止メソッド
BluetoothManager.getDefaultAdapter()
- デバイスで使用されているデフォルトアダプタを取得します。これはオペレーションの成功または失敗を取得するための
DOMRequest
を返します。成功した場合、リクエストの結果はBluetoothAdapter
オブジェクトです。このメソッドはBluetoothManager.getAdapters()
に置き換えられました。
仕様
Specification | Status | Comment |
---|---|---|
Web Bluetooth BluetoothManager の定義 |
ドラフト | 草案。これは正式な仕様ではありません。W3C's System Applications Working Group で協議が必要です |
ブラウザの互換性
現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。 この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。 手助けしていただける場合は、こちらから!
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 | 未サポート | 未サポート | 未サポート | 未サポート |
参考