B2G/Bluetooth/WebBluetooth-v2/BluetoothManager

Overview

The BluetoothManager API allows to access all bluetooth adapters available on the device. Adapters are the connection interface to connect a bluetooth device to that device.

Interface

interface BluetoothManager: EventTarget
{
  attribute EventHandler onadapteradded;
  attribute EventHandler onadapterremoved;

  any              getAdapters(); // array of BluetoothAdapter
  BluetoothAdapter getDefaultAdapter();
};

Event Handlers

• BluetoothManager.onadapteradded
• BluetoothManager.onadapterremoved

onadapteradded

Description

A handler to trigger when a bluetooth adapter is plugged into the device. The event carries evt.adapter as the plugged BluetoothAdapter. Applications should call getDefaultAdapter() in this event handler to retrieve current default adapter if no adapter was plugged in, and may call getAdapters() for the latest array of adapters on the device.

Sample

function bt_onAdapterAdded(evt) {
  var adapter = evt.adapter;
  // do your thing here!
}

var manager = navigator.mozBluetooth;
manager.onadapteradded = bt_onAdapterAdded;

onadapterremoved

Description

A handler to trigger when a bluetooth adapter is unplugged from the device. The event carries evt.address as the address of unplugged BluetoothAdapter. The unplugged BluetoothAdapter object is already unavailable and access to its attributes returns default values. Applications should call getDefaultAdapter() in this event handler to retrieve the latest default adapter, and may call getAdapters() for the latest array of adapters on the device.

Sample

function bt_onAdapterRemoved(evt) {
  var address = evt.address;
  // do your thing here!
}

var manager = navigator.mozBluetooth;
manager.onadapterremoved = bt_onAdapterRemoved;

Methods

• BluetoothManager.getAdapters()
• BluetoothManager.getDefaultAdapter()

getAdapters()

Description

The getAdapters method retrieves all adapters on the device.

Return

An array of BluetoothAdapter objects.

Sample

var manager = navigator.mozBluetooth;
var adapters = manager.getAdapters();

getDefaultAdapter()

Description

The getDefaultAdapter method retrieves the default adapter used to connect the device to third-party bluetooth devices.

Return

The default BluetoothAdapter object.

Sample

var manager = navigator.mozBluetooth;
var adapter = manager.getDefaultAdapter();

See also

• BluetoothAdapter