BluetoothManager (Firefox OS)

非標準
この機能は現在 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 で協議が必要です

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	未サポート	未サポート	未サポート	未サポート

参考

Using the Web Bluetooth API