MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

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

ドキュメントのタグと貢献者

 このページの貢献者: chrisdavidmills, iwaita2ya
 最終更新者: iwaita2ya,