B2G/Bluetooth/WebBluetooth-v2/BluetoothDevice

Overview

The BluetoothDevice API provides information regarding a given Bluetooth device.

Interface

enum BluetoothDeviceAttribute {
  "cod",
  "name",
  "paired",
  "uuids"
}

interface BluetoothDevice: EventTarget
{
  readonly attribute DOMString address;
  readonly attribute BluetoothClassOfDevice cod;
  readonly attribute DOMString name;
  readonly attribute boolean paired;
  readonly attribute any uuids; // array of type DOMString[]

  attribute EventHandler onattributechanged;

  DOMRequest fetchUuids();
};

Attributes

• BluetoothDevice.address
• BluetoothDevice.cod
• BluetoothDevice.name
• BluetoothDevice.paired
• BluetoothDevice.uuids

address

Description

The address attribute provides the address of the device on the Bluetooth micro-network. This attribute must be non-empty value. Both empty and null string are regarded invalid.

Value

Return a string. The default value is empty string "".

Sample

var address = instanceOfBluetoothDevice.address;

// TODO

• The attribute cannot be empty but the default value is empty string?

cod

Description

Value

Sample

name

Description

Value

Sample

paired

Description

Value

Sample

uuids

Description

Value

Sample

Event Handlers

• BluetoothDevice.onattributechanged

onattributechanged

Description

A handler for adapteradded event; it is triggered when a Bluetooth adapter is plugged into the device. The event carries evt.adapter as the plugged BluetoothAdapter object.

Sample

function bt_onAdapterAdded(evt) {
  var adapter = evt.adapter;

  // do your thing here!
}

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

Methods

• BluetoothDevice.fetchUuids()

fetchUuids()

Description

The fetchUuid method is used to retrieve all adapters of this device.

Return

An array of BluetoothAdapter objects.

Sample

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

See also

• BluetoothAdapter